运行复制的有状态应用程序

此页面展示了如何使用 StatefulSet 运行复制状态应用程序。此应用程序是复制的 MySQL 数据库。示例拓扑结构包含一个主服务器和多个副本，使用异步基于行的复制。

注意

这不是生产配置。MySQL 设置保持在不安全的默认值，以将重点放在 Kubernetes 中运行有状态应用程序的一般模式上。

开始之前

您需要拥有一个 Kubernetes 集群，并且 kubectl 命令行工具必须配置为与您的集群通信。建议在至少有两个节点的集群上运行本教程，这些节点不充当控制平面主机。如果您还没有集群，可以使用 minikube 创建一个，或者可以使用以下 Kubernetes 游乐场之一
- Killercoda
- 玩转 Kubernetes
您需要拥有一个具有默认 StorageClass 的动态持久卷供应器，或者静态供应持久卷以满足此处使用的持久卷声明。
本教程假设您熟悉持久卷和 StatefulSet，以及其他核心概念，如 Pod、服务和配置映射。
对 MySQL 有些了解会有所帮助，但本教程旨在展示对其他系统有用的通用模式。
您正在使用默认命名空间或不包含任何冲突对象的另一个命名空间。

目标

使用 StatefulSet 部署复制的 MySQL 拓扑结构。
发送 MySQL 客户端流量。
观察对停机的抵抗力。
向上和向下扩展 StatefulSet。

部署 MySQL

示例 MySQL 部署包含一个配置映射、两个服务和一个 StatefulSet。

创建配置映射

从以下 YAML 配置文件创建配置映射

application/mysql/mysql-configmap.yaml

apiVersion: v1
kind: ConfigMap
metadata:
  name: mysql
  labels:
    app: mysql
    app.kubernetes.io/name: mysql
data:
  primary.cnf: |
    # Apply this config only on the primary.
    [mysqld]
    log-bin    
  replica.cnf: |
    # Apply this config only on replicas.
    [mysqld]
    super-read-only

kubectl apply -f https://k8s.io/examples/application/mysql/mysql-configmap.yaml

此配置映射提供 my.cnf 覆盖，使您能够独立控制主 MySQL 服务器及其副本上的配置。在这种情况下，您希望主服务器能够向副本提供复制日志，并且您希望副本拒绝任何不通过复制进行的写入。

配置映射本身没有任何特殊之处会导致不同的部分应用于不同的 Pod。每个 Pod 在初始化时会根据 StatefulSet 控制器提供的信息决定查看哪个部分。

创建服务

从以下 YAML 配置文件创建服务

application/mysql/mysql-services.yaml

# Headless service for stable DNS entries of StatefulSet members.
apiVersion: v1
kind: Service
metadata:
  name: mysql
  labels:
    app: mysql
    app.kubernetes.io/name: 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 primary: mysql-0.mysql.
apiVersion: v1
kind: Service
metadata:
  name: mysql-read
  labels:
    app: mysql
    app.kubernetes.io/name: mysql
    readonly: "true"
spec:
  ports:
  - name: mysql
    port: 3306
  selector:
    app: mysql

kubectl apply -f https://k8s.io/examples/application/mysql/mysql-services.yaml

无头服务为 StatefulSet 控制器为集合中每个 Pod 创建的 DNS 条目提供了一个家。由于无头服务名为 mysql，因此可以通过解析 <pod-name>.mysql 从同一 Kubernetes 集群和命名空间中的任何其他 Pod 中访问 Pod。

名为 mysql-read 的客户端服务是一个普通的服务，它有自己的集群 IP，它将连接分发到所有报告为 Ready 的 MySQL Pod。潜在端点集包括主 MySQL 服务器和所有副本。

请注意，只有读取查询可以使用负载均衡的客户端服务。由于只有一个主 MySQL 服务器，因此客户端应直接连接到主 MySQL Pod（通过其在无头服务中的 DNS 条目）以执行写入。

创建 StatefulSet

最后，从以下 YAML 配置文件创建 StatefulSet

