Skip to main content
Version: Early Access

Liquibase plugin

The Liquibase integration with Digital.ai Deploy helps simplify database schema management and automation. This plugin enables you to apply database updates, track schema changes, and perform rollbacks when needed.

Prerequisites​

Installation​

Install the plugin using the Plugin Manager.

Plugin Installation

Configuration​

You must configure the Liquibase runner and set up the environment in Deploy.

Configure Liquibase Runner​

  1. Navigate to Infrastructure > New > Overthere > LocalHost Create LocalHost

  2. After creating localhost, select New > liquibase > Runner Create Runner

  3. Configure Database Parameters: Database Configuration

    • Database Username: Database user
    • Database Password: User password
    • Database JDBC URL: Connection string (e.g., jdbc:mysql://localhost:3306/dbname)
    • Database Driver: JDBC driver class (e.g., com.mysql.cj.jdbc.Driver)
    • Database Driver Classpath: Path to JDBC driver JAR
    • Is NoSQL: Enable for NoSQL databases

  4. Configure Liquibase Parameters:

    • Liquibase Home: Installation directory (e.g., C:\Liquibase)
    • Configuration File: (Optional) Properties file path
    • Additional Command-Line Arguments: Extra parameters (e.g., --logLevel=debug)

  5. Test connection using Check connection

Create Environment​

Create an environment for deploying database changes.

Deployment Process​

Create the application package and deploy the package to roll out the changes.

Create Application Package​

  1. Create Application:

    • Navigate to Applications > New > Application
    • Provide application details

  2. Create Deployment Package:

    • Within application, select New > Deployment Package
    • Add changelog under package: New > liquibase > changelog Changelog Creation

  3. Configure Changelog:

    • Changelog File: Path to changesets file
    • Rollback Version: Target version for rollbacks (e.g., v1)
    • Rollback Version Prefix: Version tag prefix

Deploy Changes​

  1. Select deployment package > Deploy
  2. Follow deployment wizard to apply changes

The plugin will apply database updates and create rollback tags automatically. For rollback information, see Rollback a deployment.