磁盘扩容

KubeBlocks 支持 Pod 存储磁盘扩容。

备注

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

开始之前

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

kbcli

kbcli cluster list mycluster -n demo
>
NAME        NAMESPACE   CLUSTER-DEFINITION   VERSION           TERMINATION-POLICY   STATUS    CREATED-TIME
mycluster   demo        apecloud-mysql       ac-mysql-8.0.30   Delete               Running   Sep 19,2024 16:01 UTC+0800

kubectl

kubectl get cluster mycluster -n demo
>
NAME        CLUSTER-DEFINITION   VERSION           TERMINATION-POLICY   STATUS    AGE
mycluster   apecloud-mysql       ac-mysql-8.0.30   Delete               Running   27m

步骤

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: mysql
       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. 当 Ops 状态为 Succeed或集群状态再次回到 Running 后，查看对应的集群资源是否按需变更。

   kubectl describe cluster mycluster -n demo

编辑集群 YAML 文件

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

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

   apiVersion: apps.kubeblocks.io/v1alpha1
   kind: Cluster
   metadata:
     name: mycluster
     namespace: demo
   spec:
     clusterDefinitionRef: apecloud-mysql
     clusterVersionRef: ac-mysql-8.0.30
     componentSpecs:
     - name: mysql
       componentDefRef: mysql
       replicas: 3
       volumeClaimTemplates:
       - name: data
         spec:
           accessModes:
             - ReadWriteOnce
           resources:
             requests:
               storage: 40Gi # 修改磁盘容量值
     terminationPolicy: Delete

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

   kubectl get cluster mycluster -n demo
   
   kubectl describe cluster mycluster -n demo

kbcli

1. 更改配置。

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

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

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

   • 查看 OpsRequest 进程。

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

     kbcli cluster describe-ops mycluster-volumeexpansion-8257f -n demo

   • 查看集群状态。

     kbcli cluster list mycluster -n demo
     >
     NAME        NAMESPACE   CLUSTER-DEFINITION   VERSION           TERMINATION-POLICY   STATUS     CREATED-TIME
     mycluster   demo        apecloud-mysql       ac-mysql-8.0.30   Delete               Updating   Sep 19,2024 16:01 UTC+0800
     • STATUS=Updating 表示扩容正在进行中。
     • STATUS=Running 表示扩容已完成。

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

   kbcli cluster describe mycluster -n demo