本教程展示如何在 Rancher 上部署 RadonDB MySQL 集群。
部署准备
- 已部署 Rancher 集群,并已获取 Rancher 管理控制台登录账号和密码。
部署步骤
步骤 1: 添加 Helm 仓库
登录 Rancher 管理控制台。
点击目标集群,进入集群管理页面。
选择 App&Marketplace > Repositories,进入应用仓库管理页面。
点击 Create,配置 RadonDB MySQL 仓库。
-Name:自定义仓库名称。
-Target:可选择 HTTP(s) 方式,配置 Index URL 为
https://radondb.github.io/radondb-mysql-kubernetes/
。点击 Create,返回仓库管理页面。
当仓库 State 切换为
Active
,则添加仓库正常运行。
步骤 2: 部署 Operator
一个 Rancher 集群仅需部署一次 RadonDB MySQL Operator。
在集群管理页面,选择 App&Marketplace > Charts,进入 Charts 列表页面。
找到 mysql-operator,部署 Operator 页面。
可选择 mysql-operator chart 版本。
点击 Install,配置应用基本信息。
可勾选自定义 Helm 选项。
(可选)点击 Next,自定义编辑应用 YAML 配置文件。
点击 Next,配置部署属性。
点击 Install,跳转到 Installed App 管理页面。
可在列表下方窗口,查看安装进度和状态。当应用部署完成后,可在列表查看到已安装的应用。
步骤 3: 部署 RadonDB MySQL 集群
通过命令方式
在集群管理页面,点击右上角 kubectl 命令图标。
在命令窗口,输入创建集群的命令。
如下示例为部署一个三节点的样例集群。
# 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
回车执行命令,回显提示
created
则部署成功。预期回显信息示例:
mysqlcluster.mysql.radondb.com/sample created
通过导入 YAML 文件方式
下载 RadonDB MySQL 集群配置样例,修改 YAML 文件中配置参数值。
详细配置参数说明,请参见配置参数。
在 Rancher 集群管理页面,点击右上角 YAML 导入图标。在弹出的窗口中,导入修改后的 YAML 文件。
部署验证
在集群管理页面,选择 Service Discovery > Services,进入服务列表页面。
找到部署的集群,查看服务状态。
状态为
Active
,表示服务正常运行。点击服务名称,进入服务详情页面,查看 Pod 状态。
状态为
Active
,表示 Pod 正常运行。在正在运行的 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。 更多访问不同集群中数据库方式说明,请参见访问集群中的应用程序。