基于K8S的StatefulSet部署MySQL集群

作者：運維小弟 2021-11-04 07:49:58

運維系統運維

展示如何使用 StatefulSet 控制器運行一個有狀態的應用程序。此例是多副本的 MySQL 數據庫。示例應用的拓撲結構有一個主服務器和多個副本，使用異步的基于行(Row-Based) 的數據復制。

[[433184]]

環境：

# 采用NFS存儲卷的方式持久化存儲mysql數據目錄

需求：

搭建一個“主從復制”(Maser-Slave Replication)的 MySQL 集群
存在一個主節點【master】，有多個從節點【slave】
從節點可以水平拓展
所有的寫操作，只能在主節點上執行
讀操作可以在所有節點上執行

一、部署NFS服務器

#服務器安裝nfs服務，提供nfs存儲功能 
1、安裝nfs-utils 
yum install nfs-utils (centos) 
或者  apt-get install nfs-kernel-server (ubuntu) 
 
2、啟動服務 
systemctl enable nfs-server 
systemctl start nfs-server 
 
3、創建共享目錄完成共享配置 
mkdir /home/nfs   #創建共享目錄 
 
4、編輯共享配置 
vim /etc/exports                                            
#語法格式：    共享文件路徑     客戶機地址（權限）     #這里的客戶機地址可以是IP,網段，域名,也可以是任意* 
/home/nfs  *(rw,async,no_root_squash)

#服務器安裝nfs服務，提供nfs存儲功能 
1、安裝nfs-utils 
yum install nfs-utils (centos) 
或者  apt-get install nfs-kernel-server (ubuntu) 
 
2、啟動服務 
systemctl enable nfs-server 
systemctl start nfs-server 
 
3、創建共享目錄完成共享配置 
mkdir /home/nfs   #創建共享目錄 
 
4、編輯共享配置 
vim /etc/exports                                            
#語法格式：    共享文件路徑     客戶機地址（權限）     #這里的客戶機地址可以是IP,網段，域名,也可以是任意* 
/home/nfs  *(rw,async,no_root_squash)

服務自檢命令  
exportfs -arv 
 
 
5、重啟服務 
systemctl restart nfs-server 
 
 
6、本機查看nfs 共享目錄 
#showmount -e 服務器IP地址 (如果提示命令不存在，則需要yum install showmount) 
 
showmount -e 127.0.0.1 
/home/nfs * 
 
 
 
7、客戶端模擬掛載[所有k8s的節點都需要安裝客戶端] 
[root@master-1 ~]# yum install nfs-utils （centos） 
或者  apt-get install nfs-common （ubuntu） 
[root@master-1 ~]# mkdir /test 
[root@master-1 ~]# mount -t nfs 172.16.201.209:/home/nfs /test 
 
#取消掛載 
[root@master-1 ~]# umount /test

二、配置PV 動態供給(NFS StorageClass)，創建pvc

部署NFS實現自動創建PV插件：一共設計到4個yaml 文件，官方的文檔有詳細的說明

https://github.com/kubernetes-incubator/external-storage

root@k8s-master1:~ # mkdir  /root/pvc 
root@k8s-master1:~ # cd   /root/pvc

創建rbac.yaml 文件

root@k8s-master1:pvc # cat rbac.yaml  
kind: ServiceAccount 
apiVersion: v1 
metadata: 
  name: nfs-client-provisioner 
--- 
kind: ClusterRole 
apiVersion: rbac.authorization.k8s.io/v1 
metadata: 
  name: nfs-client-provisioner-runner 
rules: 
  - apiGroups: [""] 
    resources: ["persistentvolumes"] 
    verbs: ["get", "list", "watch", "create", "delete"] 
  - apiGroups: [""] 
    resources: ["persistentvolumeclaims"] 
    verbs: ["get", "list", "watch", "update"] 
  - apiGroups: ["storage.k8s.io"] 
    resources: ["storageclasses"] 
    verbs: ["get", "list", "watch"] 
  - apiGroups: [""] 
    resources: ["events"] 
    verbs: ["create", "update", "patch"] 
