【重识云原生】第六章容器基础6.4.10.2节——StatefulSet常规操作实操

  《重识云原生系列》专题索引:

  1. 第一章——不谋全局不足以谋一域
  2. 第二章计算第1节——计算虚拟化技术总述
  3. 第二章计算第2节——主流虚拟化技术之VMare ESXi
  4. 第二章计算第3节——主流虚拟化技术之Xen
  5. 第二章计算第4节——主流虚拟化技术之KVM
  6. 第二章计算第5节——商用云主机方案
  7. 第二章计算第6节——裸金属方案
  8. 第三章云存储第1节——分布式云存储总述
  9. 第三章云存储第2节——SPDK方案综述
  10. 第三章云存储第3节——Ceph统一存储方案
  11. 第三章云存储第4节——OpenStack Swift 对象存储方案
  12. 第三章云存储第5节——商用分布式云存储方案
  13. 第四章云网络第一节——云网络技术发展简述
  14. 第四章云网络4.2节——相关基础知识准备
  15. 第四章云网络4.3节——重要网络协议
  16. 第四章云网络4.3.1节——路由技术简述
  17. 第四章云网络4.3.2节——VLAN技术
  18. 第四章云网络4.3.3节——RIP协议
  19. 第四章云网络4.3.4节——OSPF协议
  20. 第四章云网络4.3.5节——EIGRP协议
  21. 第四章云网络4.3.6节——IS-IS协议
  22. 第四章云网络4.3.7节——BGP协议
  23. 第四章云网络4.3.7.2节——BGP协议概述
  24. 第四章云网络4.3.7.3节——BGP协议实现原理
  25. 第四章云网络4.3.7.4节——高级特性
  26. 第四章云网络4.3.7.5节——实操
  27. 第四章云网络4.3.7.6节——MP-BGP协议
  28. 第四章云网络4.3.8节——策略路由
  29. 第四章云网络4.3.9节——Graceful Restart(平滑重启)技术
  30. 第四章云网络4.3.10节——VXLAN技术
  31. 第四章云网络4.3.10.2节——VXLAN Overlay网络方案设计
  32. 第四章云网络4.3.10.3节——VXLAN隧道机制
  33. 第四章云网络4.3.10.4节——VXLAN报文转发过程
  34. 第四章云网络4.3.10.5节——VXlan组网架构
  35. 第四章云网络4.3.10.6节——VXLAN应用部署方案
  36. 第四章云网络4.4节——Spine-Leaf网络架构
  37. 第四章云网络4.5节——大二层网络
  38. 第四章云网络4.6节——Underlay 和 Overlay概念
  39. 第四章云网络4.7.1节——网络虚拟化与卸载加速技术的演进简述
  40. 第四章云网络4.7.2节——virtio网络半虚拟化简介
  41. 第四章云网络4.7.3节——Vhost-net方案
  42. 第四章云网络4.7.4节vhost-user方案——virtio的DPDK卸载方案
  43. 第四章云网络4.7.5节vDPA方案——virtio的半硬件虚拟化实现
  44. 第四章云网络4.7.6节——virtio-blk存储虚拟化方案
  45. 第四章云网络4.7.8节——SR-IOV方案
  46. 第四章云网络4.7.9节——NFV
  47. 第四章云网络4.8.1节——SDN总述
  48. 第四章云网络4.8.2.1节——OpenFlow概述
  49. 第四章云网络4.8.2.2节——OpenFlow协议详解
  50. 第四章云网络4.8.2.3节——OpenFlow运行机制
  51. 第四章云网络4.8.3.1节——Open vSwitch简介
  52. 第四章云网络4.8.3.2节——Open vSwitch工作原理详解
  53. 第四章云网络4.8.4节——OpenStack与SDN的集成
  54. 第四章云网络4.8.5节——OpenDayLight
  55. 第四章云网络4.8.6节——Dragonflow
  56.  第四章云网络4.9.1节——网络卸载加速技术综述

  57. 第四章云网络4.9.2节——传统网络卸载技术

  58. 第四章云网络4.9.3.1节——DPDK技术综述

  59. 第四章云网络4.9.3.2节——DPDK原理详解

  60. 第四章云网络4.9.4.1节——智能网卡SmartNIC方案综述

  61. 第四章云网络4.9.4.2节——智能网卡实现

  62. 第六章容器6.1.1节——容器综述

  63. 第六章容器6.1.2节——容器安装部署

  64. 第六章容器6.1.3节——Docker常用命令

  65. 第六章容器6.1.4节——Docker核心技术LXC

  66. 第六章容器6.1.5节——Docker核心技术Namespace

  67. 第六章容器6.1.6节—— Docker核心技术Chroot

  68. 第六章容器6.1.7.1节——Docker核心技术cgroups综述

  69. 第六章容器6.1.7.2节——cgroups原理剖析

  70. 第六章容器6.1.7.3节——cgroups数据结构剖析

  71. 第六章容器6.1.7.4节——cgroups使用

  72. 第六章容器6.1.8节——Docker核心技术UnionFS

  73. 第六章容器6.1.9节——Docker镜像技术剖析

  74. 第六章容器6.1.10节——DockerFile解析

  75. 第六章容器6.1.11节——docker-compose容器编排

  76. 第六章容器6.1.12节——Docker网络模型设计

  77. 第六章容器6.2.1节——Kubernetes概述

  78. 第六章容器6.2.2节——K8S架构剖析

  79. 第六章容器6.3.1节——K8S核心组件总述

  80. 第六章容器6.3.2节——API Server组件

  81. 第六章容器6.3.3节——Kube-Scheduler使用篇

  82. 第六章容器6.3.4节——etcd组件

  83. 第六章容器6.3.5节——Controller Manager概述

  84. 第六章容器6.3.6节——kubelet组件

  85. 第六章容器6.3.7节——命令行工具kubectl

  86. 第六章容器6.3.8节——kube-proxy

  87. 第六章容器6.4.1节——K8S资源对象总览

  88. 第六章容器6.4.2.1节——pod详解

  89. 第六章容器6.4.2.2节——Pod使用(上)

  90. 第六章容器6.4.2.3节——Pod使用(下)

  91. 第六章容器6.4.3节——ReplicationController

  92. 第六章容器6.4.4节——ReplicaSet组件

  93. 第六章容器基础6.4.5.1节——Deployment概述

  94. 第六章容器基础6.4.5.2节——Deployment配置详细说明

  95. 第六章容器基础6.4.5.3节——Deployment实现原理解析

  96. 第六章容器基础6.4.6节——Daemonset

  97. 第六章容器基础6.4.7节——Job

  98. 第六章容器基础6.4.8节——CronJob

 

