Skip to content

Commit 66301a1

Browse files
authored
Merge pull request killbill#601 from vnandwana/fix-formatting
Fix AsciiDoc list numbering issue in Flyway CLI instructions.
2 parents 6e40cdf + ebc4c2e commit 66301a1

2 files changed

Lines changed: 15 additions & 16 deletions

File tree

userguide/database-migration/includes/how-to-upgrade-plugin-database.adoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,11 @@ Execute the SQL scripts obtained above directly on your database.
3636
Migrations can also be executed using the Flyway command-line tool.
3737

3838
1. *Install Flyway Command-Line Tool:*
39-
39+
+
4040
Follow the installation guide here: https://documentation.red-gate.com/fd/quickstart-command-line-184127576.html[Flyway CLI Installation].
4141

4242
2. *Run the Baseline Command (First-Time Use Only):*
43-
43+
+
4444
If Flyway is being used the first time, run the `baseline` command to create the `flyway_schema_history` table.
4545
+
4646
*Command*
@@ -57,8 +57,8 @@ flyway -url=jdbc:mysql://127.0.0.1:3306/killbill -user=<db_user> -password=<db_p
5757
flyway -url=jdbc:mysql://127.0.0.1:3306/killbill -user=root -password=killbill -table=analytics_schema_history baseline
5858
----
5959

60-
+
61-
2. Run the `migrate` command to execute the migrations.
60+
61+
3. *Run the `migrate` command to execute the migrations.*
6262
+
6363
*Command*
6464
+
@@ -79,7 +79,7 @@ flyway -url=jdbc:mysql://127.0.0.1:3306/killbill -user=root -password=killbill -
7979

8080
In production environments, database access is often restricted and developers don’t necessarily have rights to execute DDL commands (i.e. CREATE, ALTER, DROP, etc. statements). In such cases, migrations can be executed as follows:
8181

82-
1. Create the `<plugin_name>_schema_history` table manually by running the following SQL statements:
82+
1. *Create the `<plugin_name>_schema_history` table manually:*
8383
+
8484
[source, sql]
8585
----
@@ -102,9 +102,9 @@ insert into <plugin_name>_schema_history (installed_rank, version, description,
102102
----
103103
+
104104
Ensure that you replace `<plugin_name>` with the name of a plugin like `analytics`.
105-
+
106-
2. *Run a Dry Run (if needed for review before applying migrations):*
107105

106+
2. *Run a Dry Run (if needed for review before applying migrations):*
107+
+
108108
Flyway CLI does not support dryRun directly, but you can use `-outputType=json` to review pending migrations:
109109
+
110110
*Command*
@@ -120,5 +120,5 @@ flyway -url=jdbc:mysql://127.0.0.1:3306/<db_name> -user=<db_user> -password=<db_
120120
----
121121
flyway -url=jdbc:mysql://127.0.0.1:3306/killbill -user=root -password=password -locations=filesystem:C:/var/migrations-table=analytics_schema_history info -outputType=json
122122
----
123-
123+
+
124124
This will list pending migrations without applying them.

userguide/database-migration/includes/how-to-upgrade-the-killbill-database.adoc

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,11 @@ Execute the SQL scripts obtained in Step 1 directly in the database.
3636
Migrations can also be executed using the Flyway command-line tool.
3737

3838
1. *Install Flyway Command-Line Tool:*
39-
39+
+
4040
Follow the installation guide here: https://documentation.red-gate.com/fd/quickstart-command-line-184127576.html[Flyway CLI Installation].
4141

4242
2. *Run the Baseline Command (First-Time Use Only):*
43-
43+
+
4444
If Flyway is being used the first time, run the `baseline` command to create the `flyway_schema_history` table.
4545
+
4646
*Command*
@@ -57,8 +57,7 @@ flyway -url=jdbc:mysql://127.0.0.1:3306/killbill -user=<db_user> -password=<db_p
5757
flyway -url=jdbc:mysql://127.0.0.1:3306/killbill -user=root -password=killbill baseline
5858
----
5959

60-
+
61-
2. Run the `migrate` command to execute the migrations.
60+
3. *Run the `migrate` command to execute the migrations.*
6261
+
6362
*Command*
6463
+
@@ -101,7 +100,7 @@ insert into flyway_schema_history (installed_rank, version, description, type, s
101100
----
102101
+
103102
2. *Run a Dry Run (if needed for review before applying migrations):*
104-
103+
+
105104
Flyway CLI does not support dryRun directly, but you can use `-outputType=json` to review pending migrations:
106105
+
107106
*Command*
@@ -117,9 +116,9 @@ flyway -url=jdbc:mysql://127.0.0.1:3306/<db_name> -user=<db_user> -password=<db_
117116
----
118117
flyway -url=jdbc:mysql://127.0.0.1:3306/killbill -user=root -password=password -locations=filesystem:C:/var/migrations info -outputType=json
119118
----
120-
119+
+
121120
This will generate a JSON output similar to the following, which includes details such as the migration version, description, and the file path containing the SQL queries that will be executed:
122-
121+
+
123122
[source, bash]
124123
----
125124
{
@@ -180,5 +179,5 @@ This will generate a JSON output similar to the following, which includes detail
180179
"htmlReport": "/home/killbill/Downloads/flyway-commandline-9.22.3-linux-x64/flyway-9.22.3/report.html"
181180
}
182181
----
183-
182+
+
184183
This helps in reviewing the changes before executing them.

0 commit comments

Comments
 (0)