--- 
kind: ClusterRoleBinding 
apiVersion: rbac.authorization.k8s.io/v1 
metadata: 
  name: run-nfs-client-provisioner 
subjects: 
  - kind: ServiceAccount 
    name: nfs-client-provisioner 
    namespace: default 
roleRef: 
  kind: ClusterRole 
  name: nfs-client-provisioner-runner 
  apiGroup: rbac.authorization.k8s.io 
--- 
kind: Role 
apiVersion: rbac.authorization.k8s.io/v1 
metadata: 
  name: leader-locking-nfs-client-provisioner 
rules: 
  - apiGroups: [""] 
    resources: ["endpoints"] 
    verbs: ["get", "list", "watch", "create", "update", "patch"] 
--- 
kind: RoleBinding 
apiVersion: rbac.authorization.k8s.io/v1 
metadata: 
  name: leader-locking-nfs-client-provisioner 
subjects: 
  - kind: ServiceAccount 
    name: nfs-client-provisioner 
    # replace with namespace where provisioner is deployed 
    namespace: default 
roleRef: 
  kind: Role 
  name: leader-locking-nfs-client-provisioner 
  apiGroup: rbac.authorization.k8s.io

創建deployment.yaml 文件

官方默認的鏡像地址，國內可能無法下載，可以使用 image:

fxkjnj/nfs-client-provisioner:latest

#定義NFS 服務器的地址，共享目錄名稱

root@k8s-master1:pvc # cat deployment.yaml  
apiVersion: v1 
kind: ServiceAccount 
metadata: 
  name: nfs-client-provisioner 
--- 
kind: Deployment 
apiVersion: apps/v1  
metadata: 
  name: nfs-client-provisioner 
spec: 
  replicas: 1 
  strategy: 
    type: Recreate 
  selector: 
    matchLabels: 
      app: nfs-client-provisioner 
  template: 
    metadata: 
      labels: 
        app: nfs-client-provisioner 
    spec: 
      serviceAccountName: nfs-client-provisioner 
      containers: 
        - name: nfs-client-provisioner 
          image: fxkjnj/nfs-client-provisioner:latest 
          volumeMounts: 
            - name: nfs-client-root 
              mountPath: /persistentvolumes 
          env: 
            - name: PROVISIONER_NAME 
              value: fuseim.pri/ifs 
            - name: NFS_SERVER 
              value: 172.16.201.209  
            - name: NFS_PATH 
              value: /home/nfs 
      volumes: 
        - name: nfs-client-root 
          nfs: 
            server: 172.16.201.209 
            path: /home/nfs

創建class.yaml

root@k8s-master1:pvc # cat class.yaml  
apiVersion: storage.k8s.io/v1 
kind: StorageClass 
metadata: 
  name: managed-nfs-storage 
provisioner: fuseim.pri/ifs # or choose another name, must match deployment's env PROVISIONER_NAME' 
parameters: 
  archiveOnDelete: "true"

部署

root@k8s-master1:pvc # kubectl apply -f . 
 
 
#查看存儲卷 
root@k8s-master1:pvc # kubectl  get sc 
NAME                  PROVISIONER      RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE 
managed-nfs-storage   fuseim.pri/ifs   Delete          Immediate           false                  25h

三、編寫mysql 相關yaml文件

MySQL 示例部署包含一個 ConfigMap、兩個 Service 與一個 StatefulSet。

ConfigMap:

vim mysql-configmap.yaml

apiVersion: v1 
kind: ConfigMap 
metadata: 
  name: mysql 
  labels: 
    app: mysql 
data: 
  master.cnf: | 
    # Apply this config only on the master. 
    [mysqld] 
    log-bin     
  slave.cnf: | 
    # Apply this config only on slaves. 
    [mysqld] 
    super-read-only

說明：

在這里，我們定義了 master.cnf 和 slave.cnf 兩個 MySQL 的配置文件

master.cnf 開啟了log-bin，可以使用二進制日志文件的方式進行主從復制.
slave.cnf 開啟了 super-read-only ，表示從節點只接受主節點的數據同步的所有寫的操作，拒絕其他的寫入操作，對于用戶來說就是只讀的
master.cnf 和 slave.cnf 已配置文件的形式掛載到容器的目錄中