1 概述

        StatefulSet 旨在与有状态的应用及分布式系统一起使用。本节将通过使用 StatefulSet 部署一个简单的 Web 应用,来演示StatefulSet的常规操作,包括:

  • 如何创建 StatefulSet
  • StatefulSet 怎样管理它的 Pod
  • 如何删除 StatefulSet
  • 如何对 StatefulSet 进行扩容/缩容
  • 如何更新一个 StatefulSet 的 Pod

2 StatefulSet实操演示

2.1 创建 StatefulSet

        作为开始,使用如下示例创建一个 StatefulSet。它和 StatefulSet 概念中的示例相似。 它创建了一个 Headless Service nginx 用来发布 StatefulSet web 中的 Pod 的 IP 地址。application/web/web.yaml 

apiVersion: v1 
kind: Service 
metadata: 
  name: nginx 
  labels: 
    app: nginx 
    spec: 
      ports: 
        - port: 80 
          name: web 
      clusterIP: None 
      selector: 
        app: nginx 
--- 
apiVersion: apps/v1 
kind: StatefulSet 
metadata: 
  name: web 
spec: 
  serviceName: "nginx" 
  replicas: 2 
  selector: 
    matchLabels: 
      app: nginx 
    template: 
      metadata: 
        labels: 
          app: nginx 
      spec: 
        containers: 
          - name: nginx 
            image: registry.k8s.io/nginx-slim:0.8 
            ports: 
              - containerPort: 80 
                name: web 
            volumeMounts: 
              - name: www 
                mountPath: /usr/share/nginx/html 
  volumeClaimTemplates: 
    - metadata: 
      name: www 
      spec: 
        accessModes: [ "ReadWriteOnce" ] 
        resources: 
          requests: 
            storage: 1Gi

        下载上面的例子并保存为文件 web.yaml。

        你需要使用两个终端窗口。在第一个终端中,使用 kubectl get 来监视 StatefulSet 的 Pod 的创建情况。

kubectl get pods -w -l app=nginx

        在另一个终端中,使用 kubectl apply 来创建定义在 web.yaml 中的 Headless Service 和 StatefulSet。

kubectl apply -f web.yaml
service/nginx created 
statefulset.apps/web created

        上面的命令创建了两个 Pod,每个都运行了一个 NginX Web 服务器。 获取 nginx Service:

kubectl get service nginx
NAME     TYPE    CLUSTER-IP EXTERNAL-IP PORT(S) AGE 
nginx ClusterIP     None     <none>     80/TCP  12s

        然后获取 web StatefulSet,以验证两者均已成功创建:

kubectl get statefulset web
NAME DESIRED CURRENT AGE 
web     2       1    20s

2.2 顺序创建 Pod

        对于一个拥有 n 个副本的 StatefulSet,Pod 被部署时是按照 {0..n-1} 的序号顺序创建的。 在第一个终端中使用 kubectl get 检查输出。这个输出最终将看起来像下面的样子。

kubectl get pods -w -l app=nginx

NAME  READY STATUS            RESTARTS AGE 
web-0  0/1  Pending              0     0s 
web-0  0/1  Pending 0 0s 
web-0  0/1  ContainerCreating    0     0s 
web-0  1/1  Running              0     19s 
web-1  0/1  Pending              0     0s 
web-1  0/1  Pending              0     0s 
web-1  0/1  ContainerCreating    0     0s 
web-1  1/1  Running              0     18s

        请注意,直到 web-0 Pod 处于 Running(请参阅 Pod 阶段) 并 Ready(请参阅 Pod 状况中的 type)状态后,web-1 Pod 才会被启动。

2.3 StatefulSet 中的 Pod

        StatefulSet 中的每个 Pod 拥有一个唯一的顺序索引和稳定的网络身份标识。

2.3.1 检查 Pod 的顺序索引

        获取 StatefulSet 的 Pod:

kubectl get pods -l app=nginx

NAME  READY STATUS  RESTARTS AGE 
web-0  1/1  Running    0     1m 
web-1  1/1  Running    0     1m

        如同 StatefulSet 概念中所提到的, StatefulSet 中的每个 Pod 拥有一个具有黏性的、独一无二的身份标志。 这个标志基于 StatefulSet 控制器分配给每个 Pod 的唯一顺序索引。 Pod 名称的格式为 -。 web StatefulSet 拥有两个副本,所以它创建了两个 Pod:web-0 和 web-1。

