Public | Automated Build

Last pushed: 10 months ago
Short Description
Postgres with liquibase migrations included
Full Description

PostgreSQL Docker image with liquibase

How to use this image

This image is intended to be used creating a derivative of it that gets built as part of your build process, incorporating the liquibase changelogs necessary for the database to run.

  1. Create a folder structure like this:

- Dockerfile
+ src
   + scripts
      - < any maintenance scripts you'd need to run from outside the container > 
   + changelogs
      + database1
        - < liquibase files for database 1, changelog, and changesets folder >  
      + database2
        - < liquibase files for database 2, changelog, and changesets folder >  

Example Dockerfile

FROM epiclabs/liquipostgres:latest


ADD src/ /

# Add command scripts
RUN chmod -R +x /scripts

How to build the image:

docker build -t epiclabs/liquipostgres  .

The container will create a database per folder in src/changelogs/, using the folder name as the name of the database.
Changesets found inside these folders will be applied by Liquibase to the appropriate database.

Run example:

docker run -d -p 5432:5432 --name postgres -v $PWD/liquibase/changelog/:/changelog epiclabs/liquipostgres

It is also possible to invoke liquibase once the container is running, indicating the desired database (or databases) after the command. Available commands:

  • update <databases>
  • generate <databases> - creates an XML with the schema from db
  • generate_data <databases> - creates an XML with the data from db


docker exec postgres /scripts/ update database1

Environment variables used and default values:

  • POSTGRES_DB = postgres
  • POSTGRES_USER = docker
  • MONOLITHIC_APPROACH = 1 : A value of 1 means all tables in all databases will be created in the public schema of the postgres database. Otherwise, a different database is created per folder in the changelogs folder.
Docker Pull Command
Source Repository