Service：

vim mysql-services.yaml

# Headless service for stable DNS entries of StatefulSet members. 
apiVersion: v1 
kind: Service 
metadata: 
  name: mysql 
  labels: 
    app: mysql 
spec: 
  ports: 
  - name: mysql 
    port: 3306 
  clusterIP: None 
  selector: 
    app: mysql 
--- 
# Client service for connecting to any MySQL instance for reads. 
# For writes, you must instead connect to the master: mysql-0.mysql. 
apiVersion: v1 
kind: Service 
metadata: 
  name: mysql-read 
  labels: 
    app: mysql 
spec: 
  ports: 
  - name: mysql 
    port: 3306 
  selector: 
    app: mysql

說明：

clusterIP: None，使用無頭服務 Headless Service(相比普通Service只是將spec.clusterIP定義為None，也就是沒有clusterIP，直接使用endport 來通信)來維護Pod網絡身份，會為每個Pod分配一個數字編號并且按照編號順序部署。還需要在StatefulSet添加serviceName: “mysql”字段指定StatefulSet控制器

另外statefulset控制器網絡標識，體現在主機名和Pod A記錄：

• 主機名：<statefulset名稱>-<編號>

例如: mysql-0

• Pod DNS A記錄：<statefulset名稱-編號>.<service-name> .<namespace>.svc.cluster.local （POD 之間通過DNS A 記錄互相通信）

例如:

mysql-0.mysql.default.svc.cluster.local

StatefulSet:

vim mysql-statefulset.yaml

apiVersion: apps/v1 
kind: StatefulSet 
metadata: 
  name: mysql 