2.3.2 使用稳定的网络身份标识

        每个 Pod 都拥有一个基于其顺序索引的稳定的主机名。使用 kubectl exec 在每个 Pod 中执行 hostname:

for i in 0 1; do kubectl exec "web-$i" -- sh -c 'hostname'; done

web-0 
web-1

        使用 kubectl run 运行一个提供 nslookup 命令的容器,该命令来自于 dnsutils 包。 通过对 Pod 的主机名执行 nslookup,你可以检查这些主机名在集群内部的 DNS 地址:

kubectl run -i --tty --image busybox:1.28 dns-test --restart=Never --rm

        这将启动一个新的 Shell。在新 Shell 中运行:

# 在 dns-test 容器 Shell 中运行以下命令 
nslookup web-0.nginx

        输出类似于:

Server: 10.0.0.10 
Address 1: 10.0.0.10 kube-dns.kube-system.svc.cluster.local 

Name: web-0.nginx 
Address 1: 10.244.1.6 

nslookup web-1.nginx 
Server: 10.0.0.10 
Address 1: 10.0.0.10 kube-dns.kube-system.svc.cluster.local 

Name: web-1.nginx 
Address 1: 10.244.2.6

(现在可以退出容器 Shell:exit)

        headless service 的 CNAME 指向 SRV 记录(记录每个 Running 和 Ready 状态的 Pod)。 SRV 记录指向一个包含 Pod IP 地址的记录表项。

        在一个终端中监视 StatefulSet 的 Pod:

kubectl get pod -w -l app=nginx

        在另一个终端中使用 kubectl delete 删除 StatefulSet 中所有的 Pod:

kubectl delete pod -l app=nginx

pod "web-0" deleted 
pod "web-1" deleted

        等待 StatefulSet 重启它们,并且两个 Pod 都变成 Running 和 Ready 状态:

kubectl get pod -w -l app=nginx

NAME  READY     STATUS         RESTARTS AGE 
web-0  0/1  ContainerCreating     0     0s 

NAME  READY STATUS            RESTARTS AGE 
web-0  1/1  Running              0     2s 
web-1  0/1  Pending              0     0s 
web-1  0/1  Pending              0     0s 
web-1  0/1  ContainerCreating    0     0s 
web-1  1/1  Running              0     34s

        使用 kubectl exec 和 kubectl run 查看 Pod 的主机名和集群内部的 DNS 表项。 首先,查看 Pod 的主机名:

for i in 0 1; do kubectl exec web-$i -- sh -c 'hostname'; done

web-0 
web-1

        然后,运行:

kubectl run -i --tty --image busybox:1.28 dns-test --restart=Never --rm /bin/sh

        这将启动一个新的 Shell。在新 Shell 中,运行:

# 在 dns-test 容器 Shell 中运行以下命令 
nslookup web-0.nginx

        输出类似于:

Server: 10.0.0.10 
Address 1: 10.0.0.10 kube-dns.kube-system.svc.cluster.local 

Name: web-0.nginx 
Address 1: 10.244.1.7 

nslookup web-1.nginx 
Server: 10.0.0.10 
Address 1: 10.0.0.10 kube-dns.kube-system.svc.cluster.local 

Name: web-1.nginx 
Address 1: 10.244.2.8

(现在可以退出容器 Shell:exit)

        Pod 的序号、主机名、SRV 条目和记录名称没有改变,但和 Pod 相关联的 IP 地址可能发生了改变。 在本教程中使用的集群中它们就改变了。这就是为什么不要在其他应用中使用 StatefulSet 中 Pod 的 IP 地址进行连接,这点很重要。

        如果你需要查找并连接一个 StatefulSet 的活动成员,你应该查询 Headless Service 的 CNAME。 和 CNAME 相关联的 SRV 记录只会包含 StatefulSet 中处于 Running 和 Ready 状态的 Pod。

        如果你的应用已经实现了用于测试是否已存活(liveness)并就绪(readiness)的连接逻辑, 你可以使用 Pod 的 SRV 记录(web-0.nginx.default.svc.cluster.local、 web-1.nginx.default.svc.cluster.local)。因为它们是稳定的,并且当你的 Pod 的状态变为 Running 和 Ready 时,你的应用就能够发现它们的地址。

2.3.3 写入稳定的存储

        获取 web-0 和 web-1 的 PersistentVolumeClaims:

kubectl get pvc -l app=nginx

        输出类似于:

NAME      STATUS     VOLUME                               CAPACITY ACCESSMODES AGE 
www-web-0 Bound  pvc-15c268c7-b507-11e6-932f-42010a800002    1Gi       RWO     48s 
www-web-1 Bound  pvc-15c79307-b507-11e6-932f-42010a800002    1Gi       RWO     48s

        StatefulSet 控制器创建了两个 PersistentVolumeClaims, 绑定到两个 PersistentVolumes

        由于本教程使用的集群配置为动态制备 PersistentVolume 卷,所有的 PersistentVolume 卷都是自动创建和绑定的。

        NginX Web 服务器默认会加载位于 /usr/share/nginx/html/index.html 的 index 文件。 StatefulSet spec 中的 volumeMounts 字段保证了 /usr/share/nginx/html 文件夹由一个 PersistentVolume 卷支持。

        将 Pod 的主机名写入它们的 index.html 文件并验证 NginX Web 服务器使用该主机名提供服务:

