tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
容器服务
    文档
    Download PDF

    StatefulSet 管理

    最后更新时间：2024-12-19 22:09:58
    下载PDF

      简介

      StatefulSet 主要用于管理有状态的应用，可以创建具有持久性标识符的 Pod。Pod 迁移或销毁重启后，标识符仍会保留。在需要持久化存储时，您可以通过标识符对存储卷进行一一对应。如果应用程序不需要持久的标识符，建议您使用 Deployment 部署应用程序。

      StatefulSet 控制台操作指引

      创建 StatefulSet

      1. 登录容器服务控制台，选择左侧导航栏中的 集群 。
      2. 单击需要创建 StatefulSet 的集群 ID，进入待创建 StatefulSet 的集群管理页面。
      3. 选择工作负载 > StatefulSet，进入 StatefulSet 管理页面。如下图所示：
      
      
      
      4. 单击新建，进入新建 StatefulSet 页面。 根据实际需求，设置 StatefulSet 参数。关键参数信息如下：
      工作负载名：输入自定义名称。
      标签：一个键 - 值对（Key-Value），用于对资源进行分类管理。
      命名空间：根据实际需求进行选择。
      类型：选择 StatefulSet（有状态集的运行 Pod）。
      数据卷（选填）：为容器提供存储，目前支持临时路径、主机路径、云硬盘数据卷、文件存储 NFS、配置文件、PVC，还需挂载到容器的指定路径中。
      实例内容器：根据实际需求，为 StatefulSet 的一个 Pod 设置一个或多个不同的容器。
      名称：自定义。
      镜像：根据实际需求进行选择。
      镜像版本（Tag）：根据实际需求进行填写。
      镜像拉取策略：提供以下3种策略，请按需选择。若不设置镜像拉取策略，当镜像版本为空或 latest 时，使用 Always 策略，否则使用 IfNotPresent 策略。
      Always：总是从远程拉取该镜像。
      IfNotPresent：默认使用本地镜像，若本地无该镜像则远程拉取该镜像。
      Never：只使用本地镜像，若本地没有该镜像将报异常。
      CPU/内存限制：可根据 Kubernetes 资源限制 进行设置 CPU 和内存的限制范围，提高业务的健壮性。
      GPU 资源：配置该工作负载使用的最少 GPU 资源。
      高级设置：可设置 “工作目录”、“运行命令”、“运行参数”、“容器健康检查”和“特权级”等参数。
      镜像访问凭证：容器镜像默认私有，在创建工作负载时，需选择实例对应的镜像访问凭证。
      实例数量：根据实际需求选择调节方式，设置实例数量。
      节点调度策略：可根据调度规则，将 Pod 调度到符合预期的 Label 的节点中。
      访问设置：根据实际需求，设置 Service 参数。详情见 服务访问方式。
      5. 单击创建 StatefulSet，完成创建。

      更新 StatefulSet

      更新 YAML

      1. 登录容器服务控制台，选择左侧导航栏中的 集群 。
      2. 单击需要更新 YAML 的集群 ID，进入待更新 YAML 的集群管理页面。
      3. 选择工作负载 > StatefulSet，进入 StatefulSet 信息页面。如下图所示：
      
      
      
      4. 在需要更新 YAML 的 StatefulSet 行中，选择更多 > 编辑 YAML，进入更新 StatefulSet 页面。
      5. 在更新 StatefulSet 页面编辑 YAML，并单击完成即可更新 YAML。

      更新 Pod 配置

      1. 在集群管理页面，单击需要更新 Pod 配置的 StatefulSet 的集群 ID，进入待更新 Pod 配置的 StatefulSet 的集群管理页面。
      2. 在需要更新 Pod 配置的 StatefulSet 行中，单击更新 Pod 配置。如下图所示：
      
      
      
      3. 在更新 Pod 配置页面，根据实际需求修改更新方式，设置参数。如下图所示：
      
      
      
      4. 单击完成，即可更新 Pod 配置。

      Kubectl 操作 StatefulSet 指引

      YAML 示例

      apiVersion: v1
      kind: Service  ## 创建一个 Headless Service，用于控制网络域
      metadata:
        name: nginx
        namespace: default
        labels:
          app: nginx
      spec:
        ports:
        - port: 80
          name: web
        clusterIP: None
        selector:
          app: nginx
      ---
      apiVersion: apps/v1
      kind: StatefulSet ### 创建一个 Nginx的StatefulSet
      metadata:
        name: web
        namespace: default
      spec:
        selector:
          matchLabels:
            app: nginx
        serviceName: "nginx"
        replicas: 3 # by default is 1
        template:
          metadata:
            labels:
              app: nginx
          spec:
            terminationGracePeriodSeconds: 10
            containers:
            - name: nginx
              image: nginx:latest
              ports:
              - containerPort: 80
                name: web
              volumeMounts:
              - name: www
                mountPath: /usr/share/nginx/html
        volumeClaimTemplates:
        - metadata:
            name: www
          spec:
            accessModes: [ "ReadWriteOnce" ]
            storageClassName: "cbs"
            resources:
              requests:
                storage: 10Gi
      kind：标识 StatefulSet 资源类型。
      metadata：StatefulSet 的名称、Label等基本信息。
      metadata.annotations：对 StatefulSet 的额外说明，可通过该参数设置腾讯云 TKE 的额外增强能力。
      spec.template：StatefulSet 管理的 Pod 的详细模板配置。
      spec.volumeClaimTemplates：提供创建 PVC&PV 的模板。
      更多参数详情可查看 Kubernetes StatefulSet 官方文档。

      创建 StatefulSet

      1. 参考 YAML 示例，准备 StatefulSet YAML 文件。
      2. 安装 Kubectl，并连接集群。操作详情请参考 通过 Kubectl 连接集群。
      3. 执行以下命令，创建 StatefulSet YAML 文件。
      kubectl create -f StatefulSet YAML 文件名称
      例如，创建一个文件名为 web.yaml 的 StatefulSet YAML 文件，则执行以下命令：
      kubectl create -f web.yaml
      4. 执行以下命令，验证创建是否成功。
      kubectl get StatefulSet
      返回类似以下信息，即表示创建成功。
      NAME      DESIRED   CURRENT   AGE
      test      1         1         10s

      更新 StatefulSet

      执行以下命令，查看 StatefulSet 的更新策略类型。
      kubectl get ds/<daemonset-name> -o go-template='{{.spec.updateStrategy.type}}{{"\\n"}}'
      StatefulSet 有以下两种更新策略类型：
      OnDelete：默认更新策略。该更新策略在更新 StatefulSet 后，需手动删除旧的 StatefulSet Pod 才会创建新的 StatefulSet Pod。
      RollingUpdate：支持 Kubernetes 1.7或更高版本。该更新策略在更新 StatefulSet 模板后，旧的 StatefulSet Pod 将被终止，并且以滚动更新方式创建新的 StatefulSet Pod（Kubernetes 1.7或更高版本）。

      方法一

      执行以下命令，更新 StatefulSet。
      kubectl edit StatefulSet/[name]
      此方法适用于简单的调试验证，不建议在生产环境中直接使用。您可以通过此方法更新任意的 StatefulSet 参数。

      方法二

      执行以下命令，更新指定容器的镜像。
      kubectl patch statefulset <NAME> --type='json' -p='[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value":"<newImage>"}]'
      建议保持 StatefulSet 的其他参数不变，业务更新时，仅更新容器镜像。
      如果更新的 StatefulSet 是滚动更新方式的策略，可执行以下命令查看更新状态：
      kubectl rollout status sts/<StatefulSet-name>

      删除 StatefulSet

      执行以下命令，删除 StatefulSet。
      kubectl delete  StatefulSet [NAME] --cascade=false
      --cascade=false 参数表示 Kubernetes 仅删除 StatefulSet，且不删除任何 Pod。如需删除 Pod，则执行以下命令：
      kubectl delete  StatefulSet [NAME]
      更多 StatefulSet 相关操作可查看 Kubernetes官方指引。
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2025 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款