spec: 
  selector: 
    matchLabels: 
      app: mysql 
  serviceName: mysql 
  replicas: 3 
  template: 
    metadata: 
      labels: 
        app: mysql 
    spec: 
      initContainers: 
      - name: init-mysql 
        image: mysql:5.7 
        command: 
        - bash 
        - "-c" 
        - | 
          set -ex 
          # Generate mysql server-id from pod ordinal index. 
          [[ `hostname` =~ -([0-9]+)$ ]] || exit 1 
          ordinal=${BASH_REMATCH[1]} 
          echo [mysqld] > /mnt/conf.d/server-id.cnf 
          # Add an offset to avoid reserved server-id=0 value. 
          echo server-id=$((100 + $ordinal)) >> /mnt/conf.d/server-id.cnf 
          # Copy appropriate conf.d files from config-map to emptyDir. 
          if [[ $ordinal -eq 0 ]]; then 
            cp /mnt/config-map/master.cnf /mnt/conf.d/ 
          else 
            cp /mnt/config-map/slave.cnf /mnt/conf.d/ 
          fi           
        volumeMounts: 
        - name: conf 
          mountPath: /mnt/conf.d 
        - name: config-map 
          mountPath: /mnt/config-map 
      - name: clone-mysql 
        image: fxkjnj/xtrabackup:1.0 
        command: 
        - bash 
        - "-c" 
        - | 
          set -ex 
          # Skip the clone if data already exists. 
          [[ -d /var/lib/mysql/mysql ]] && exit 0 
          # Skip the clone on master (ordinal index 0). 
          [[ `hostname` =~ -([0-9]+)$ ]] || exit 1 
          ordinal=${BASH_REMATCH[1]} 
          [[ $ordinal -eq 0 ]] && exit 0 
          # Clone data from previous peer. 
          ncat --recv-only mysql-$(($ordinal-1)).mysql 3307 | xbstream -x -C /var/lib/mysql 
          # Prepare the backup. 
          xtrabackup --prepare --target-dir=/var/lib/mysql           
        volumeMounts: 
        - name: data 
          mountPath: /var/lib/mysql 
          subPath: mysql 
        - name: conf 
          mountPath: /etc/mysql/conf.d 
      containers: 
      - name: mysql 
        image: mysql:5.7 
        env: 
        - name: MYSQL_ALLOW_EMPTY_PASSWORD 
          value: "1" 
        ports: 
        - name: mysql 
          containerPort: 3306 
        volumeMounts: 
        - name: data 
          mountPath: /var/lib/mysql 
          subPath: mysql 
        - name: conf 
          mountPath: /etc/mysql/conf.d 
        resources: 
          requests: 
            cpu: 500m 
            memory: 1Gi 
        livenessProbe: 
          exec: 
            command: ["mysqladmin", "ping"] 
          initialDelaySeconds: 30 
          periodSeconds: 10 
          timeoutSeconds: 5 
        readinessProbe: 
          exec: 
            # Check we can execute queries over TCP (skip-networking is off). 
            command: ["mysql", "-h", "127.0.0.1", "-e", "SELECT 1"] 
          initialDelaySeconds: 5 
          periodSeconds: 2 
          timeoutSeconds: 1 
      - name: xtrabackup 
        image: fxkjnj/xtrabackup:1.0 
        ports: 
        - name: xtrabackup 
          containerPort: 3307 
        command: 
        - bash 
        - "-c" 
        - | 
          set -ex 
          cd /var/lib/mysql 
 
          # Determine binlog position of cloned data, if any. 
          if [[ -f xtrabackup_slave_info && "x$(<xtrabackup_slave_info)" != "x" ]]; then 
            # XtraBackup already generated a partial "CHANGE MASTER TO" query 
            # because we're cloning from an existing slave. (Need to remove the tailing semicolon!) 
            cat xtrabackup_slave_info | sed -E 's/;$//g' > change_master_to.sql.in 
            # Ignore xtrabackup_binlog_info in this case (it's useless). 
            rm -f xtrabackup_slave_info xtrabackup_binlog_info 
          elif [[ -f xtrabackup_binlog_info ]]; then 
            # We're cloning directly from master. Parse binlog position. 
            [[ `cat xtrabackup_binlog_info` =~ ^(.*?)[[:space:]]+(.*?)$ ]] || exit 1 
            rm -f xtrabackup_binlog_info xtrabackup_slave_info 
            echo "CHANGE MASTER TO MASTER_LOG_FILE='${BASH_REMATCH[1]}',\ 
                  MASTER_LOG_POS=${BASH_REMATCH[2]}" > change_master_to.sql.in 
          fi 
 
          # Check if we need to complete a clone by starting replication. 
          if [[ -f change_master_to.sql.in ]]; then 
            echo "Waiting for mysqld to be ready (accepting connections)" 
            until mysql -h 127.0.0.1 -e "SELECT 1"; do sleep 1; done 
 
            echo "Initializing replication from clone position" 
            mysql -h 127.0.0.1 \ 
                  -e "$(<change_master_to.sql.in), \ 
                          MASTER_HOST='mysql-0.mysql', \ 
                          MASTER_USER='root', \ 
                          MASTER_PASSWORD='', \ 
                          MASTER_CONNECT_RETRY=10; \ 
                        START SLAVE;" || exit 1 
            # In case of container restart, attempt this at-most-once. 
            mv change_master_to.sql.in change_master_to.sql.orig 
          fi 
 
          # Start a server to send backups when requested by peers. 
          exec ncat --listen --keep-open --send-only --max-conns=1 3307 -c \ 
            "xtrabackup --backup --slave-info --stream=xbstream --host=127.0.0.1 --user=root"           
        volumeMounts: 
        - name: data 
          mountPath: /var/lib/mysql 
          subPath: mysql 
        - name: conf 
          mountPath: /etc/mysql/conf.d 
        resources: 
          requests: 
            cpu: 100m 
            memory: 100Mi 
      volumes: 
      - name: conf 
        emptyDir: {} 
      - name: config-map 
        configMap: 
          name: mysql 
  volumeClaimTemplates: 
  - metadata: 
      name: data 
    spec: 
      storageClassName: "managed-nfs-storage" 
      accessModes: ["ReadWriteOnce"] 
      resources: 
        requests: 
          storage: 0.5Gi

說明：