for i in 0 1; do kubectl exec "web-$i" -- sh -c 'echo "$(hostname)" > /usr/share/nginx/html/index.html'; done 
for i in 0 1; do kubectl exec -i -t "web-$i" -- curl http://localhost/; done

web-0 
web-1

说明:

        请注意,如果你看见上面的 curl 命令返回了 403 Forbidden 的响应,你需要像这样修复使用 volumeMounts (原因归咎于使用 hostPath 卷时存在的缺陷) 挂载的目录的权限,先运行:

for i in 0 1; do kubectl exec web-$i -- chmod 755 /usr/share/nginx/html; done

        再重新尝试上面的 curl 命令。

        在一个终端监视 StatefulSet 的 Pod:

kubectl get pod -w -l app=nginx

        在另一个终端删除 StatefulSet 所有的 Pod:

kubectl delete pod -l app=nginx

pod "web-0" deleted 
pod "web-1" deleted

        在第一个终端里检查 kubectl get 命令的输出,等待所有 Pod 变成 Running 和 Ready 状态。

kubectl get pod -w -l app=nginx

NAME  READY     STATUS         RESTARTS AGE 
web-0  0/1  ContainerCreating     0     0s 

NAME  READY STATUS            RESTARTS AGE 
web-0  1/1  Running              0     2s 
web-1  0/1  Pending              0     0s 
web-1  0/1  Pending              0     0s 
web-1  0/1  ContainerCreating    0     0s 
web-1  1/1  Running              0     34s

        验证所有 Web 服务器在继续使用它们的主机名提供服务:

for i in 0 1; do kubectl exec -i -t "web-$i" -- curl http://localhost/; done

web-0 
web-1

        虽然 web-0 和 web-1 被重新调度了,但它们仍然继续监听各自的主机名,因为和它们的 PersistentVolumeClaim 相关联的 PersistentVolume 卷被重新挂载到了各自的 volumeMount 上。 不管 web-0 和 web-1 被调度到了哪个节点上,它们的 PersistentVolume 卷将会被挂载到合适的挂载点上。

2.4 扩容/缩容 StatefulSet

        扩容/缩容 StatefulSet 指增加或减少它的副本数。这通过更新 replicas 字段完成。 你可以使用 kubectl scale 或者 kubectl patch 来扩容/缩容一个 StatefulSet。

2.4.1 扩容

        在一个终端窗口监视 StatefulSet 的 Pod:

kubectl get pods -w -l app=nginx

        在另一个终端窗口使用 kubectl scale 扩展副本数为 5:

kubectl scale sts web --replicas=5

statefulset.apps/web scaled

        在第一个 终端中检查 kubectl get 命令的输出,等待增加的 3 个 Pod 的状态变为 Running 和 Ready。

kubectl get pods -w -l app=nginx

NAME READY STATUS RESTARTS AGE 
web-0 1/1 Running 0 2h 
web-1 1/1 Running 0 2h 

NAME  READY STATUS            RESTARTS AGE 
web-2  0/1  Pending              0     0s 
web-2  0/1  Pending              0     0s 
web-2  0/1  ContainerCreating    0     0s 
web-2  1/1  Running              0     19s 
web-3  0/1  Pending              0     0s 
web-3  0/1  Pending              0     0s 
web-3  0/1  ContainerCreating    0     0s 
web-3  1/1  Running              0     18s 
web-4  0/1  Pending              0     0s 
web-4  0/1  Pending              0     0s 
web-4  0/1  ContainerCreating    0     0s 
web-4  1/1  Running              0     19s

        StatefulSet 控制器扩展了副本的数量。 如同创建 StatefulSet 所述,StatefulSet 按序号索引顺序创建各个 Pod,并且会等待前一个 Pod 变为 Running 和 Ready 才会启动下一个 Pod。

2.4.2 缩容

        在一个终端监视 StatefulSet 的 Pod:

kubectl get pods -w -l app=nginx

        在另一个终端使用 kubectl patch 将 StatefulSet 缩容回三个副本:

kubectl patch sts web -p '{"spec":{"replicas":3}}'

statefulset.apps/web patched

        等待 web-4 和 web-3 状态变为 Terminating。

kubectl get pods -w -l app=nginx

NAME  READY STATUS            RESTARTS AGE 
web-0  1/1  Running              0     3h 
web-1  1/1  Running              0     3h 
web-2  1/1  Running              0     55s 
web-3  1/1  Running              0     36s 
web-4  0/1  ContainerCreating    0     18s 

NAME  READY STATUS      RESTARTS AGE 
web-4  1/1  Running        0     19s 
web-4  1/1  Terminating    0     24s 
web-4  1/1  Terminating    0     24s 
web-3  1/1  Terminating    0     42s 
web-3  1/1  Terminating    0     42s

2.4.3 顺序终止 Pod

        控制器会按照与 Pod 序号索引相反的顺序每次删除一个 Pod。在删除下一个 Pod 前会等待上一个被完全关闭。

        获取 StatefulSet 的 PersistentVolumeClaims:

kubectl get pvc -l app=nginx

