Quarkus - Using Flyway

    Quarkus provides first class support for using Flyway as will be explained in this guide.

    To start using Flyway with your project, you just need to:

    • add your migrations to the folder as you usually do with Flyway

    • activate the migrate-at-start option to migrate the schema automatically or inject the Flyway object and runyour migration as you normally do

    In your pom.xml, add the following dependencies:

    • the Flyway extension

    • your JDBC driver extension (quarkus-jdbc-postgresql, quarkus-jdbc-h2, quarkus-jdbc-mariadb, …​)

    Flyway support relies on the Quarkus default datasource config, you must add the default datasource propertiesto the file in order to allow Flyway to manage the schema.Also, you can customize the Flyway behaviour by using the following properties:

    • quarkus.flyway.migrate-at-start

    • true to execute Flyway automatically when the application starts, false otherwise.default: false

    • Comma-separated list of locations to scan recursively for migrations. The location type is determined by its prefix.Unprefixed locations or locations starting with classpath: point to a package on the classpath and may contain both SQLand Java-based migrations.Locations starting with filesystem: point to a directory on the filesystem, may only contain SQL migrations and are onlyscanned recursively down non-hidden directories.default: classpath:db/migration

    • quarkus.flyway.connect-retries

    • The maximum number of retries when attempting to connect to the database. After each failed attempt, Flyway will wait 1second before attempting to connect again, up to the maximum number of times specified by connect-retries.default: 0

    • quarkus.flyway.schemas

    • Comma-separated case-sensitive list of schemas managed by Flyway.The first schema in the list will be automatically set as the default one during the migration.It will also be the one containing the schema history table.default:

    • quarkus.flyway.table

    • The name of Flyway’s schema history table.By default (single-schema mode) the schema history table is placed in the default schema for the connection provided bythe datasource.When the quarkus.flyway.schemas property is set (multi-schema mode), the schema history table is placed in the first schema ofthe list.default: flyway_schema_history

    • quarkus.flyway.sql-migration-prefix

    • The file name prefix for repeatable SQL migrations.Repeatable SQL migrations have the following file name structure: prefixSeparatorDESCRIPTIONsuffix , which using thedefaults translates to R__My_description.sqldefault: R

    • quarkus.flyway.baseline-on-migrate

    • Whether to automatically call baseline when migrate is executed against a non-empty schema with no metadata table.This schema will then be baselined with the baseline-version before executing the migrations.Only migrations above baseline-version will then be applied.This is useful for initial Flyway production deployments on projects with an existing DB.

    Be careful when enabling this as it removes the safety net that ensures Flyway does notmigrate the wrong database in case of a configuration mistake!default: false

    • quarkus.flyway.baseline-version

    • The version to tag an existing schema with when executing baselinedefault: 1

    • quarkus.flyway.baseline-description

    • The description to tag an existing schema with when executing baselinedefault: '<< Flyway Baseline >>'

    The following is an example for the application.properties file:

    Add a SQL migration to the default folder following the Flyway naming conventions: src/main/resources/db/migration/V1.0.0__Quarkus.sql

    Now you can start your application and Quarkus will run the Flyway’s migrate method according to your config:

    Using the Flyway object

    In case you are interested in using the Flyway object directly, you can inject it as follows: