磁盘扩容

KubeBlocks 支持 Pod 磁盘存储扩容。

备注

磁盘扩容将触发 Pod 重启。重启后，主节点可能会发生变化。

开始之前

确保集群处于 Running 状态，否则以下操作可能会失败。

kubectl

kubectl -n demo get cluster mycluster
>
NAME           CLUSTER-DEFINITION   VERSION        TERMINATION-POLICY   STATUS     AGE
mycluster      redis                               Delete               Running    19m

kbcli

kbcli cluster list mycluster -n demo
>
NAME        NAMESPACE   CLUSTER-DEFINITION   VERSION   TERMINATION-POLICY   STATUS    CREATED-TIME
mycluster   demo        redis                          Delete               Running   Sep 29,2024 09:46 UTC+0800

步骤

OpsRequest

1. 应用 OpsRequest。根据需求更改 storage 的值，并执行以下命令来更改集群的存储容量。

   kubectl apply -f - <<EOF
   apiVersion: apps.kubeblocks.io/v1alpha1
   kind: OpsRequest
   metadata:
     name: ops-volume-expansion
     namespace: demo
   spec:
     clusterName: mycluster
     type: VolumeExpansion
     volumeExpansion:
     - componentName: redis
       volumeClaimTemplates:
       - name: data
         storage: "40Gi"
   EOF

2. 验证磁盘扩容操作是否成功。

   kubectl get ops -n demo
   >
   NAMESPACE   NAME                   TYPE              CLUSTER     STATUS    PROGRESS   AGE
   demo        ops-volume-expansion   VolumeExpansion   mycluster   Succeed   3/3        6m

   如果操作过程中出现报错，可通过 kubectl describe ops -n demo 查看该操作的事件，协助排障。

3. 当 OpsRequest 状态为 Succeed 或集群状态再次回到 Running 后，查看对应的集群资源是否变更。

   kubectl describe cluster mycluster -n demo
   >
   ...
   Volume Claim Templates:
      Name:  data
      Spec:
        Access Modes:
          ReadWriteOnce
        Resources:
          Requests:
            Storage:   40Gi

编辑集群 YAML 文件

1. 更改集群 YAML 文件中 spec.componentSpecs.volumeClaimTemplates.spec.resources 的值。

   spec.componentSpecs.volumeClaimTemplates.spec.resources 定义了 Pod 的存储资源信息，更改此值会触发磁盘扩容。

   spec:
     affinity:
       podAntiAffinity: Preferred
       topologyKeys:
       - kubernetes.io/hostname
     clusterDefinitionRef: redis
     clusterVersionRef: redis-7.0.6
     componentSpecs:
     - componentDefRef: redis
       enabledLogs:
       - running
       disableExporter: true
       name: redis
       replicas: 1
       resources:
         limits:
           cpu: "0.5"
           memory: 0.5Gi
         requests:
           cpu: "0.5"
           memory: 0.5Gi
       serviceAccountName: kb-redis
       volumeClaimTemplates:
       - name: data
         spec:
           accessModes:
           - ReadWriteOnce
           resources:
             requests:
               storage: 40Gi # 修改该参数值

2. 当集群状态再次回到 Running 后，查看对应的集群资源是否变更。

   kubectl describe cluster mycluster -n demo
   >
   ...
   Volume Claim Templates:
      Name:  data
      Spec:
        Access Modes:
          ReadWriteOnce
        Resources:
          Requests:
            Storage:   40Gi

kbcli

1. 更改配置。

   配置参数 --components、--volume-claim-templates 和 --storage，并执行以下命令。

   kbcli cluster volume-expand mycluster -n demo --components="redis" --volume-claim-templates="data" --storage="40Gi"
   • --components 表示需扩容的组件名称。
   • --volume-claim-templates 表示组件中的 VolumeClaimTemplate 名称。
   • --storage 表示磁盘需扩容至的大小。

2. 可通过以下任意一种方式验证扩容操作是否完成。

   • 查看 OpsRequest 进度。

     执行磁盘扩容命令后，KubeBlocks 会自动输出查看 OpsRequest 进度的命令，可通过该命令查看 OpsRequest 进度的细节，包括 OpsRequest 的状态、PVC 状态等。当 OpsRequest 的状态为 Succeed 时，表明这一任务已完成。

     kbcli cluster describe-ops mycluster-volumeexpansion-ih2r4 -n demo

   • 查看集群状态。

     kbcli cluster list mycluster -n demo
     • STATUS=Updating 表示扩容正在进行中。
     • STATUS=Running 表示扩容已完成。

3. 当 OpsRequest 状态为 Succeed 或集群状态再次回到 Running 后，检查资源规格是否已按要求变更。

   kbcli cluster describe mycluster -n demo