NAME      STATUS                 VOLUME                    CAPACITY ACCESSMODES AGE 
www-web-0 Bound  pvc-15c268c7-b507-11e6-932f-42010a800002     1Gi        RWO    13h
www-web-1 Bound  pvc-15c79307-b507-11e6-932f-42010a800002     1Gi        RWO    13h 
www-web-2 Bound  pvc-e1125b27-b508-11e6-932f-42010a800002     1Gi        RWO    13h 
www-web-3 Bound  pvc-e1176df6-b508-11e6-932f-42010a800002     1Gi        RWO    13h 
www-web-4 Bound  pvc-e11bb5f8-b508-11e6-932f-42010a800002     1Gi        RWO    13h

        五个 PersistentVolumeClaims 和五个 PersistentVolume 卷仍然存在。 查看 Pod 的稳定存储,我们发现当删除 StatefulSet 的 Pod 时,挂载到 StatefulSet 的 Pod 的 PersistentVolume 卷不会被删除。 当这种删除行为是由 StatefulSet 缩容引起时也是一样的。

2.5 更新 StatefulSet

        从 Kubernetes 1.7 版本开始,StatefulSet 控制器支持自动更新。 更新策略由 StatefulSet API 对象的 spec.updateStrategy 字段决定。这个特性能够用来更新一个 StatefulSet 中 Pod 的的容器镜像、资源请求和限制、标签和注解。

        RollingUpdate 更新策略是 StatefulSet 默认策略。

2.5.1 滚动更新

        RollingUpdate 更新策略会更新一个 StatefulSet 中的所有 Pod,采用与序号索引相反的顺序并遵循 StatefulSet 的保证。

        对 web StatefulSet 应用 Patch 操作来应用 RollingUpdate 更新策略:

kubectl patch statefulset web -p '{"spec":{"updateStrategy":{"type":"RollingUpdate"}}}'

statefulset.apps/web patched

        在一个终端窗口中对 web StatefulSet 执行 patch 操作来再次改变容器镜像:

kubectl patch statefulset web --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"gcr.io/google_containers/nginx-slim:0.8"}]'

statefulset.apps/web patched

        在另一个终端监控 StatefulSet 中的 Pod:

kubectl get pod -l app=nginx -w

        输出类似于:

NAME  READY STATUS           RESTARTS AGE 
web-0  1/1  Running             0     7m 
web-1  1/1  Running             0     7m 
web-2  1/1  Running             0     8m 
web-2  1/1  Terminating         0     8m 
web-2  1/1  Terminating         0     8m 
web-2  0/1  Terminating         0     8m 
web-2  0/1  Terminating         0     8m 
web-2  0/1  Terminating         0     8m 
web-2  0/1  Terminating         0     8m 
web-2  0/1  Pending             0     0s 
web-2  0/1  Pending             0     0s 
web-2  0/1  ContainerCreating   0     0s 
web-2  1/1  Running             0     19s 
web-1  1/1  Terminating         0     8m 
web-1  0/1  Terminating         0     8m 
web-1  0/1  Terminating         0     8m 
web-1  0/1  Terminating         0     8m 
web-1  0/1  Pending             0     0s 
web-1  0/1  Pending             0     0s 
web-1  0/1  ContainerCreating   0     0s 
web-1  1/1  Running             0     6s 
web-0  1/1  Terminating         0     7m 
web-0  1/1  Terminating         0     7m 
web-0  0/1  Terminating         0     7m 
web-0  0/1  Terminating         0     7m 
web-0  0/1  Terminating         0     7m 
web-0  0/1  Terminating         0     7m 
web-0  0/1  Pending             0     0s 
web-0  0/1  Pending             0     0s 
web-0  0/1  ContainerCreating   0     0s 
web-0  1/1  Running             0     10s

        StatefulSet 里的 Pod 采用和序号相反的顺序更新。在更新下一个 Pod 前,StatefulSet 控制器终止每个 Pod 并等待它们变成 Running 和 Ready。 请注意,虽然在顺序后继者变成 Running 和 Ready 之前 StatefulSet 控制器不会更新下一个 Pod,但它仍然会重建任何在更新过程中发生故障的 Pod,使用的是它们当前的版本。

        已经接收到更新请求的 Pod 将会被恢复为更新的版本,没有收到请求的 Pod 则会被恢复为之前的版本。 像这样,控制器尝试继续使应用保持健康并在出现间歇性故障时保持更新的一致性。

        获取 Pod 来查看它们的容器镜像:

for p in 0 1 2; do kubectl get pod "web-$p" --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}'; echo; done

registry.k8s.io/nginx-slim:0.8 
registry.k8s.io/nginx-slim:0.8 
registry.k8s.io/nginx-slim:0.8

        StatefulSet 中的所有 Pod 现在都在运行之前的容器镜像。说明:

        你还可以使用 kubectl rollout status sts/ 来查看 StatefulSet 的滚动更新状态。

2.5.1.1 分段更新

        你可以使用 RollingUpdate 更新策略的 partition 参数来分段更新一个 StatefulSet。 分段的更新将会使 StatefulSet 中的其余所有 Pod 保持当前版本的同时允许改变 StatefulSet的 .spec.template。

        对 web StatefulSet 执行 Patch 操作为 updateStrategy 字段添加一个分区:

kubectl patch statefulset web -p '{"spec":{"updateStrategy":{"type":"RollingUpdate","rollingUpdate":{"partition":3}}}}'

statefulset.apps/web patched

        再次 Patch StatefulSet 来改变容器镜像:

kubectl patch statefulset web --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"registry.k8s.io/nginx-slim:0.7"}]'

statefulset.apps/web patched

        删除 StatefulSet 中的 Pod:

kubectl delete pod web-2

pod "web-2" deleted

        等待 Pod 变成 Running 和 Ready。

kubectl get pod -l app=nginx -w

