When this project is run, it executes the changelogs and creates a user_details table and populates it with some test data. It also creates an index and couple of constraints on user_details table.

The project also demonstrates the following.

Organising liquibase change logs using master changelog
It demonstrates how to write a change log in YAML format
It demonstrates how to write a change log in JSON format
It demonstrates how to write a change log in XML format
It demonstrates how to write a change log in SQL format
Enable INFO logs for liquibase.
It demonstrates testing of changes done by liquibase to the schema using Junit test
It demonstrates use of liquibase change log parameters
IT demonstrates use of liquibase context

How to Run the project and tests

Have Docker and Docker Compose in your machine?

Run application

Clone this repository

 git clone https://github.com/thombergs/code-examples/spring-boot/data-migration/liquibase

Move to the directory code-examples/spring-boot/data-migration/liquibase
Run the docker compose file infra-local.yaml in src/docker. This starts the postgres database needed to run the application.

   docker-compose -f ./src/main/docker/infra-local.yaml up -d

Now run the spring boot application as follows.

    mvnw spring-boot:run -Dspring-boot.run.profiles=docker

The application should start and listening on port 8080.

Open the url (http://localhost:8080/liquibase/users/100000000) in the browser. You should see a response as below

{
"id": 100000000,
"userName": "testUser",
"firstName": "testFirstName",
"lastName": "testLastName"
}

You can login to the database and check the creation of user_details table along with some test data in it.

    #Use below credentials to login to the database
    databaseHost: localhost
    jdbcUrl: jdbc:postgresql://localhost:5432/liquibasedemo?current_schema=public
    port: 5432
    username: demouser
    password: demopassword

Also, have a look at databasechangelog and databasechangeloglock tables.

Run Test

To run integration test, you don't need to run the docker compose file. Just run the test as follows:

mvn test -Dspring.profiles.active=docker

The test uses TestContainers to spin a postgres database, which is used during the integration test.

Don't have docker?

You can use h2 profile to run the app and use h2 database.

Clone this repository

 git clone https://github.com/thombergs/code-examples/spring-boot/data-migration/liquibase

Move to the directory code-examples/spring-boot/data-migration/liquibase
Now run the spring boot application as follows.

    mvnw spring-boot:run -Dspring-boot.run.profiles=h2

The application should start and listening on port 8080.

Open the url (http://localhost:8080/liquibase/users/100000000) in the browser. You should see a response as below

{
"id": 100000000,
"userName": "testUser",
"firstName": "testFirstName",
"lastName": "testLastName"
}

    JDBC URL: jdbc:h2:mem:liquibasedemo
    username: demouser
    password: demopassword

Check the creation of user_details table along with some test data in it.

Also, have a look at databasechangelog and databasechangeloglock tables.

Run Test

To run integration test

mvn test -Dspring.profiles.active=h2

README.md

liquibase-demo

Related Blog Posts

How to Run the project and tests

Have Docker and Docker Compose in your machine?

Run application

Run Test

Don't have docker?

Run Test