application/mysql/mysql-statefulset.yaml

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: mysql
spec:
  selector:
    matchLabels:
      app: mysql
      app.kubernetes.io/name: mysql
  serviceName: mysql
  replicas: 3
  template:
    metadata:
      labels:
        app: mysql
        app.kubernetes.io/name: 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/primary.cnf /mnt/conf.d/
          else
            cp /mnt/config-map/replica.cnf /mnt/conf.d/
          fi          
        volumeMounts:
        - name: conf
          mountPath: /mnt/conf.d
        - name: config-map
          mountPath: /mnt/config-map
      - name: clone-mysql
        image: gcr.io/google-samples/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 primary (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: gcr.io/google-samples/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 replica. (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 primary. 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:
      accessModes: ["ReadWriteOnce"]
      resources:
        requests:
          storage: 10Gi

kubectl apply -f https://k8s.io/examples/application/mysql/mysql-statefulset.yaml

您可以通过运行以下命令来观察启动进度

kubectl get pods -l app=mysql --watch

过了一会儿，您应该看到所有 3 个 Pod 都变为 Running

NAME      READY     STATUS    RESTARTS   AGE
mysql-0   2/2       Running   0          2m
mysql-1   2/2       Running   0          1m
mysql-2   2/2       Running   0          1m

按 Ctrl+C 取消监视。

注意

如果您没有看到任何进度，请确保您启用了动态持久卷供应器，如先决条件中所述。

此清单使用各种技术来管理作为 StatefulSet 一部分的有状态 Pod。下一节重点介绍其中一些技术，以解释 StatefulSet 创建 Pod 时会发生什么。

了解有状态 Pod 初始化

StatefulSet 控制器一次启动一个 Pod，按其序号索引排序。它会等待每个 Pod 报告为 Ready，然后再启动下一个 Pod。

此外，控制器会为每个 Pod 分配一个唯一的、稳定的名称，格式为 <statefulset-name>-<ordinal-index>，这会导致 Pod 的名称分别为 mysql-0、mysql-1 和 mysql-2。

上面 StatefulSet 清单中的 Pod 模板利用了这些属性来执行 MySQL 复制的有序启动。

生成配置

在 Pod 规范中启动任何容器之前，Pod 会先按定义的顺序运行所有初始化容器。

第一个初始化容器名为 init-mysql，它根据序数索引生成特殊的 MySQL 配置文件。

该脚本通过从 Pod 名称末尾提取序数索引来确定自己的序数索引，Pod 名称由 hostname 命令返回。然后，它将序数（带有数字偏移量以避免保留值）保存到 MySQL conf.d 目录中的名为 server-id.cnf 的文件中。这将 StatefulSet 提供的唯一、稳定标识转换为 MySQL 服务器 ID 的域，后者需要相同的属性。

init-mysql 容器中的脚本还会从 ConfigMap 中应用 primary.cnf 或 replica.cnf，方法是将内容复制到 conf.d 中。由于示例拓扑包含一个主 MySQL 服务器和任意数量的副本，因此该脚本将序数 0 分配为主服务器，将所有其他服务器分配为副本。结合 StatefulSet 控制器对部署顺序保证，这确保了主 MySQL 服务器在创建副本之前处于就绪状态，以便副本可以开始复制。

克隆现有数据

通常，当一个新的 Pod 加入集合作为副本时，它必须假设主 MySQL 服务器可能已经存在数据。它还必须假设复制日志可能不会一直追溯到最初的时间。这些保守的假设是允许运行中的 StatefulSet 随着时间的推移进行扩展和缩减的关键，而不是固定在初始大小。

第二个初始化容器名为 clone-mysql，它在副本 Pod 第一次在空的 PersistentVolume 上启动时执行克隆操作。这意味着它会从另一个正在运行的 Pod 中复制所有现有数据，以便其本地状态足够一致，可以从主服务器开始复制。

MySQL 本身没有提供执行此操作的机制，因此示例使用了一个名为 Percona XtraBackup 的流行开源工具。在克隆期间，源 MySQL 服务器的性能可能会下降。为了最大程度地减少对主 MySQL 服务器的影响，该脚本指示每个 Pod 从序数索引低一个的 Pod 克隆数据。这是有效的，因为 StatefulSet 控制器始终确保 Pod N 在启动 Pod N+1 之前处于就绪状态。

启动复制

初始化容器成功完成之后，常规容器就会运行。MySQL Pod 包含一个运行实际 mysqld 服务器的 mysql 容器，以及一个充当边车的 xtrabackup 容器。

xtrabackup 边车会查看克隆的数据文件，并确定是否需要在副本上初始化 MySQL 复制。如果是，它会等待 mysqld 就绪，然后使用从 XtraBackup 克隆文件中提取的复制参数执行 CHANGE MASTER TO 和 START SLAVE 命令。

副本开始复制后，它会记住其主 MySQL 服务器，并在服务器重启或连接断开时自动重新连接。此外，由于副本在其稳定的 DNS 名称（mysql-0.mysql）处查找主服务器，因此即使主服务器由于重新调度而获得新的 Pod IP，它们也能自动找到主服务器。

最后，在启动复制后，xtrabackup 容器会监听来自其他 Pod 的数据克隆请求连接。该服务器会无限期地保持运行，以防 StatefulSet 扩展，或者以防下一个 Pod 丢失其 PersistentVolumeClaim 并需要重新执行克隆。

发送客户端流量

您可以通过运行一个带有 mysql:5.7 镜像的临时容器并运行 mysql 客户端二进制文件，将测试查询发送到主 MySQL 服务器（主机名 mysql-0.mysql）。

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-read 将测试查询发送到任何报告处于就绪状态的服务器。

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

为了演示 mysql-read 服务如何将连接分配到各个服务器，您可以在循环中运行 SELECT @@server_id

kubectl run mysql-client-loop --image=mysql:5.7 -i -t --rm --restart=Never --\
  bash -ic "while sleep 1; do mysql -h mysql-read -e 'SELECT @@server_id,NOW()'; done"

您应该看到报告的 @@server_id 随机变化，因为每次连接尝试时可能会选择不同的端点。

+-------------+---------------------+
| @@server_id | NOW()               |
+-------------+---------------------+
|         100 | 2006-01-02 15:04:05 |
+-------------+---------------------+
+-------------+---------------------+
| @@server_id | NOW()               |
+-------------+---------------------+
|         102 | 2006-01-02 15:04:06 |
+-------------+---------------------+
+-------------+---------------------+
| @@server_id | NOW()               |
+-------------+---------------------+
|         101 | 2006-01-02 15:04:07 |
+-------------+---------------------+

您可以在想要停止循环时按 Ctrl+C，但将其在另一个窗口中保持运行很有用，这样您就可以看到以下步骤的效果。

模拟 Pod 和节点故障

为了演示从副本池而不是单个服务器读取的可用性提高，请在强制 Pod 退出就绪状态的同时，保持上述 SELECT @@server_id 循环运行。

破坏就绪探测

mysql 容器的就绪探测会运行命令 mysql -h 127.0.0.1 -e 'SELECT 1' 以确保服务器已启动并能够执行查询。

强制此就绪探测失败的一种方法是破坏该命令。

kubectl exec mysql-2 -c mysql -- mv /usr/bin/mysql /usr/bin/mysql.off

这会进入 Pod mysql-2 的实际容器文件系统，并重命名 mysql 命令，以便就绪探测无法找到它。几秒钟后，Pod 应该会报告其一个容器未处于就绪状态，您可以通过运行以下命令进行检查。

kubectl get pod mysql-2

在 READY 列中查找 1/2。

NAME      READY     STATUS    RESTARTS   AGE
mysql-2   1/2       Running   0          3m

此时，您应该看到 SELECT @@server_id 循环继续运行，尽管它不再报告 102。请记住，init-mysql 脚本将 server-id 定义为 100 + $ordinal，因此服务器 ID 102 对应于 Pod mysql-2。

现在修复 Pod，它应该在几秒钟后重新出现在循环输出中。

kubectl exec mysql-2 -c mysql -- mv /usr/bin/mysql.off /usr/bin/mysql

删除 Pod

如果 Pod 被删除，StatefulSet 也会重新创建 Pod，类似于 ReplicaSet 对无状态 Pod 的操作。

kubectl delete pod mysql-2

StatefulSet 控制器会注意到不再存在 mysql-2 Pod，并创建一个具有相同名称且链接到相同 PersistentVolumeClaim 的新 Pod。您应该看到服务器 ID 102 从循环输出中消失一段时间，然后自行返回。

清空节点

如果您的 Kubernetes 集群有多个节点，您可以通过发出清空命令来模拟节点停机（例如，节点升级时）。

首先确定其中一个 MySQL Pod 所在的节点。

kubectl get pod mysql-2 -o wide

节点名称应该显示在最后一列中。

NAME      READY     STATUS    RESTARTS   AGE       IP            NODE
mysql-2   2/2       Running   0          15m       10.244.5.27   kubernetes-node-9l2t

然后，通过运行以下命令清空节点，该命令会将其隔离，因此不再允许新的 Pod 在其上调度，然后会逐出任何现有的 Pod。将 <node-name> 替换为您在上一步中找到的节点名称。

注意

清空节点可能会影响在同一节点上运行的其他工作负载和应用程序。仅在测试集群中执行以下步骤。

# See above advice about impact on other workloads
kubectl drain <node-name> --force --delete-emptydir-data --ignore-daemonsets

现在，您可以观察 Pod 如何在另一个节点上重新调度。

kubectl get pod mysql-2 -o wide --watch

它应该看起来像这样

NAME      READY   STATUS          RESTARTS   AGE       IP            NODE
mysql-2   2/2     Terminating     0          15m       10.244.1.56   kubernetes-node-9l2t
[...]
mysql-2   0/2     Pending         0          0s        <none>        kubernetes-node-fjlm
mysql-2   0/2     Init:0/2        0          0s        <none>        kubernetes-node-fjlm
mysql-2   0/2     Init:1/2        0          20s       10.244.5.32   kubernetes-node-fjlm
mysql-2   0/2     PodInitializing 0          21s       10.244.5.32   kubernetes-node-fjlm
mysql-2   1/2     Running         0          22s       10.244.5.32   kubernetes-node-fjlm
mysql-2   2/2     Running         0          30s       10.244.5.32   kubernetes-node-fjlm

同样，您应该看到服务器 ID 102 从 SELECT @@server_id 循环输出中消失一段时间，然后返回。

现在取消隔离节点，将其恢复到正常状态。

kubectl uncordon <node-name>

扩展副本数量

使用 MySQL 复制时，您可以通过添加副本来扩展读取查询容量。对于 StatefulSet，您可以使用单个命令来实现这一点。

kubectl scale statefulset mysql  --replicas=5

通过运行以下命令观察新的 Pod 启动。

kubectl get pods -l app=mysql --watch

一旦它们启动，您应该看到服务器 ID 103 和 104 开始出现在 SELECT @@server_id 循环输出中。

您还可以验证这些新服务器是否具有您在它们存在之前添加的数据。

kubectl run mysql-client --image=mysql:5.7 -i -t --rm --restart=Never --\
  mysql -h mysql-3.mysql -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

缩减规模也是无缝的。

kubectl scale statefulset mysql --replicas=3

注意

虽然扩展会自动创建新的 PersistentVolumeClaim，但缩减不会自动删除这些 PVC。

这使您可以选择保留这些已初始化的 PVC 以便更快地扩展，或者在删除它们之前提取数据。

您可以通过运行以下命令来查看这一点。

kubectl get pvc -l app=mysql

这表明所有 5 个 PVC 仍然存在，尽管您已将 StatefulSet 缩减到 3 个。

NAME           STATUS    VOLUME                                     CAPACITY   ACCESSMODES   AGE
data-mysql-0   Bound     pvc-8acbf5dc-b103-11e6-93fa-42010a800002   10Gi       RWO           20m
data-mysql-1   Bound     pvc-8ad39820-b103-11e6-93fa-42010a800002   10Gi       RWO           20m
data-mysql-2   Bound     pvc-8ad69a6d-b103-11e6-93fa-42010a800002   10Gi       RWO           20m
data-mysql-3   Bound     pvc-50043c45-b1c5-11e6-93fa-42010a800002   10Gi       RWO           2m
data-mysql-4   Bound     pvc-500a9957-b1c5-11e6-93fa-42010a800002   10Gi       RWO           2m

如果您不打算重用额外的 PVC，则可以删除它们。

kubectl delete pvc data-mysql-3
kubectl delete pvc data-mysql-4

清理

通过在终端中按 Ctrl+C 或从另一个终端运行以下命令来取消 SELECT @@server_id 循环。
```
kubectl delete pod mysql-client-loop --now
```
删除 StatefulSet。这也会开始终止 Pod。
```
kubectl delete statefulset mysql
```
验证 Pod 是否消失。它们可能需要一些时间才能完成终止。
```
kubectl get pods -l app=mysql
```
当上述命令返回时，您就知道 Pod 已终止。
```
No resources found.
```
删除 ConfigMap、服务和 PersistentVolumeClaim。
```
kubectl delete configmap,service,pvc -l app=mysql
```
如果您手动配置了 PersistentVolume，则还需要手动删除它们，以及释放底层资源。如果您使用了动态配置器，则它会在看到您删除了 PersistentVolumeClaim 时自动删除 PersistentVolume。一些动态配置器（例如 EBS 和 PD 的配置器）还会在删除 PersistentVolume 时释放底层资源。

下一步

了解有关扩展 StatefulSet 的更多信息。
了解有关调试 StatefulSet 的更多信息。
了解有关删除 StatefulSet 的更多信息。
了解有关强制删除 StatefulSet Pod 的更多信息。
在 Helm Charts 存储库中查找其他有状态应用程序示例。

上次修改时间：2023 年 8 月 24 日下午 6:38 PST：使用 code_sample 短代码代替 code 短代码 (e8b136c3b3)