💾 MariaDB Galera Container

-----NOT PRODUCTION READY-----

A Docker container for running MariaDB Galera Cluster on Ubuntu 24.04 base image, providing a highly available and scalable database solution.

✨ Features

• Based on Ubuntu 24.04 (Noble)
• MariaDB 11.4 LTS with Galera Cluster
• Automated health monitoring
• Optimized for container environments
• Configurable through environment variables
• Built-in backup support with mariadb-backup

🚀 Quick Start

# Pull the image
docker pull peterweissdk/mariadb-galera:latest

# Start the first node
docker run -d \
  --name galera-node1 \
  -e MYSQL_ROOT_PASSWORD=your_password \
  -e GALERA_CLUSTER_NAME=my_cluster \
  -e GALERA_NODE_ADDRESS=node1_ip \
  peterweissdk/mariadb-galera:latest

# Join additional nodes
docker run -d \
  --name galera-node2 \
  -e MYSQL_ROOT_PASSWORD=your_password \
  -e GALERA_CLUSTER_NAME=my_cluster \
  -e GALERA_NODE_ADDRESS=node2_ip \
  -e GALERA_CLUSTER_ADDRESS=gcomm://node1_ip \
  peterweissdk/mariadb-galera:latest

🔧 Configuration

Environment Variables

• MYSQL_ROOT_PASSWORD: Root password for MariaDB
• GALERA_CLUSTER_NAME: Name of the Galera cluster
• GALERA_NODE_ADDRESS: IP address of this node
• GALERA_CLUSTER_ADDRESS: Cluster connection address (gcomm://)
• MYSQL_DATABASE: Create this database on startup
• MYSQL_USER: Create this user on startup
• MYSQL_PASSWORD: Password for MYSQL_USER

Ports

• 3306: MariaDB
• 4444: SST (State Snapshot Transfer)
• 4567: Galera Cluster
• 4568: IST (Incremental State Transfer)

🏗️ Building from Source

# Clone the repository
git clone https://github.com/peterweissdk/mariadb-galera.git

# Build the image
cd mariadb-galera
docker build -t mariadb-galera .

📝 Directory Structure

.
├── conf
│   ├── galera
│   │   └── galera.cnf
│   └── sources.list
│       └── mariadb.sources
├── docker-entrypoint.sh
├── Dockerfile
├── healthcheck.sh
├── LICENSE
└── README.md

🔍 Health Check

The container includes a comprehensive health monitoring system that checks:

• MariaDB service availability
• Galera provider status (wsrep_ready)
• Cluster size and connectivity
• Node synchronization state

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🆘 Support

If you encounter any issues or need support, please file an issue on the GitHub repository.

📄 License

This project is licensed under the GNU GENERAL PUBLIC LICENSE v3.0 - see the LICENSE file for details.