Liquibase and Spring Boot
I think it’s great that Spring Boot has built-in support for Liquibase but I think there is missing documentation on it. Some of it is on Spring’s part and others are in Liquibase. I hope to demystify it a bit.
Spring Boot’s default master change log is
db/changelog/db.changelog-master.yaml . Note the file extension is
yaml not the standard
yml. No idea why they did it that way.
For database migrations, I don’t like storing everything in one changelog file. Instead I like putting them in different files in a folder. Liquibase has an
includeall directive but only documents it in XML. Not sure how I figured this out but here is how I did it with yaml:
databaseChangeLog: - includeAll: path: classpath*:db/changelog/changes/
So now I can store my changes in
classpath*:db/changelog/changes/ with any format that I want.
Lastly you can use Spring Intializr to put Liquibase in your project but, oddly, it doesn’t include the Liquibase plugin if you pick Maven or Gradle, which means that you don’t have Liquibase commands in your build file. So be aware that, regardless of your build tool, you will have to do more work to get things as workable as it should be.