Table of Contents
The Docker image comes with ClusterControl installed and configured with all of its components, so you can immediately use it to manage and monitor your existing databases.
Having a Docker image for ClusterControl at the moment is convenient in terms of how quickly it is to get it up and running and it’s 100% reproducible. Docker users can now start testing ClusterControl since we have the Docker image that everyone can pull down from Docker Hub and then launch the tool.
It is a start and our plan is to add better integration with the Docker API in future releases in order to transparently manage Docker containers/images within ClusterControl, e.g., to launch/manage and deploy database clusters using Docker images.
Build the Image
The Dockerfiles are available from our Github repository. You can build it manually by cloning the repository:
$ git clone https://github.com/severalnines/docker
$ cd docker/
$ docker build -t severalnines/clustercontrol .
Running the Container
Please refer to the Docker Hub page for the latest instructions. Use the docker pull
command to download the image:
$ docker pull severalnines/clustercontrol
Use the following command to run:
$ docker run -d --name clustercontrol \
-p 5000:80 \
severalnines/clustercontrol
Once started, ClusterControl is accessible at http://Docker_host:5000/clustercontrol
. You should see the welcome page to create a default admin user. Use your email address and specify passwords for that user. By default MySQL users root and cmon will be using password
and cmon
as the default password respectively. You can override this value with -e
flag, as in the example below:
$ docker run -d --name clustercontrol \
-e CMON_PASSWORD=MyCM0n22 \
-e MYSQL_ROOT_PASSWORD=SuP3rMan \
-p 5000:80 \
severalnines/clustercontrol
Optionally, you can map the HTTPS port using -p by appending the forwarding as below:
$ docker run -d --name clustercontrol \
-p 5000:80 \
-p 5443:443 \
severalnines/clustercontrol
Verify the container is running by using the ps command:
$ docker ps
For more examples on deployments with Docker images, please refer to ClusterControl on Docker and the Docker image Github page. For more info on the configuration options, please refer to ClusterControl’s Docker Hub page.