概述

在运行中会保存数据或状态的工作负载称为有状态负载 ，对应 Kubernetes 中的 StatefulSet，例如 MySQL，它在运行中会保存产生的数据。用户可以通过表单方式基于镜像创建有状态部署，也可以通过百度智能云提供的YAML文件模板创建和修改有状态部署，对有状态部署关联的容器组（Pod）、事件等进行控制管理。

StatefulSet 介绍

与Deployment相似，StatefulSet也会保证有既定数量的Pod在正常运行。但不同的是，StatefulSet会通过以下措施保留Pod的身份：

• 有序、固定的名称：StatefulSet的每个Pod会按顺序命名为<StatefulSet名称>-<序号>。例如，StatefulSet的名称为db-app，则Pod名称为db-app-0、db-app-1。删除并重建Pod时，新建Pod会继承原有的名称。
• 稳定的网络标识：StatefulSet通常需要关联一个Headless Service（通过spec.serviceName指定）。这个Headless Service并不像ClusterIP提供Pod的负载均衡，而仅用于为Pod提供固定的域名（对Headless Service进行DNS查询时，DNS会返回所有匹配的Pod的IP地址）。指定Headless Service后，Pod的域名格式为<Pod名称>.<Headless Service名称>..svc.，例如db-app-01.db-app.default.svc.cluster.local。Pod重建后，域名会自动被解析到新Pod。
• 稳定的持久化存储：在StatefulSet中，可以指定PVC模板（通过spec.volumeClaimTemplates指定）。StatefulSet会根据此模板为每个Pod生成独立的PersistentVolumeClaim（PVC），PVC名称为<PVC模板名称>-<Pod名称>。当Pod被删除时，PVC会被保留并自动关联到使用相同序号的新Pod。

以上的这些措施保证了StatefulSet的Pod在重建后能继承原有的网络和存储状态，使应用从持久化数据中恢复运行。关于StatefulSet的更多信息，请参见官方文档。

前提条件

• 已成功创建 CCE 集群，操作说明参见 创建 CCE 集群。

创建有状态工作负载 StatefulSet

用户可以选择通过 CCE 控制台使用表单形式或者通过 YAML 形式创建新的有状态工作负载，也可以选择通过 kubectl 命令创建。

通过控制台表单形式创建

1. 登录有状态负载管理页面。

   a. 登录 容器引擎CCE控制台。
   b. 在左侧导航栏，点击 "集群管理->集群列表"，进入集群列表页，点击集群名称，进入集群管理页面。
   c. 在集群管理页面的左侧导航栏中，单击 工作负载 > 有状态。

2. 点击有状态列表左上角新建有状态，进入创建有状态页面。
3. 在基本信息模块填写工作负载名称、命名空间、容器组数量、Pod 标签，点击下一步进入容器配置。
   

基本信息

4. 在容器配置模块，填写容器名称和镜像地址，可点击选择镜像后在弹窗中选择 CCR 中的镜像地址。点击下一步进入高级配置模块。

   说明

   • Pod 中可以配置多个容器，您可以单击右侧“添加容器”为 Pod 配置多个容器。
   • 若使用了 CCR 私有镜像,还需在当前页面的高级设置中配置仓库访问凭证。

容器配置

5. 在高级设置模块中，配置调度策略，点击完成进行工作负载的创建。
   

高级配置

方式二：通过 YAML 创建

1. 点击部署列表左上角使用YAML创建，进入新建工作负载页面。
2. 点击下拉列表选择命名空间，填写 yaml 文件，点击确定。

说明：

• 模板类型：可使用示例模板或“我的模板”创建。
• 复制：复制当前 YAML 文件的内容。
• 另存为：将当前文件模版另存为“我的模版”。
• 取消：返回列表页。
  

工作负载YAML示例

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: statefulset-example
spec:
  serviceName: "nginx"
  replicas: 2
  selector:
    matchLabels:
      app: nginx # has to match .spec.template.metadata.labels
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: registry.baidubce.com/cce/nginx-alpine-go:latest
        livenessProbe:
          httpGet:
            path: /
            port: 80
          initialDelaySeconds: 20
          timeoutSeconds: 5
          periodSeconds: 5
        readinessProbe:
          httpGet:
            path: /
            port: 80
          initialDelaySeconds: 5
          timeoutSeconds: 1
          periodSeconds: 5
        ports:
        - containerPort: 80
          name: web
      updateStrategy:
        type: RollingUpdate

方式三：通过 kubectl 创建

1. 准备 StatefulSet yaml 文件。
2. 安装 kubectl，并连接集群，详情参见 通过 kubectl 连接集群。
3. 复制下方的YAML文件，并保存到 statefulset.yaml中。

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: statefulset-example
spec:
  serviceName: "nginx"
  replicas: 2
  selector:
    matchLabels:
      app: nginx # has to match .spec.template.metadata.labels
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: registry.baidubce.com/cce/nginx-alpine-go:latest
        livenessProbe:
          httpGet:
            path: /
            port: 80
          initialDelaySeconds: 20
          timeoutSeconds: 5
          periodSeconds: 5
        readinessProbe:
          httpGet:
            path: /
            port: 80
          initialDelaySeconds: 5
          timeoutSeconds: 1
          periodSeconds: 5
        ports:
        - containerPort: 80
          name: web
      updateStrategy:
        type: RollingUpdate