NAME  READY STATUS            RESTARTS AGE 
web-0  1/1  Running               0    4m 
web-1  1/1  Running               0    4m 
web-2  0/1  ContainerCreating     0    11s 
web-2  1/1  Running               0    18s

        获取 Pod 的容器镜像:

kubectl get pod web-2 --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}'

registry.k8s.io/nginx-slim:0.8

        请注意,虽然更新策略是 RollingUpdate,StatefulSet 还是会使用原始的容器恢复 Pod。 这是因为 Pod 的序号比 updateStrategy 指定的 partition 更小。

2.5.1.2 金丝雀发布

        你可以通过减少上文指定的 partition 来进行金丝雀发布,以此来测试你的程序的改动。

        通过 patch 命令修改 StatefulSet 来减少分区:

kubectl patch statefulset web -p '{"spec":{"updateStrategy":{"type":"RollingUpdate","rollingUpdate":{"partition":2}}}}'

statefulset.apps/web patched

        等待 web-2 变成 Running 和 Ready。

kubectl get pod -l app=nginx -w

NAME  READY STATUS             RESTARTS AGE 
web-0  1/1  Running               0     4m 
web-1  1/1  Running               0     4m 
web-2  0/1  ContainerCreating     0     11s 
web-2  1/1  Running               0     18s

        获取 Pod 的容器:

kubectl get pod web-2 --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}'

registry.k8s.io/nginx-slim:0.7

        当你改变 partition 时,StatefulSet 会自动更新 web-2 Pod,这是因为 Pod 的序号大于或等于 partition。

        删除 web-1 Pod:

kubectl delete pod web-1

pod "web-1" deleted

        等待 web-1 变成 Running 和 Ready。

kubectl get pod -l app=nginx -w

        输出类似于:

NAME  READY STATUS           RESTARTS AGE 
web-0  1/1  Running             0     6m 
web-1  0/1  Terminating         0     6m 
web-2  1/1  Running             0     2m 
web-1  0/1  Terminating         0     6m 
web-1  0/1  Terminating         0     6m 
web-1  0/1  Terminating         0     6m 
web-1  0/1  Pending             0     0s 
web-1  0/1  Pending             0     0s 
web-1  0/1  ContainerCreating   0     0s 
web-1  1/1  Running             0     18s

        获取 web-1 Pod 的容器镜像:

kubectl get pod web-1 --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}'

registry.k8s.io/nginx-slim:0.8

        web-1 被按照原来的配置恢复,因为 Pod 的序号小于分区。当指定了分区时,如果更新了 StatefulSet 的 .spec.template,则所有序号大于或等于分区的 Pod 都将被更新。 如果一个序号小于分区的 Pod 被删除或者终止,它将被按照原来的配置恢复。

2.5.1.3 分阶段的发布

        你可以使用类似金丝雀发布的方法执行一次分阶段的发布 (例如一次线性的、等比的或者指数形式的发布)。 要执行一次分阶段的发布,你需要设置 partition 为希望控制器暂停更新的序号。

        分区当前为 2。请将分区设置为 0:

kubectl patch statefulset web -p '{"spec":{"updateStrategy":{"type":"RollingUpdate","rollingUpdate":{"partition":0}}}}'

statefulset.apps/web patched

        等待 StatefulSet 中的所有 Pod 变成 Running 和 Ready。

kubectl get pod -l app=nginx -w

        输出类似于:

NAME  READY STATUS            RESTARTS AGE 
web-0  1/1  Running               0    3m 
web-1  0/1  ContainerCreating     0    11s 
web-2  1/1  Running               0    2m 
web-1  1/1  Running               0    18s 
web-0  1/1  Terminating           0    3m 
web-0  1/1  Terminating           0    3m 
web-0  0/1  Terminating           0    3m 
web-0  0/1  Terminating           0    3m 
web-0  0/1  Terminating           0    3m 
web-0  0/1  Terminating           0    3m 
web-0  0/1  Pending               0    0s 
web-0  0/1  Pending               0    0s 
web-0  0/1  ContainerCreating     0    0s 
web-0  1/1  Running               0    3s

        获取 StatefulSet 中 Pod 的容器镜像详细信息:

for p in 0 1 2; do kubectl get pod "web-$p" --template '{{range $i, $c := .spec.containers}}{{$c.image}}{{end}}'; echo; done

registry.k8s.io/nginx-slim:0.7 
registry.k8s.io/nginx-slim:0.7 
registry.k8s.io/nginx-slim:0.7

        将 partition 改变为 0 以允许 StatefulSet 继续更新过程。

2.5.2 OnDelete 策略

        OnDelete 更新策略实现了传统(1.7 之前)行为,它也是默认的更新策略。 当你选择这个更新策略并修改 StatefulSet 的 .spec.template 字段时,StatefulSet 控制器将不会自动更新 Pod。

2.6 删除 StatefulSet

        StatefulSet 同时支持级联和非级联删除。使用非级联方式删除 StatefulSet 时,StatefulSet 的 Pod 不会被删除。使用级联删除时,StatefulSet 和它的 Pod 都会被删除。

2.6.1 非级联删除

        在一个终端窗口监视 StatefulSet 中的 Pod。

kubectl get pods -w -l app=nginx

        使用 kubectl delete 删除 StatefulSet。请确保提供了 --cascade=orphan 参数给命令。这个参数告诉 Kubernetes 只删除 StatefulSet 而不要删除它的任何 Pod。

kubectl delete statefulset web --cascade=orphan

statefulset.apps "web" deleted

        获取 Pod 来检查它们的状态:

