Skip to content

graceframework/grace-database-migration

Repository files navigation

Main branch build status Apache 2.0 license Latest version on Maven Central Grace on X

Groovy Version Grace Version Spring Boot Version

Grace Database Migration Plugin

Overview

The Database Migration plugin helps you manage database changes while developing Grails applications. The plugin uses the Liquibase library. Using this plugin (and Liquibase in general) adds some structure and process to managing database changes. It will help avoid inconsistencies, communication issues, and other problems with ad-hoc approaches.

Database migrations are represented in text form, either using a Groovy DSL or native Liquibase XML, in one or more changelog files. This approach makes it natural to maintain the changelog files in source control and also works well with branches. Changelog files can include other changelog files, so often developers create hierarchical files organized with various schemes.

One popular approach is to have a root changelog named changlog.groovy (or changelog.xml) and to include a changelog per feature/branch that includes multiple smaller changelogs. Once the feature is finished and merged into the main development tree/trunk the changelog files can either stay as they are or be merged into one large file. Use whatever approach makes sense for your applications, but keep in mind that there are many options available for changelog management.

Versions

To make it easier for users to use and upgrade, Plugin adopts a version policy consistent with the Grace Framework.

Plugin Version Grace Version
6.2.x 2023.2.x
6.1.x 2023.1.x
6.0.x 2023.0.x
5.2.x 2022.2.x
5.1.x 2022.1.x
5.0.x 2022.0.x

Links