4. 执行以下命令，创建 StatefulSet。

   kubectl apply -f statefulset.yaml

   预期输出：

   service/nginx created
   statefulset.apps/statefulset-example created

5. 执行以下命令，查看Service的公网IP地址

   kubectl get svc

6. 执行以下命令，验证 StatefulSet 是否创建成功：

    kubectl get statefulset

   
   

查看有状态部署详情

点击列表页任何一行的工作负载名称，即可进入工作负载详情页，详情页内容包括： 工作负载详情、关联容器组、更新升级、伸缩策略、调度策略、监控、事件等信息。

更新 Pod 数

支持通过控制台快速更新无状态负载中的 Pod 实例个数。

1. 登录有状态负载管理页面。

   a. 登录 容器引擎CCE控制台。
   b. 在左侧导航栏，点击 "集群管理->集群列表"，进入集群列表页，点击集群名称，进入集群管理页面。
   c. 在集群管理页面的左侧导航栏中，单击 工作负载 > 有状态。

2. 在目标有状态负载的列表，点击需要调整的有状态行中的“伸缩”，在伸缩的弹框页中，填写需要的容器组数量，点击“确认”。
   

更新有状态工作负载

支持通过控制台界面或 YAML 文件编辑已创建的有状态负载。

1. 登录有状态负载管理页面。

   a. 登录 容器引擎CCE控制台。
   b. 在左侧导航栏，点击 "集群管理->集群列表"，进入集群列表页，点击集群名称，进入集群管理页面。
   c. 在集群管理页面的左侧导航栏中，单击 工作负载 > 有状态负载。

2. 在目标有状态负载的操作列，单击 更新升级 或 编辑 YAML。

说明：
通过控制台界面更新和编辑 YAML 文件更新，均不支持更新有状态负载名称、命名空间。

a. 更新：在控制台更新配置信息。详细的参数说明，请参见 [通过控制台创建](https://cloud.baidu.com/doc/CCE/s/cjxpoxrgi)。<br>
b. 编辑 YAML：编辑 YAML 文件更新配置信息。详细的 YAML 配置说明，请参见[通过 YAML 创建](https://cloud.baidu.com/doc/CCE/s/cjxpoxrgi)。<br>

3. 更新完成后，单击提交。
   

标签注解管理

标签是以key/value键值对的形式附加在有状态工作负载上的。添加标签后，可通过标签对有状态工作负载进行管理和选择。您可以给多个工作负载打标签，也可以给指定的某个工作负载打标签。

说明：
标签格式要求如下：以字母和数字开头或结尾，由字母、数字、连接符（-）、下划线（_）、点号（.）组成且63字符以内，详细 K8S标签说明。

1. 登录有状态负载管理页面。

   a. 登录 容器引擎CCE控制台。
   b. 在左侧导航栏，点击 "集群管理->集群列表"，进入集群列表页，点击集群名称，进入集群管理页面。
   c. 在集群管理页面的左侧导航栏中，单击 工作负载 > 有状态。

2. 选择“有状态”页签，单击工作负载后的“更多 > 标签注解”。
3. 单击添加标签，输入键和值后单击更新。
   

查看监控

您可以通过 CCE 控制台查看工作负载和容器组的 CPU 和内存占用情况，以确定需要的资源规格。

说明：
查看工作负载的监控信息时，依赖集群接入 Prometheus 监控服务。若集群未接入Prometheues 监控服务，请根据界面提示接入，详细信息请参见使用Prometheus监控集群。

1. 登录有状态负载管理页面。

   a. 登录 容器引擎CCE控制台。
   b. 在左侧导航栏，点击 "集群管理->集群列表"，进入集群列表页，点击集群名称，进入集群管理页面。
   c. 在集群管理页面的左侧导航栏中，单击 工作负载 > 有状态。

2. 在目标有状态负载的列表，点击需要调整的有状态行中的“监控”。
   
3. 在监控页面查看有状态负载的监控数据。容器相关监控指标说明，请参见 监控指标说明。
   

查看日志

您可以通过“日志”功能查看无状态工作负载的日志信息。

说明：
当前显示的日志内容为容器标准输出日志，不具备持久化和高阶运维能力，如需使用更完善的日志能力，可使用日志中心功能。

1. 登录有状态负载管理页面。

   a. 登录 容器引擎CCE控制台。
   b. 在左侧导航栏，点击 "集群管理->集群列表"，进入集群列表页，点击集群名称，进入集群管理页面。
   c. 在集群管理页面的左侧导航栏中，单击 工作负载 > 有状态。

2. 在目标有状态负载的列表，单击工作负载后的“更多 > 日志”。
   
3. 在日志页面查看容器日志数据。
   

删除有状态负载

若工作负载无需再使用，您可以将工作负载删除。

说明：
删除有状态负载可能导致服务不可用，请谨慎操作。

1. 登录有状态负载管理页面。

   a. 登录 容器引擎CCE控制台。
   b. 在左侧导航栏，点击 "集群管理->集群列表"，进入集群列表页，点击集群名称，进入集群管理页面。
   c. 在集群管理页面的左侧导航栏中，单击 工作负载 > 有状态。

2. 在目标有状态负载的列表，单击工作负载后的“更多 > 删除”。
   
3. 在系统弹出的二次确认对话框，确认信息后，点击确认。