Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bitpoke/mysql-operator
Asynchronous MySQL Replication on Kubernetes using Percona Server and Openark's Orchestrator.
https://github.com/bitpoke/mysql-operator
kubernetes kubernetes-controller kubernetes-operator mysql mysql-async mysql-cluster operator percona-server
Last synced: 3 days ago
JSON representation
Asynchronous MySQL Replication on Kubernetes using Percona Server and Openark's Orchestrator.
- Host: GitHub
- URL: https://github.com/bitpoke/mysql-operator
- Owner: bitpoke
- License: apache-2.0
- Created: 2017-11-06T15:24:51.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-29T07:58:19.000Z (11 months ago)
- Last Synced: 2024-05-01T11:01:56.076Z (8 months ago)
- Topics: kubernetes, kubernetes-controller, kubernetes-operator, mysql, mysql-async, mysql-cluster, operator, percona-server
- Language: Go
- Homepage: https://www.bitpoke.io/docs/mysql-operator/getting-started/
- Size: 39.9 MB
- Stars: 980
- Watchers: 20
- Forks: 275
- Open Issues: 190
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-dok - Bitpoke MySQL Operator - known as PressLabs Operator, one of the first operators for MySQL, not actively developed. (Databases / MySQL)
- awesome-dok - Bitpoke MySQL Operator - known as PressLabs Operator, one of the first operators for MySQL, not actively developed. (Databases / MySQL)
README
# MySQL Operator
MySQL Operator enables bulletproof MySQL on Kubernetes. It manages all the necessary resources for deploying and managing a highly available MySQL cluster. It provides effortless backups, while keeping the cluster highly available.
:beer: :pizza: :coffee:
If the operator has helped you out with your projects, **please consider [sponsoring](https://github.com/sponsors/bitpoke)** it to speed up the development. [Issues](https://github.com/bitpoke/mysql-operator/issues) are answered in this repo on a best-effort basis.:wrench: :nut_and_bolt: :hammer:
For **paid commercial support**, deployment, integration and prioritizing of features, please check the dedicated service provided by [Bitpoke](https://www.bitpoke.io/services/mysql-support/).The operator has been developed by [Bitpoke](https://www.bitpoke.io/) for internal use to [run WordPress in a cloud-native app](https://www.bitpoke.io/wordpress/) and has been open-sourced for the general public to benefit.
## Goals and status
The main goals of this operator are:
1. Easily deploy MySQL clusters in Kubernetes (cluster-per-service model)
2. Friendly to devops (monitoring, availability, scalability and backup stories solved)
3. Out-of-the-box backups (scheduled and on demand) and point-in-time recovery
4. Support for cloning in cluster and across clusters.## Contributing
We welcome all contributions in the form of new issues for feature requests, bugs or even pull requests. We are open to discuss ideas on how to improve the operator and would also love to find out where and how it's used. The discussion related to this project should happen on the Kubernetes Community [Slack](https://kubernetes.slack.com/messages/CEKQXFR0E/). The current maintainers of this project can be reached via [email](mailto:[email protected]), too.
## Documentation
* [Getting started](https://www.bitpoke.io/docs/mysql-operator/getting-started/) provides an overview over deploying and using the MySQL operator
* [Deploy a MySQL cluster](https://www.bitpoke.io/docs/mysql-operator/deploy-mysql-cluster/) describes in detail how a cluster can be installed and configured
* [Configure backups](https://www.bitpoke.io/docs/mysql-operator/backups/) shows how to configure and take backups of a cluster
* [Recurrent backups](https://www.bitpoke.io/docs/mysql-operator/cluster-recurrent-backups/) describes how to setup recurrent backups for the cluster
* [Restore a cluster](https://www.bitpoke.io/docs/mysql-operator/backups/#initialize-a-cluster-from-a-backup) explains how to restore a cluster from a backup
* [How to integrate](https://www.bitpoke.io/docs/mysql-operator/integrate-operator/) the operator with your deployment setup. This presents a simple way of using the MySQL operator and helm to deploy your application
* [Orchestrator](https://www.bitpoke.io/docs/mysql-operator/orchestrator/) shows you how to access the orchestrator for more details.## Controller deploy
To deploy this controller, use the provided helm chart by running:
```shell
helm repo add bitpoke https://helm-charts.bitpoke.io
helm install mysql-operator bitpoke/mysql-operator
```For more information about chart values see chart [README](deploy/charts/mysql-operator/README.md). This chart will deploy the controller together with an [orchestrator](https://github.com/github/orchestrator) cluster.
__NOTE__: MySQL operator 0.6.x requires at least Kubernetes 1.19.x to upgrade, check the [0.6.x upgrade notes](https://www.bitpoke.io/docs/mysql-operator/operator-upgrades/#v06x-upgrade) as some additional steps may be required.
__NOTE__: MySQL operator 0.2.x requires at least Kubernetes 1.11.x (or 1.10.x with alpha features) while version 0.1.x is known to work with Kubernetes up 1.9.x. To upgrade, check the [0.2.x upgrade notes](https://www.bitpoke.io/docs/mysql-operator/operator-upgrades/#v02x-upgrade) as some additional steps are required.
## Controller upgrade
It is possible that upgrading the MySQL operator to a newer version requires additional steps. Those steps can be found in the operator's documentation at [upgrades](docs/operator-upgrades.md) section.
## Deploying a cluster
```shell
kubectl apply -f https://raw.githubusercontent.com/bitpoke/mysql-operator/master/examples/example-cluster-secret.yaml
kubectl apply -f https://raw.githubusercontent.com/bitpoke/mysql-operator/master/examples/example-cluster.yaml
```## Roadmap to v1.0
- [ ] Integration with Google Cloud Marketplace, OperatorHub.io, AWS Marketplace
- [ ] CRD Validation and webhooks
- [ ] SSL support
- [ ] Default integrated with MySQL 8.0
- [ ] Proxy SQL integration
- [ ] Backup policies
- [x] Physical backups
- [x] HA [Orchestrator](https://github.com/github/orchestrator) integration
- [x] [Prometheus](https://github.com/prometheus/prometheus) metrics exporter
- [x] Lag mitigation
- [x] Query limits## Tech considerations
This project uses Percona Server for MySQL 5.7 / 8.0 because of backup improvements (eg. backup locks), monitoring improvements and some serviceability improvements (eg. utility user). Although we could have used MariaDB, our primary focus being WordPress, we wanted a drop-in rather than a fork. In the future we might support MariaDB if that can be implemented in a compatible way.
## License
This project is licensed under Apache 2.0 license. Read the [LICENSE](LICENSE) file in the top distribution directory for the full license text.