https://github.com/drevops/mariadb-drupal-data
🗄️ MariaDB Docker image with enclosed data
https://github.com/drevops/mariadb-drupal-data
database docker drupal mariadb mysql persistent
Last synced: about 1 month ago
JSON representation
🗄️ MariaDB Docker image with enclosed data
- Host: GitHub
- URL: https://github.com/drevops/mariadb-drupal-data
- Owner: drevops
- License: gpl-3.0
- Created: 2020-02-04T11:50:05.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-11T11:09:57.000Z (about 2 months ago)
- Last Synced: 2025-05-06T23:16:26.480Z (about 1 month ago)
- Topics: database, docker, drupal, mariadb, mysql, persistent
- Language: Shell
- Homepage:
- Size: 83 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
MariaDB data container for Drupal with database captured as Docker layers.
[](https://github.com/drevops/mariadb-drupal-data/issues)
[](https://github.com/drevops/mariadb-drupal-data/pulls)
[](https://circleci.com/gh/drevops/mariadb-drupal-data)
[](https://codecov.io/gh/drevops/mariadb-drupal-data)


[](https://hub.docker.com/r/drevops/mariadb-drupal-data)

## 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`](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb-drupal/10.11.Dockerfile) Docker image.
[Entrypoint script](entrypoint.bash)) had to be copied from [upstream script](https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb/entrypoints/9999-mariadb-init.bash) 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:
```shell
curl -LO https://github.com/drevops/mariadb-drupal-data/releases/latest/download/seed.sh
chmod +x seed.sh
```
2. Run the script with the path to your database dump and the image name:```shell
./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 `:` and `latest` tag.
3. For `feature/my-branch` branches as `feature-my-branch` tag.Versions are following versions of the [upstream image](https://hub.docker.com/r/uselagoon/mariadb-drupal/tags) to ease maintenance.
---
_This repository was created using the [Scaffold](https://getscaffold.dev/) project template_