# 容器化 | 在 Kubernetes 上部署 RadonDB MySQL 叢集

RadonDB MySQL 是一款基於 MySQL 的開源、高可用、雲原生叢集解決方案。支援一主多從高可用架構，並具備安全、自動備份、監控告警、自動擴容等全套管理功能。目前已經在生產環境中大規模的使用，包含**銀行、保險、傳統大企業**等。

RadonDB MySQL Kubernetes 支援在 Kubernetes 上安裝部署和管理，自動執行與執行 RadonDB MySQL 叢集有關的任務。

本教程主要演示如何使用 Git 和 Repo 命令列兩種方式在 Kubernetes 上部署 RadonDB MySQL 叢集。

## 部署準備

已準備可用 Kubernetes 叢集。

## 方式一：透過 Git 部署

執行如下命令，將 RadonDB MySQL Chart 克隆到 Kubernetes 中。

```shell
$ git clone https://github.com/radondb/radondb-mysql-kubernetes.git
```

在 radondb-mysql-kubernetes 目錄路徑下，選擇如下方式，部署 release 例項。

> release 是執行在 Kubernetes 叢集中的 Chart 的例項。透過命令方式部署，需指定 release 名稱。

以下命令指定 release 名為 `demo`，將建立一個名為 `demo-radondb-mysql` 的有狀態副本集。

- **預設部署方式**

```shell
<for helm="" v3="">
 cd charts/helm
 helm install demo .
```

- **指定引數部署方式**

在 `helm install` 時使用 `--set key=value[,key=value]`，可指定引數部署。

以建立一個標準使用者，且建立指定可訪問資料庫為例。使用者名稱為 `my-user`、密碼為 `my-password`、授權資料庫為 `my-database`。

```shell
cd charts/helm
helm install demo \
 --set mysql.mysqlUser=my-user,mysql.mysqlPassword=my-password,mysql.database=my-database .
```

- **配置 yaml 引數方式**

執行如下命令，可透過 value.yaml 配置檔案，在安裝時指定引數配置。

```shell
cd charts/helm
helm install demo -f values.yaml .
```

## 方式二：透過 repo 部署

新增並更新 helm 倉庫。

```shell
$ helm repo add test https://charts.kubesphere.io/test
$ helm repo update
```

以下命令指定 release 名為 `demo`，將建立一個名為 `demo-radondb-mysql` 的有狀態副本集。

```shell
$ helm install demo test/radondb-mysql
NAME: demo
LAST DEPLOYED: Wed Apr 28 08:08:15 2021
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
The cluster is comprised of 3 pods: 1 leader and 2 followers. Each instance is accessible within the cluster through:
    <pod-name>.demo-radondb-mysql
To connect to your database:
1. Get mysql user `qingcloud`s password:
    kubectl get secret -n default demo-radondb-mysql -o jsonpath="{.data.mysql-password}" | base64 --decode; echo
2. Run an Ubuntu pod that you can use as a client:
    kubectl run ubuntu -n default --image=ubuntu:focal -it --rm --restart='Never' -- bash -il
3. Install the mysql client:
    apt-get update && apt-get install mysql-client -y
4. To connect to leader service in the Ubuntu pod:
    mysql -h demo-radondb-mysql-leader -u qingcloud -p
5. To connect to follower service (read-only) in the Ubuntu pod:
    mysql -h demo-radondb-mysql-follower -u qingcloud -p    
```

## 部署校驗

叢集建立成功後（博主都是部署在[cnaaa伺服器](https://www.cnaaa.com/)上的），預設將建立一個有狀態副本集（StatefulSet ），以及三個用於訪問節點的服務。

以預設部署為例，可獲取如下資源資訊，則叢集部署成功。

```shell
$ kubectl get statefulset,svc
NAME                                  READY   AGE
statefulset.apps/demo-radondb-mysql   3/3     45m
NAME                                  TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/demo-radondb-mysql            ClusterIP   None            <none>        3306/TCP   45m
service/demo-radondb-mysql-follower   ClusterIP   10.96.84.254    <none>        3306/TCP   45m
service/demo-radondb-mysql-leader     ClusterIP   10.96.178.195   <none>        3306/TCP   45m
```

## 連線 RadonDB MySQL

您需要準備一個用於連線 MySQL 的客戶端。

### 與客戶端在同一 NameSpace 中

當客戶端與 RadonDB MySQL 叢集在同一個 NameSpace 中時，可使用 leader/follower service 名稱代替具體的 IP 和埠。

- 連線主節點 (讀寫節點)。

```shell
$ mysql -h <leader service=""> -u  -p
使用者名稱為 `radondb_mysql`，release 名為 `demo` ，連線示例如下：
$ mysql -h demo-radondb-mysql-leader -u radondb_mysql -p
```

- 連線從節點 (只讀節點)。

```shell
$ mysql -h <follower service=""> -u  -p
```

使用者名稱為 `radondb_mysql`，release 名為 `demo` ，連線示例如下：

```plain
$ mysql -h demo-radondb-mysql-follower -u qradondb_mysql-p  
```

### 與客戶端不在同一 NameSpace 中

當客戶端與 RadonDB MySQL 叢集不在同一個 NameSpace 中時，可以透過 podIP 或服務 ClusterIP 來連線對應節點。

- 查詢 pod 列表和服務列表，分別獲取需要連線的節點所在的 pod 名稱或對應的服務名稱。

```shell
$ kubectl get pod,svc
```

- 檢視 pod / 服務的詳細資訊，獲取對應的 IP。

```shell
$ kubectl describe pod <pod>
$ kubectl describe svc 
```

> 注意：pod 重啟後 pod IP 會更新，每次重啟後需重新獲取 pod IP。

- 連線節點。

```shell
$ mysql -h <pod ip="" clusterip=""> -u  -p
```

使用者名稱為 `radondb_mysql`，pod IP 為 `10.10.128.136` ，連線示例如下：

```shell
$ mysql -h 10.10.128.136 -u radondb_mysql -p
```

## 持久化

MySQL 映象在容器路徑 `/var/lib/mysql` 中儲存 MySQL 資料和配置。

預設情況下，會建立一個 PVC 並將其掛載到指定目錄中。 若想禁用此功能，您可以更改 `values.yaml` 禁用持久化，改用 emptyDir。

當 Pod 分配給節點後，將首先建立一個 emptyDir 卷，只要 Pod 在節點上持續執行，則儲存卷便持續存在；當 Pod 節點中刪除時 ，emptyDir 中的資料也將被永久刪除。

> **注意**
>
> - PVC 中可以使用不同特性的持久卷（PersistentVolume，PV），其 I/O 效能會影響資料庫的初始化效能。所以當使用 PVC 啟用持久化儲存時，可能需要調整 `livenessProbe.initialDelaySeconds` 的值。
> - 資料庫初始化的預設限制是 60 秒 (`livenessProbe.initialDelaySeconds` + `livenessProbe.periodSeconds` * `livenessProbe.failureThreshold`)。如果初始化時間超過限制，kubelet 將重啟資料庫容器，資料庫初始化被中斷，會導致持久資料不可用。

## 自定義 MySQL 配置

在 `mysql.configFiles` 中新增 / 更改 MySQL 配置。

```yaml
configFiles:
   node.cnf: |
    [mysqld]
    default_storage_engine=InnoDB
    max_connections=65535
    
    # custom mysql configuration.
    expire_logs_days=7
```</pod></pod></follower></leader></none></none></none></pod-name></for>

容器化 | 在 Kubernetes 上部署 RadonDB MySQL 叢集

相關文章