0adb4b6ffa
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.
59 lines
1.6 KiB
Markdown
59 lines
1.6 KiB
Markdown
# 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.cnf).
|
|
|
|
## MaxScale docker-compose setup
|
|
|
|
[The MaxScale docker-compose setup](./docker-compose.yml) 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`](./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
|
|
```
|