MaxScale/docker/README.md
Markus Mäkelä 0adb4b6ffa
Add basic docker-compose setup
The setup contains a three node master-slave cluster with both
readwritesplit and readconnroute.

Removed the duplication of the configuration files in the README and
provided links instead.
2018-04-17 09:34:12 +03:00

1.6 KiB

MariaDB MaxScale Docker image

This Docker image runs the latest GA version of MariaDB MaxScale.

Building

Run the following command in this directory to build the image.

docker build -t maxscale .

Usage

You must mount your configuration file into /etc/maxscale.cnf.d/. To do this, pass it as an argument to the -v option:

docker run -v $PWD/my-maxscale.cnf:/etc/maxscale.cnf.d/my-maxscale.cnf maxscale:latest

By default, MaxScale runs with the -l stdout arguments. To explicitly define a configuration file, use the -f /path/to/maxscale.cnf argument and add -l stdout after it.

docker run --network host --rm -v /my_dir:/container_dir maxscale -f /path/to/maxscale.cnf -l stdout

Default configuration

The default configuration for the MaxScale docker image can be found in this configuration file.

MaxScale docker-compose setup

The MaxScale docker-compose setup contains MaxScale configured with a three node master-slave cluster. To start it, run the following commands in this directory.

docker-compose build
docker-compose up -d

After MaxScale and the servers have started (takes a few minutes), you can find the readwritesplit router on port 4006 and the readconnroute on port 4008. The user maxuser with the password maxpwd can be used to test the cluster.

You can edit the maxscale.cnf.d/example.cnf file and recreate the MaxScale container to change the configuration.

To stop the containers, execute the following command. Optionally, use the -v flag to also remove the volumes.

docker-compose down