https://github.com/bstaijen/mariadb-galera

Docker Container for Auto Clustering and Replicating a MariaDB Server using Galera
https://github.com/bstaijen/mariadb-galera

consul docker mariadb-galera mariadb-server

Last synced: 7 days ago
JSON representation

Docker Container for Auto Clustering and Replicating a MariaDB Server using Galera

• Host: GitHub
• URL: https://github.com/bstaijen/mariadb-galera
• Owner: bstaijen
• License: mit
• Created: 2016-12-22T01:07:05.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-03-30T23:14:28.000Z (over 7 years ago)
• Last Synced: 2024-10-12T02:42:06.912Z (about 1 month ago)
• Topics: consul, docker, mariadb-galera, mariadb-server
• Language: Shell
• Homepage:
• Size: 1.76 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Work in progress..

# Docker Container for Auto Clustering and Replication a MariaDB Server

This is a demo for running a replicating and auto clustering MariaDB Server with Docker.

Docker hub : [bstaijen/mariadb-galera-cluster](https://hub.docker.com/r/bstaijen/mariadb-galera-cluster/). Since this project is only for demo purposes all releases will be tagged as pre-releases.

## How does it work?

This project consists out of one docker image. The docker image depends on consul or etcd for service discovery. The demo uses [gliderlabs/registrator](https://github.com/gliderlabs/registrator) for its service registration. If set-up in the right way the database will start replicating and clustring itself.

## Requirements

- [gliderlabs/docker-consul](https://github.com/gliderlabs/docker-consul) - For MariaDB Server Discovery

- [gliderlabs/registrator](https://github.com/gliderlabs/registrator) - For Automatic Server Registration

- [mariadb-disover-tool](https://github.com/bstaijen/mariadb-discover-tool) - For querying Consul Registry

## Environment Arguments

- `MYSQL_ROOT_PASSWORD` - Root user password. eg: `MYSQL_ROOT_PASSWORD=password`

- `CLUSTER_NAME` - Name of the cluster. eg: `CLUSTER_NAME=galeracluster`

- `CONSUL_HOST` - Link to consul instance. eg: `CONSUL_HOST=consul:8500`

- `SERVICE_NAME` - Name of the service. eg: `SERVICE_NAME=galera-db`

- `SERVICE_TAGS` - Tags for the service. eg: `SERVICE_TAGS=galera-db-tag`

- `DEBUG` - For debugging shell scipt. eg: `DEBUG=true`

## Usage

### With Docker Swarm and Docker Compose

Tested with: `Docker Client Version: 1.12.3` and `Docker Server Version: swarm/1.2.5` and `Docker Compose Version: 1.8.1`

- `docker-compose up -d --force-recreate`

- `docker-compose scale registrator=7` - Or any number of machines you have.

- I suggest waiting for 15-30 seconds so the first database server can configure itself.

- `docker-compose scale db=3`

- I suggest waiting a few seconds so the nodes can come online.

- `docker exec -it  bash` - Replace `` with the id of your database container

- `mysql -uroot -ppassword`

- `SHOW STATUS LIKE 'wsrep_cluster_size';` - The value of wsrep_cluster_size should be equal to the number of db instances

## Acknowledgements

- Thanks to [alvinr](https://github.com/alvinr) for letting me use his [repo](https://github.com/alvinr/docker-demo/tree/master/mariadb/vote/prod/galera) as a first inspiration.

- Thanks to [paulczar](https://github.com/paulczar) for using his [repo](https://github.com/paulczar/docker-percona_galera/tree/master/database) and getting the inspiration for using [confd](https://github.com/kelseyhightower/confd).

## Feedback & Issues

- Feel free to report bugs or suggestions through the Github issues page.

## Next steps

Check out the [docs directory](docs) for more docs.