RadonDB MySQL Kubernetes 2.0 版本通用。
本文档演示 RadonDB MySQL Kubernetes 在 Kubernetes 上的部署、校验、访问和卸载操作。
部署准备
- Kubernetes 集群
- MySQL 客户端工具
部署步骤
步骤 1: 添加 Helm 仓库
添加 Helm 仓库 radondb。
$ helm repo add radondb https://radondb.github.io/radondb-mysql-kubernetes/
校验仓库信息，可查看到名为 radondb/mysql-operator 的 chart。
$ helm search repo
NAME CHART VERSION APP VERSION DESCRIPTION
radondb/mysql-operator 0.1.0 v2.1.x Open Source，High Availability Cluster，based on MySQL
步骤 2: 部署 Operator
设置 release 名为 demo , 创建名为 demo-mysql-operator 的 Deployment。
$ helm install demo radondb/mysql-operator
在这一步中，默认将同时创建集群所需的 CRD。
步骤 3: 部署 RadonDB MySQL 集群
执行以下指令，以默认参数为 CRD mysqlclusters.mysql.radondb.com 创建一个实例，即创建 RadonDB MySQL 集群。
$ kubectl apply -f https://github.com/radondb/radondb-mysql-kubernetes/releases/latest/download/mysql_v1alpha1_mysqlcluster.yaml
自定义集群部署参数，可参考 配置参数 。
部署校验
校验 RadonDB MySQL Operator
查看 demo 的 Deployment 和对应监控服务，回显如下信息则部署成功。
$ kubectl get deployment,svc
NAME READY UP-TO-DATE AVAILABLE AGE
demo-mysql-operator 1/1 1 1 7h50m
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/mysql-operator-metrics ClusterIP 10.96.142.22 <none> 8443/TCP 8h
校验 RadonDB MySQL 集群
执行如下命令，将查看到如下 CRD。
$ kubectl get crd | grep mysql.radondb.com
backups.mysql.radondb.com 2021-11-02T07:00:01Z
mysqlclusters.mysql.radondb.com 2021-11-02T07:00:01Z
mysqlusers.mysql.radondb.com 2021-11-02T07:00:01Z
以默认部署为例，执行如下命令将查看到名为 sample-mysql 的三节点 RadonDB MySQL 集群及用于访问节点的服务。
$ kubectl get statefulset,svc
NAME READY AGE
sample-mysql 3/3 7h33m
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/sample-follower ClusterIP 10.96.131.84 <none> 3306/TCP 7h37m
service/sample-leader ClusterIP 10.96.111.214 <none> 3306/TCP 7h37m
service/sample-mysql ClusterIP None <none> 3306/TCP 7h37m
访问集群
在 Kubernetes 集群内，支持使用 service_name 或者 clusterIP 方式，访问 RadonDB MySQL。
RadonDB MySQL 提供 Leader 和 Follower 两种服务，分别用于客户端访问主从节点。Leader 服务始终指向主节点（可读写），Follower 服务始终指向从节点（只读）。
以下为客户端与数据库在同一 Kubernetes 集群内，访问 RadonDB MySQL 的方式。
当客户端的与数据库部署在不同 Kubernetes 集群，请参考 Kubernetes 访问集群中的应用程序，配置端口转发、负载均衡等连接方式。
ClusterIP 方式
RadonDB MySQL 的高可用读写 IP 指向 Leader 服务的 clusterIP，高可用只读 IP 指向 Follower 服务的 clusterIP。
$ mysql -h <clusterIP> -P <mysql_Port> -u <user_name> -p
以下示例用户名为 radondb_usr， Leader 服务的 clusterIP 为 10.10.128.136 ，连接示例如下：
$ mysql -h 10.10.128.136 -P 3306 -u radondb_usr -p
service_name 方式
Kubernetes 集群的 Pod 之间支持通过 service_name 方式访问 RadonDB MySQL。
service_name方式不适用于从 Kubernetes 集群的物理机访问数据库 Pod。
连接 Leader 服务（RadonDB MySQL 主节点）
$ mysql -h <leader_service_name>.<namespace> -u <user_name> -p
用户名为 radondb_usr，release 名为 sample，RadonDB MySQL 命名空间为 default ，连接示例如下：
$ mysql -h sample-leader.default -u radondb_usr -p
- 连接 Follower 服务（RadonDB MySQL 从节点）
$ mysql -h <follower_service_name>.<namespace> -u <user_name> -p
用户名为 radondb_usr，release 名为 sample，RadonDB MySQL 命名空间为 default ，连接示例如下：
$ mysql -h sample-follower.default -u radondb_usr -p
卸载
卸载 Operator
卸载当前命名空间下 release 名为 demo 的 RadonDB MySQL Operator。
$ helm delete demo
卸载集群
卸载 release 名为 sample RadonDB MySQL 集群。
$ kubectl delete mysqlclusters.mysql.radondb.com sample
卸载自定义资源
$ kubectl delete customresourcedefinitions.apiextensions.k8s.io mysqlclusters.mysql.radondb.com
$ kubectl delete customresourcedefinitions.apiextensions.k8s.io mysqlusers.mysql.radondb.com
$ kubectl delete customresourcedefinitions.apiextensions.k8s.io backups.mysql.radondb.com
