Container Service for Kubernetes:FlexVolume2CSI コマンドラインインターフェイスを用いた YAML ファイルの一括変換

フラグ

利用可能なすべてのフラグを表示するには、flexvolume2csi translate help を実行します。

flexvolume2csi translate [-n namespace] [-c pvc] [-o outputfile] [-p prefix] [-s suffix] [-b backupfile] [-t storageclass]

例

この例では、FlexVolume NAS PV および PVC を CSI に変換します。

1. 以下の内容で pv.yaml ファイルを作成し、FlexVolume クラスターに適用します。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: pv-nas
   spec:
     capacity:
       storage: 5Gi
     storageClassName: nas
     accessModes:
       - ReadWriteMany
     flexVolume:
       driver: "alicloud/nas"
       options:
         server: "0cd8b4a576-u****.cn-hangzhou.nas.aliyuncs.com" # ご利用の NAS マウントターゲットアドレスに置き換えてください。
         path: "/k8s"
         vers: "3"
         options: "nolock,tcp,noresvport"

   kubectl apply -f pv.yaml

2. 以下の内容で pvc.yaml ファイルを作成し、適用します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: pvc-nas
   spec:
     accessModes:
       - ReadWriteMany
     storageClassName: nas
     resources:
       requests:
         storage: 5Gi

   kubectl apply -f pvc.yaml

3. PV および PVC がバインドされていることを確認します。

   kubectl get pvc | grep pvc-nas

   期待される出力：

   pvc-nas   Bound    pv-nas   5Gi       RWO            nas       10s

4. クラスター内のすべての PV および PVC を変換します。-s csi フラグにより、生成されるリソース名に -csi が付与され、名前衝突が回避されます。

   flexvolume2csi translate -s csi

5. 生成された CSI YAML を確認します。

   cat ./outputfile.yaml

   期待される出力：

   ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     labels:
       alicloud-pvname: pv-nas-csi
     name: pv-nas-csi
   spec:
     accessModes:
     - ReadWriteMany
     capacity:
       storage: 5Gi
     csi:
       driver: nasplugin.csi.alibabacloud.com
       volumeAttributes:
         path: /k8s
         server: 0cd8b4a576-u****.cn-hangzhou.nas.aliyuncs.com
       volumeHandle: pv-nas-csi
     mountOptions:
     - nolock,tcp,noresvport
     - vers=3
     persistentVolumeReclaimPolicy: Retain
     storageClassName: nas
     volumeMode: Filesystem
   
   ---
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: pvc-nas-csi
     namespace: default
   spec:
     accessModes:
     - ReadWriteMany
     resources:
       requests:
         storage: 5Gi
     selector:
       matchLabels:
         alicloud-pvname: pv-nas-csi
     storageClassName: nas
     volumeMode: Filesystem
     volumeName: pv-nas-csi

変換対象

変換出力はボリュームの種類によって異なります。

• volumeId を持たないディスクボリューム：インラインの一時ボリュームに変換されます。

• その他のすべてのタイプ：CSI PV および PVC リソースに変換されます。出力ファイルには PV、PVC、および更新済みのワークロードマニフェストが含まれます。

フラグ

利用可能なすべてのフラグを表示するには、flexvolume2csi inline-translate help を実行します。

flexvolume2csi inline-translate [-n namespace] [-k kind] [-i item] [-f inputfile] [-o outputfile] [-b backupfile] [-t storageclass] [-c capacity]

例 1：volumeId を持たないディスクボリュームを一時ボリュームに変換

1. 以下のワークロードを FlexVolume クラスターに作成・デプロイします。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx
   spec:
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           volumeMounts:
           - name: test
             mountPath: /data
           ports:
           - containerPort: 80
         volumes:
         - name: test
           flexVolume:
             driver: "alicloud/disk"
             fsType: "ext4"
             options:
               volumeSize: "20"

2. ワークロードを変換します。

   flexvolume2csi inline-translate -k deploy -n default -i nginx

3. 生成された CSI YAML を確認します。

   cat ./outputfile.yaml

   期待される出力：

   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx
     namespace: default
   spec:
     progressDeadlineSeconds: 600
     replicas: 1
     revisionHistoryLimit: 10
     selector:
       matchLabels:
         app: nginx
     strategy:
       rollingUpdate:
         maxSurge: 25%
         maxUnavailable: 25%
       type: RollingUpdate
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           imagePullPolicy: IfNotPresent
           name: nginx
           ports:
           - containerPort: 80
             protocol: TCP
           resources: {}
           terminationMessagePath: /dev/termination-log
           terminationMessagePolicy: File
           volumeMounts:
           - mountPath: /data
             name: test
         dnsPolicy: ClusterFirst
         restartPolicy: Always
         schedulerName: default-scheduler
         securityContext: {}
         terminationGracePeriodSeconds: 30
         volumes:
         - ephemeral:
             volumeClaimTemplate:
               metadata:
               spec:
                 accessModes:
                 - ReadWriteOnce
                 resources:
                   requests:
                     storage: 20Gi
           name: test

