liquibase-db-release-maven-plugin

This is a Maven plugin that is designed to help with tagging a Liquibase file.

What this plugin does

The plugin will:

• Move all include files to a named variant;
• Create empty latest include files;
• Include a tagDatabase changeSet in the master files

The tagDatabase changeSet looks like:

<!-- Version 1.2.3 -->
<include file="myApp/1.2.3.xml" relativeToChangelogFile="true"></include>
<changeSet id="Tag 1.2.3" author="liquibase-db-release">
	<tagDatabase tag="1.2.3"></tagDatabase>
</changeSet>

The plugin in more detail

The plugin assumes that the Liquibase has one or more master files. When you create a database, these are the files you run with Liquibase. The master files are the files where this plugin will insert a tag into.

The plugin also assumes that the master files will include other files. These files are the files that will be versioned.

For example, take the following structure:

• master.xml
• myApp\latest.xml

Master.xml looks like this:

<databaseChangeLog>
	<changeSet id="Tag our database with 1.0.0" author="John Doe">
		<tagDatabase tag="1.0.0"></tagDatabase>
	</changeSet>
	<include file="myApp\latest.xml" relativeToChangelogFile="true"></include>
</databaseChangeLog>

MyApp\latest.xml looks like this:

<databaseChangeLog>
	<changeSet id="Make a change to our database" author="John Doe">
		...
	</changeSet>
</databaseChangeLog>

After running mvn liquibase-db-release:tag for version "1.2.3", we have the following structure:

• master.xml
• myApp\1.2.3.xml
• myApp\latest.xml

Master.xml looks like this:

<databaseChangeLog>
	<changeSet id="Tag our database with 1.0.0" author="John Doe">
		<tagDatabase tag="1.0.0"></tagDatabase>
	</changeSet>

	<!-- Version 1.2.3 -->
	<include file="myApp/1.2.3.xml" relativeToChangelogFile="true"></include>
	<changeSet id="Tag 1.2.3" author="liquibase-db-release">
		<tagDatabase tag="1.2.3"></tagDatabase>
	</changeSet>

	<include file="myApp\latest.xml" relativeToChangelogFile="true"></include>
</databaseChangeLog>

MyApp\1.2.3.xml looks like this:

<databaseChangeLog>
	<changeSet id="Make a change to our database" author="John Doe">
		...
	</changeSet>
</databaseChangeLog>

MyApp\latest.xml looks like this:

<databaseChangeLog>
</databaseChangeLog>

How to use this plugin

Pom.xml

Configure this plugin in your pom.xml as follows:

<plugin>
	<groupId>org.jurr.liquibase</groupId>
	<artifactId>liquibase-db-release-maven-plugin</artifactId>
	<version>${liquibase-db-release.version}</version>
	<configuration>
		<masterFiles>
			<masterFile>liquibase/master.xml</masterFile>
			<masterFile>liquibase/master_alternative.xml</masterFile>
		</masterFiles>
		<skippedIncludeFiles>
			<skippedIncludeFile>liquibase/demo_content.xml</skippedIncludeFile>
			<skippedIncludeFile>liquibase/test_content.xml</skippedIncludeFile>
		</skippedIncludeFiles>
	</configuration>
</plugin>

Just run mvn liquibase-db-release:tag. The plugin will ask you for a new version. If you want to run this in batch mode, use mvn liquibase-db-release:tag -B -DnewVersion=1.2.3.