本教程展示如何在 Rancher 上部署 RadonDB MySQL 集群。

部署准备

• 已部署 Rancher 集群，并已获取 Rancher 管理控制台登录账号和密码。

部署步骤

步骤 1: 添加 Helm 仓库

1. 登录 Rancher 管理控制台。

2. 点击目标集群，进入集群管理页面。

3. 选择 App&Marketplace > Repositories，进入应用仓库管理页面。

4. 点击 Create，配置 RadonDB MySQL 仓库。

   -Name：自定义仓库名称。

   -Target：可选择 HTTP(s) 方式，配置 Index URL 为 https://radondb.github.io/radondb-mysql-kubernetes/。

5. 点击 Create，返回仓库管理页面。

   当仓库 State 切换为 Active，则添加仓库正常运行。

步骤 2: 部署 Operator

一个 Rancher 集群仅需部署一次 RadonDB MySQL Operator。

1. 在集群管理页面，选择 App&Marketplace > Charts，进入 Charts 列表页面。

2. 找到 mysql-operator，部署 Operator 页面。

   可选择 mysql-operator chart 版本。

   

3. 点击 Install，配置应用基本信息。

   可勾选自定义 Helm 选项。

   

4. （可选）点击 Next，自定义编辑应用 YAML 配置文件。

   

5. 点击 Next，配置部署属性。

   

6. 点击 Install，跳转到 Installed App 管理页面。

   可在列表下方窗口，查看安装进度和状态。当应用部署完成后，可在列表查看到已安装的应用。

步骤 3: 部署 RadonDB MySQL 集群

通过命令方式

1. 在集群管理页面，点击右上角 kubectl 命令图标。

   

2. 在命令窗口，输入创建集群的命令。

   如下示例为部署一个三节点的样例集群。

   # Run kubectl commands inside here
   # e.g. kubectl get all
   $ cat <<EOF | kubectl apply -f-
   apiVersion: mysql.radondb.com/v1alpha1
   kind: MysqlCluster
   metadata:
      name: sample
   spec:
      replicas: 3
   EOF
   

3. 回车执行命令，回显提示 created 则部署成功。

   预期回显信息示例：

   mysqlcluster.mysql.radondb.com/sample created
   

通过导入 YAML 文件方式

1. 下载 RadonDB MySQL 集群配置样例，修改 YAML 文件中配置参数值。

   详细配置参数说明，请参见配置参数。

2. 在 Rancher 集群管理页面，点击右上角 YAML 导入图标。在弹出的窗口中，导入修改后的 YAML 文件。

   

部署验证

1. 在集群管理页面，选择 Service Discovery > Services，进入服务列表页面。

2. 找到部署的集群，查看服务状态。

   状态为 Active，表示服务正常运行。

3. 点击服务名称，进入服务详情页面，查看 Pod 状态。

   状态为 Active，表示 Pod 正常运行。

4. 在正在运行的 Pod 行，点击 Execute Shell，展开 Pod 命令窗口。

   执行如下命令并输入密码，验证数据库连接状态。

   $ mysql -u root -p
   

   正常连接数据库回显信息如下图：

   

访问 RadonDB MySQL

准备可用于连接 MySQL 的客户端。

RadonDB MySQL 提供 leader 服务和 follower 服务用于分别访问主从节点。leader 服务始终指向主节点（读写），follower 服务始终指向从节点（只读）。

当客户端与数据库部署在同一 Rancher 集群内，可选择使用 service_name 或者 clusterIP 方式访问 RadonDB MySQL。

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 方式

Rancher 集群的 Pod 之间支持通过 service_name 方式访问 RadonDB MySQL。

说明

service_name 方式不适用于从 Rancher 集群的物理机访问数据库 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  
  

当客户端与数据库部署在不同 Rancher 集群，请在 Rancher 中设置 Load Balancer 和 Ingress Controller。 更多访问不同集群中数据库方式说明，请参见访问集群中的应用程序。