Container Service for Kubernetes:Konversi batch file YAML menggunakan antarmuka baris perintah FlexVolume2CSI

Flag

Jalankan flexvolume2csi translate help untuk melihat semua flag yang tersedia.

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

Contoh

Contoh ini mengonversi PV dan PVC NAS FlexVolume ke CSI.

1. Buat file pv.yaml dengan konten berikut dan terapkan ke kluster 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" # Ganti dengan alamat titik pemasangan NAS Anda.
         path: "/k8s"
         vers: "3"
         options: "nolock,tcp,noresvport"

   kubectl apply -f pv.yaml

2. Buat file pvc.yaml dengan konten berikut dan terapkan.

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

   kubectl apply -f pvc.yaml

3. Konfirmasi bahwa PV dan PVC telah terikat (bound).

   kubectl get pvc | grep pvc-nas

   Output yang diharapkan:

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

4. Konversi semua PV dan PVC di kluster. Flag -s csi menambahkan -csi ke nama resource yang dihasilkan untuk menghindari konflik.

   flexvolume2csi translate -s csi

5. Tinjau YAML CSI yang dihasilkan.

   cat ./outputfile.yaml

   Output yang diharapkan:

   ---
   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

Target konversi

Output konversi bergantung pada jenis volume:

• Volume disk tanpa `volumeId`: dikonversi menjadi volume sementara inline.

• Semua jenis lainnya: dikonversi menjadi resource PV dan PVC CSI. File output mencakup PV, PVC, dan manifes workload yang telah diperbarui.

Flags

Jalankan flexvolume2csi inline-translate help untuk melihat semua flag yang tersedia.

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

Contoh 1: Konversi volume disk tanpa volumeId menjadi volume sementara

1. Buat dan deploy workload berikut di kluster 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. Konversi beban kerja.

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

3. Tinjau YAML CSI yang dihasilkan.

   cat ./outputfile.yaml

   Output yang diharapkan:

   ---
   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. Sebelum mendeploy, sesuaikan YAML yang dihasilkan sesuai kebutuhan. Untuk volume sementara, tentukan StorageClass:

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

   Atau, gunakan -t saat konversi untuk menetapkan StorageClass untuk semua resource:

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

Contoh 2: Konversi jenis volume lain menjadi resource PV dan PVC CSI

Contoh ini menggunakan -f untuk mengonversi StatefulSet dari file lokal.

1. Simpan YAML StatefulSet yang ditunjukkan di awal langkah ini sebagai disk-static-sts.yaml.

2. Konversi StatefulSet tersebut.

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

3. Tinjau YAML CSI yang dihasilkan.

   cat ./outputfile.txt

   Output yang diharapkan:

   ---
   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

   Volume FlexVolume inline dikonversi menjadi PVC dan PV CSI. StatefulSet kini mereferensikan PVC alih-alih volume inline. Bagian volumeClaimTemplates tidak diubah.

4. Sebelum mendeploy, sesuaikan YAML yang dihasilkan sesuai kebutuhan. Untuk volume disk CSI, dua bidang biasanya tidak ada dalam output yang dihasilkan:

   • Kapasitas penyimpanan: deklarasikan kapasitas yang dibutuhkan pada PVC dan PV. Misalnya, tetapkan capacity.storage: 20Gi pada PV dan resources.requests.storage: 20Gi pada PVC.

   • StorageClass dalam volumeClaimTemplates: ubah storageClassName menjadi StorageClass CSI.

   Setelah penyesuaian:

   ---
   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****

   Atau, gunakan -t dan -c saat konversi untuk menetapkan StorageClass dan kapasitas untuk semua resource:

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