/mariadb-drupal-data

🗄️ MariaDB Docker image with enclosed data

Primary LanguageShellGNU General Public License v3.0GPL-3.0

Mariadb Drupal data logo

MariaDB data container for Drupal with database captured as Docker layers.

GitHub Issues GitHub Pull Requests CircleCI codecov GitHub release (latest by date) LICENSE Renovate

Docker Pulls amd64 arm64

How it works

Usually, MariaDB uses data directory specified as a Docker volume that is mounted onto host: this allows retaining data after container restarts.

The MariaDB image in this project uses custom location /home/db-data (not a Docker volume) to store expanded database files. These files then can be captured as a Docker layer and stored as an image to docker registry.

Image consumers download the image and start containers with instantaneously available data (no time-consuming database imports required).

Technically, the majority of the functionality is relying on upstream uselagoon/mariadb-drupal Docker image. Entrypoint script) had to be copied from upstream script and adjusted to support custom data directory.

Use case

Drupal website with a large database.

  1. CI process builds a website overnight.
  2. CI process captures the latest database as a new Docker layer in the database image.
  3. CI process tags and pushes image to the Docker registry.
  4. Website developers pull the latest image from the registry and build site locally. OR Subsequent CI builds pull the latest image from the registry and build site.

When required, website developers restart docker stack locally with an already imported database, which saves a significant amount of time for database imports.

Seeding image with your database

  1. Download the seed.sh script from this repository:
curl -LO https://github.com/drevops/mariadb-drupal-data/releases/latest/download/seed.sh
chmod +x seed.sh
  1. Run the script with the path to your database dump and the image name:
./seed.sh path/to/db.sql myorg/myimage:latest

# with forced platform
DOCKER_DEFAULT_PLATFORM=linux/amd64 ./seed.sh path/to/db.sql myorg/myimage:latest

# for multi-platform image
DESTINATION_PLATFORMS=linux/amd64,linux/arm64 ./seed.sh path/to/db.sql myorg/myimage:latest

# with a custom base image (e.g., canary)
BASE_IMAGE=drevops/mariadb-drupal-data:canary ./seed.sh path/to/db.sql myorg/myimage:latest

Note that you should already be logged in to the registry as seed.sh will be pushing an image as a part of docker buildx process.

Maintenance

Running tests

tests/bats/node_modules/.bin/bats tests/bats/image.bats --tap
tests/bats/node_modules/.bin/bats tests/bats/seed.bats --tap

Publishing

This image is built and pushed automatically to DockerHub:

  1. For all commits to main branch as canary tag.
  2. For releases as :<version> and latest tag.
  3. For feature/my-branch branches as feature-my-branch tag.

Versions are following versions of the upstream image to ease maintenance.

This repository was created using the Scaffold project template