kubectl get pods -l app=nginx

NAME  READY STATUS  RESTARTS AGE 
web-0  1/1  Running    0     6m 
web-1  1/1  Running    0     7m 
web-2  1/1  Running    0     5m

        虽然 web 已经被删除了,但所有 Pod 仍然处于 Running 和 Ready 状态。 删除 web-0:

kubectl delete pod web-0

pod "web-0" deleted

        获取 StatefulSet 的 Pod:

kubectl get pods -l app=nginx

NAME  READY STATUS  RESTARTS AGE 
web-1  1/1  Running    0     10m 
web-2  1/1  Running    0     7m

        由于 web StatefulSet 已经被删除,web-0 没有被重新启动。

        在一个终端监控 StatefulSet 的 Pod。

kubectl get pods -w -l app=nginx

        在另一个终端里重新创建 StatefulSet。请注意,除非你删除了 nginx Service(你不应该这样做),你将会看到一个错误,提示 Service 已经存在。

kubectl apply -f web.yaml

statefulset.apps/web created 
service/nginx unchanged

        请忽略这个错误。它仅表示 kubernetes 进行了一次创建 nginx headless Service 的尝试,尽管那个 Service 已经存在。

        在第一个终端中运行并检查 kubectl get 命令的输出。

kubectl get pods -w -l app=nginx

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

NAME  READY STATUS            RESTARTS AGE 
web-0  0/1  Pending               0    0s 
web-0  0/1  Pending 0 0s 
web-0  0/1  ContainerCreating     0    0s 
web-0  1/1  Running               0    18s 
web-2  1/1  Terminating           0    3m 
web-2  0/1  Terminating           0    3m 
web-2  0/1  Terminating           0    3m 
web-2  0/1  Terminating           0    3m

        当重新创建 web StatefulSet 时,web-0 被第一个重新启动。 由于 web-1 已经处于 Running 和 Ready 状态,当 web-0 变成 Running 和 Ready 时, StatefulSet 会接收这个 Pod。由于你重新创建的 StatefulSet 的 replicas 等于 2, 一旦 web-0 被重新创建并且 web-1 被认为已经处于 Running 和 Ready 状态时,web-2 将会被终止。

        让我们再看看被 Pod 的 Web 服务器加载的 index.html 的内容:

for i in 0 1; do kubectl exec -i -t "web-$i" -- curl http://localhost/; done

web-0 
web-1

        尽管你同时删除了 StatefulSet 和 web-0 Pod,但它仍然使用最初写入 index.html 文件的主机名进行服务。 这是因为 StatefulSet 永远不会删除和一个 Pod 相关联的 PersistentVolume 卷。 当你重建这个 StatefulSet 并且重新启动了 web-0 时,它原本的 PersistentVolume 卷会被重新挂载。

2.6.2 级联删除

        在一个终端窗口监视 StatefulSet 里的 Pod。

kubectl get pods -w -l app=nginx

        在另一个窗口中再次删除这个 StatefulSet。这次省略 --cascade=orphan 参数。

kubectl delete statefulset web

statefulset.apps "web" deleted

        在第一个终端检查 kubectl get 命令的输出,并等待所有的 Pod 变成 Terminating 状态。

kubectl get pods -w -l app=nginx

NAME  READY STATUS  RESTARTS AGE 
web-0  1/1  Running    0     11m 
web-1  1/1  Running    0     27m 

NAME  READY STATUS      RESTARTS AGE 
web-0  1/1  Terminating     0    12m 
web-1  1/1  Terminating     0    29m 
web-0  0/1  Terminating     0    12m 
web-0  0/1  Terminating     0    12m 
web-0  0/1  Terminating     0    12m 
web-1  0/1  Terminating     0    29m 
web-1  0/1  Terminating     0    29m 
web-1  0/1  Terminating     0    29m

        如同你在缩容章节看到的,这些 Pod 按照与其序号索引相反的顺序每次终止一个。 在终止一个 Pod 前,StatefulSet 控制器会等待 Pod 后继者被完全终止。说明:

        尽管级联删除会删除 StatefulSet 及其 Pod,但级联不会删除与 StatefulSet 关联的 Headless Service。你必须手动删除 nginx Service。

kubectl delete service nginx

service "nginx" deleted

        再一次重新创建 StatefulSet 和 headless Service:

kubectl apply -f web.yaml

service/nginx created 
statefulset.apps/web created

        当 StatefulSet 所有的 Pod 变成 Running 和 Ready 时,获取它们的 index.html 文件的内容:

for i in 0 1; do kubectl exec -i -t "web-$i" -- curl http://localhost/; done

web-0 
web-1

        即使你已经删除了 StatefulSet 和它的全部 Pod,这些 Pod 将会被重新创建并挂载它们的 PersistentVolume 卷,并且 web-0 和 web-1 将继续使用它的主机名提供服务。

        最后删除 nginx service

kubectl delete service nginx

service "nginx" deleted

        并且删除 web StatefulSet:

kubectl delete statefulset web

statefulset "web" deleted

2.7 Pod 管理策略

        对于某些分布式系统来说,StatefulSet 的顺序性保证是不必要和/或者不应该的。 这些系统仅仅要求唯一性和身份标志。为了解决这个问题,在 Kubernetes 1.7 中 我们针对 StatefulSet API 对象引入了 .spec.podManagementPolicy。 此选项仅影响扩缩操作的行为。更新不受影响。

