bookstack/dev/docker/db-testing

Database Testing Suite

This docker setup is designed to run BookStack's test suite against each major database version we support across MySQL and MariaDB to ensure compatibility and highlight any potential issues before a release. This is a fairly slow and heavy process, so is designed to just be run manually before a release which makes changes to the database schema, or a release which makes significant changes to database queries.

Running

Everything is ran via the run.sh script. This will:

• Optionally, accept a branch of BookStack to use for testing.
• Build the docker image from the Dockerfile.
  • This will include a built-in copy of the chosen BookStack branch.
• Cycle through each major supported database version:
  • Migrate and seed the database.
  • Run the full PHP test suite.

If there's a failure for a database version, the script will prompt if you'd like to continue or stop testing.

This script should be ran from this db-testing directory:

# Enter this directory
cd dev/docker/db-testing

# Runs for the 'development' branch by default
./run.sh

# Run for a specific branch
./run.sh v25-11