4. デプロイ前に、生成された YAML を必要に応じて調整してください。一時ボリュームの場合、StorageClass を指定します。

         volumes:
         - ephemeral:
             volumeClaimTemplate:
               metadata:
               spec:
                 accessModes:
                 - ReadWriteOnce
                 resources:
                   requests:
                     storage: 20Gi
                 storageClassName: ephemeral-disk

   あるいは、変換時に -t を指定して、すべてのリソースに StorageClass を設定することもできます。

   flexvolume2csi inline-translate -k deploy -n default -i nginx -t ephemeral-disk

例 2：その他のボリュームタイプを CSI PV および PVC リソースに変換

この例では、-f を使用して、ローカルファイルから StatefulSet を変換します。

1. このステップの冒頭に示した StatefulSet YAML を disk-static-sts.yaml として保存します。

2. StatefulSet を変換します。

   flexvolume2csi inline-translate -f disk-static-sts.yaml

3. 生成された CSI YAML を確認します。

   cat ./outputfile.txt

   期待される出力：

   ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: d-bp1f3b5d0b0a8e7e6f****
   spec:
     accessModes:
     - ReadWriteOnce
     claimRef:
       kind: PersistentVolumeClaim
       name: sts-nginx-test
       namespace: default
     csi:
       driver: diskplugin.csi.alibabacloud.com
       fsType: ext4
       volumeAttributes:
         volumeId: d-bp1f3b5d0b0a8e7e6f****
       volumeHandle: d-bp1f3b5d0b0a8e7e6f****
     persistentVolumeReclaimPolicy: Delete
   
   ---
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: sts-nginx-test
     namespace: default
   spec:
     accessModes:
     - ReadWriteOnce
     resources: {}
     volumeName: d-bp1f3b5d0b0a8e7e6f****
   
   ---
   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: nginx
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: nginx
     serviceName: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           name: nginx
           ports:
           - containerPort: 80
           resources: {}
           volumeMounts:
           - mountPath: /data
             name: test
         volumes:
         - name: test
           persistentVolumeClaim:
             claimName: sts-nginx-test
     updateStrategy: {}
     volumeClaimTemplates:
     - metadata:
         name: disk-ssd
       spec:
         accessModes: [ "ReadWriteOnce" ]
         storageClassName: "alicloud-disk-ssd"
         resources:
           requests:
             storage: 20Gi

   インライン FlexVolume ボリュームは、CSI PVC および PV に変換されました。StatefulSet は、インラインボリュームの代わりに PVC を参照するようになっています。volumeClaimTemplates セクションは変更されていません。

4. デプロイ前に、生成された YAML を必要に応じて調整してください。CSI ディスクボリュームの場合、生成出力には通常、以下の 2 つのフィールドが欠落しています。

   • ストレージ容量：PVC および PV に必要な容量を宣言します。たとえば、PV では capacity.storage: 20Gi を、PVC では resources.requests.storage: 20Gi を設定します。

   • volumeClaimTemplates 内の StorageClass：storageClassName を CSI StorageClass に変更します。

   調整後の例：

   ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: d-bp1f3b5d0b0a8e7e6f****
   spec:
     accessModes:
     - ReadWriteOnce
     capacity:
       storage: 20Gi
     claimRef:
       kind: PersistentVolumeClaim
       name: sts-nginx-test
       namespace: default
     csi:
       driver: diskplugin.csi.alibabacloud.com
       fsType: ext4
       volumeAttributes:
         volumeId: d-bp1f3b5d0b0a8e7e6f****
       volumeHandle: d-bp1f3b5d0b0a8e7e6f****
     persistentVolumeReclaimPolicy: Delete
   
   ---
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: sts-nginx-test
     namespace: default
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 20Gi
     volumeName: d-bp1f3b5d0b0a8e7e6f****

   あるいは、変換時に -t および -c を指定して、すべてのリソースに StorageClass および容量を設定することもできます。

   flexvolume2csi inline-translate -f disk-static-sts.yaml -t <csi-storageclass> -c "20Gi"