2.7.1 OrderedReady Pod 管理策略

        OrderedReady Pod 管理策略是 StatefulSet 的默认选项。它告诉 StatefulSet 控制器遵循上文展示的顺序性保证。

2.7.2 Parallel Pod 管理策略

        Parallel Pod 管理策略告诉 StatefulSet 控制器并行的终止所有 Pod, 在启动或终止另一个 Pod 前,不必等待这些 Pod 变成 Running 和 Ready 或者完全终止状态。application/web/web-parallel.yaml 

apiVersion: v1 
kind: Service 
metadata: 
  name: nginx 
  labels: 
    app: nginx 
spec: 
  ports: 
    - port: 80 
      name: web 
  clusterIP: None 
  selector: 
    app: nginx 

--- 
apiVersion: apps/v1 
kind: StatefulSet 
metadata: 
  name: web 
spec: 
  serviceName: "nginx" 
  podManagementPolicy: "Parallel" 
  replicas: 2 
  selector: 
    matchLabels: 
      app: nginx 
  template: 
    metadata: 
      labels: 
        app: nginx 
    spec: 
      containers: 
        - name: nginx 
          image: registry.k8s.io/nginx-slim:0.8 
          ports: 
            - containerPort: 80 
              name: web 
          volumeMounts: 
            - name: www 
              mountPath: /usr/share/nginx/html 
  volumeClaimTemplates: 
    - metadata: 
      name: www 
      spec: 
        accessModes: [ "ReadWriteOnce" ] 
        resources: 
          requests: 
            storage: 1Gi

        下载上面的例子并保存为 web-parallel.yaml。

        这份清单和你在上文下载的完全一样,只是 web StatefulSet 的 .spec.podManagementPolicy 设置成了 Parallel。

        在一个终端窗口监视 StatefulSet 中的 Pod。

kubectl get pod -l app=nginx -w

        在另一个终端窗口创建清单中的 StatefulSet 和 Service:

kubectl apply -f web-parallel.yaml

service/nginx created 
statefulset.apps/web created

        查看你在第一个终端中运行的 kubectl get 命令的输出。

kubectl get pod -l app=nginx -w

NAME  READY STATUS            RESTARTS AGE 
web-0  0/1  Pending              0     0s 
web-0  0/1  Pending              0     0s 
web-1  0/1  Pending              0     0s 
web-1  0/1  Pending              0     0s 
web-0  0/1  ContainerCreating    0     0s 
web-1  0/1  ContainerCreating    0     0s 
web-0  1/1  Running              0     10s 
web-1  1/1  Running              0     10s

        StatefulSet 控制器同时启动了 web-0 和 web-1。

        保持第二个终端打开,并在另一个终端窗口中扩容 StatefulSet:

kubectl scale statefulset/web --replicas=4

statefulset.apps/web scaled

        在 kubectl get 命令运行的终端里检查它的输出。

web-3 0/1 Pending 0 0s 
web-3 0/1 Pending 0 0s 
web-3 0/1 Pending 0 7s 
web-3 0/1 ContainerCreating 0 7s 
web-2 1/1 Running 0 10s 
web-3 1/1 Running 0 26s

        StatefulSet 启动了两个新的 Pod,而且在启动第二个之前并没有等待第一个变成 Running 和 Ready 状态。

2.8 清理现场

        你应该打开两个终端,准备在清理过程中运行 kubectl 命令。

kubectl delete sts web 
# sts is an abbreviation for statefulset

        你可以监视 kubectl get 来查看那些 Pod 被删除

kubectl get pod -l app=nginx -w

web-3 1/1 Terminating 0 9m 
web-2 1/1 Terminating 0 9m 
web-3 1/1 Terminating 0 9m 
web-2 1/1 Terminating 0 9m 
web-1 1/1 Terminating 0 44m 
web-0 1/1 Terminating 0 44m 
web-0 0/1 Terminating 0 44m 
web-3 0/1 Terminating 0 9m 
web-2 0/1 Terminating 0 9m 
web-1 0/1 Terminating 0 44m 
web-0 0/1 Terminating 0 44m 
web-2 0/1 Terminating 0 9m 
web-2 0/1 Terminating 0 9m 
web-2 0/1 Terminating 0 9m 
web-1 0/1 Terminating 0 44m 
web-1 0/1 Terminating 0 44m 
web-1 0/1 Terminating 0 44m 
web-0 0/1 Terminating 0 44m 
web-0 0/1 Terminating 0 44m 
web-0 0/1 Terminating 0 44m 
web-3 0/1 Terminating 0 9m 
web-3 0/1 Terminating 0 9m 
web-3 0/1 Terminating 0 9m

        在删除过程中,StatefulSet 将并发的删除所有 Pod,在删除一个 Pod 前不会等待它的顺序后继者终止。

        关闭 kubectl get 命令运行的终端并删除 nginx Service:

kubectl delete svc nginx

说明:

        你需要删除本教程中用到的 PersistentVolume 卷的持久化存储介质。

        基于你的环境、存储配置和制备方式,按照必需的步骤保证回收所有的存储。

参考链接

StatefulSet 基础 | Kubernetes

示例:使用 StatefulSet 部署 Cassandra | Kubernetes

运行一个有状态的应用程序 | Kubernetes

Statefulset详细解析 - 不懂123 - 博客园

k8s中statefulset资源类型的深入理解

十,StatefulSet简介及简单使用 - 戴红领巾的少年 - 博客园

k8s之StatefulSet详解_最美dee时光的博客-CSDN博客_statefulset

  • 1
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

江中散人

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值