使用xtrbackup 工具進行容器初始化數據的備份，https://www.toutiao.com/i6999565563710292484
使用linux 自帶的ncat 工具進行容器初始化數據的拷貝[使用ncat指令，遠程地從前一個節點拷貝數據到本地] https://www.cnblogs.com/chengd/p/7565280.html
使用mysql的binlog 主從復制來保證主從之間的數據一致
利用pod的主機名的序號來判斷當前節點為主節點還是從節點，再根據對于節點拷貝不同的配置文件到指定位置
使用mysqladmin的ping 作為數據庫的健康檢測方式
使用nfs存儲的 PV 動態供給(StorageClass)，持久化mysql的數據文件

四、部署并測試

root@k8s-master1:~/kubernetes/mysql# ll 
total 24 
drwxr-xr-x 2 root root 4096 Nov  3 16:42 ./ 
drwxr-xr-x 8 root root 4096 Nov  3 13:33 ../ 
-rw-r--r-- 1 root root  278 Nov  2 22:15 mysql-configmap.yaml 
-rw-r--r-- 1 root root  556 Nov  2 22:08 mysql-services.yaml 
-rw-r--r-- 1 root root 5917 Nov  3 14:22 mysql-statefulset.yaml 
 
root@k8s-master1:~/kubernetes/mysql# kubectl apply -f . 
configmap/mysql create 
service/mysql create 
service/mysql-read create 
statefulset.apps/mysql create 
 
 
#動態追蹤查看Pod的狀態： 
root@k8s-master1:~/kubernetes/mysql# kubectl get pods -l app=mysql --watch 
NAME      READY   STATUS    RESTARTS   AGE 
mysql-0   2/2     Running   0          3h12m 
mysql-1   2/2     Running   0          3h11m 
mysql-2   2/2     Running   0          3h10m

可以看到，StatefulSet 啟動成功后，將會有三個 Pod 運行。

接下來，我們可以嘗試向這個 MySQL 集群發起請求，執行一些 SQL 操作來驗證它是否正常：

kubectl run mysql-client --image=mysql:5.7 -i --rm --restart=Never --\ 
mysql -h mysql-0.mysql <<EOF 
CREATE DATABASE test; 
CREATE TABLE test.messages (message VARCHAR(250)); 
INSERT INTO test.messages VALUES ('hello'); 
EOF

如上所示，我們通過啟動一個容器，使用 MySQL client 執行了創建數據庫和表、以及插入數據的操作。需要注意的是，我們連接的 MySQL 的地址必須是 mysql-0.mysql(即：Master 節點的 DNS A 記錄, 因為POD 之間通過DNS A 記錄互相通信)只有 Master 節點才能處理寫操作。

而通過連接 mysql-read 這個 Service，我們就可以用 SQL 進行讀操作，如下所示：

kubectl run mysql-client --image=mysql:5.7 -i -t --rm --restart=Never --\ 
  mysql -h mysql-read -e "SELECT * FROM test.messages" 
   
   
#你應該獲得如下輸出： 
Waiting for pod default/mysql-client to be running, status is Pending, pod ready: false 
+---------+ 
| message | 
+---------+ 
| hello   | 
+---------+ 
pod "mysql-client" deleted

或者：

root@k8s-master1:~/kubernetes/mysql# kubectl run -it --rm --image=mysql:5.7 --restart=Never mysql-client -- mysql -h mysql-read 
If you don't see a command prompt, try pressing enter. 
Welcome to the MySQL monitor.  Commands end with ; or \g. 
Your MySQL connection id is 7251 
Server version: 5.7.36 MySQL Community Server (GPL) 
 
Copyright (c) 2000, 2021, Oracle and/or its affiliates. 
 
Oracle is a registered trademark of Oracle Corporation and/or its 
affiliates. Other names may be trademarks of their respective 
owners. 
 
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. 
 
mysql> SELECT * FROM test.messages; 
+---------+ 
| message | 
+---------+ 
| hello   | 
+---------+ 
1 row in set (0.00 sec) 
 
mysql>

責任編輯：姜華來源：今日頭條