全部产品
Search

搜索本产品

    容器服务 Kubernetes 版 ACK：使用Flexvolume2CSI命令行工具批量转换YAML

    文档中心

    容器服务 Kubernetes 版 ACK：使用Flexvolume2CSI命令行工具批量转换YAML

    更新时间：Apr 15, 2024

    Flexvolume2CSI命令行工具可以帮您批量转换Flexvolume集群中PVC和PV的YAML，帮助您更便捷地由Flexvolume集群切换至CSI集群。本文介绍如何在Flexvolume集群中使用Flexvolume2CSI命令行工具批量转换YAML。

    实现原理

    Flexvolume2CSI工具将列出集群内所有或指定命名空间内的所有或指定的PVC、以及PVC对应的PV对象，将标准Flexvolume的PV、PVC相关的Labels、Flexvolume字段内容转译为对应CSI的PV、PVC内容，并将YAML打印至文件中，以便部署。

    重要

    转换处理仅支持处理相对标准的NAS、OSS、阿里云云盘类型的PV和PVC，建议您在部署前再次检查生成CSI的PV和PVC的YAML。

    步骤一：安装Flexvolume2CSI命令行工具

    1. 执行以下命令，安装Flexvolume2CSI。

      支持macOS和Linux系统安装。

      curl https://ack-csiplugin.oss-cn-hangzhou.aliyuncs.com/flexvolume2csi/get-translator.sh | bash

    2. 执行以下命令，验证Flexvolume2CSI是否安装成功。

      flexvolume2csi version

      预期输出：

      flexvolume2csi: v1.0.2+b1de5bd
  BuildDate: 2024-04-09T07:20:26Z
  GitCommit: b1de5bdce11b4b59ddce38d91d868b5f35a431c1
  GitTreeState: clean
  GoVersion: go1.18.4
  Compiler: gc
  Platform: darwin/arm64

      预期输出表明，Flexvolume2CSI命令行工具已安装成功。

    步骤二：为Flexvolume2CSI配置集群信息

    1. 执行以下命令，配置Flexvolume2CSI的集群信息。

      flexvolume2csi configure

      预期输出：

      Configuring profile 'default' ...
Default Cluster Id (ClusterId of ACK Flexvolume Cluster) [c4869a2f603ca4e74****************]:
Default Kubeconfig Path (default is ~/.kube/config) []:
Saving profile[default] ...
Done.

      参数

      说明

      Cluster Id

      Flexvolume集群的Cluster ID。

      Kubeconfig Path

      Flexvolume集群的KubeConfig路径，默认为~/.kube/config。

    步骤三：生成Flexvolume集群中PV和PVC对应的CSI YAML文件

    可选参数

    执行以下命令，查询Flexvolume2CSI支持的可选配置项。

    flexvolume2csi translate help

    预期输出：

    flexvolume2csi source add [-n namespace] [-c pvc] [-o outputfile] [-p prefix] [-s suffix] [-b backupfile] [-a apiversion] [-t storageclass]

Usage:
  flexvolume2csi translate [-n namespace] [-c pvc] [-o outputfile] [-p prefix] [-s suffix] [-b backupfile] [-a apiversion] [-t storageclass] [flags]

Examples:
  # Translate PVCs and related PVs in all namespaces
  flexvolume2csi translate -o output.txt

  # Translate PVCs and related PVs in default namespace
  flexvolume2csi translate -n default -o output.txt

  # Translate PVC test-pvc and related PV in default namespace
  flexvolume2csi translate -n default -p test-pvc -o output.txt


Flags:
  -a, --apiversion string     change pv/pvc apiversion (default "v1")
  -b, --backupfile string     path to backup (flexvolume) file (default "./backupfile.txt")
  -h, --help                  help for translate
  -n, --namespace string      specified namespace
  -o, --outputfile string     path to output (CSI) file (default "./outputfile.txt")
  -p, --prefix string         change pv/pvc name to prefix-xxx
  -c, --pvc string            specified pvc
  -t, --storageclass string   change storageclass name
  -s, --suffix string         change pv/pvc name to xxx-suffix

    可选参数

    说明

    -o

    生成的CSI的PV和PVC的YAML文件地址，默认为当前路径下的outputfile.txt。传空值时打印至标准输出。

    -b

    备份原Flexvolume的PV和PVC的YAML文件地址，默认为当前路径下的backupfile.txt。传空值时不备份。

    -n

    指定命名空间名称，仅处理该命名空间下的PV和PVC，默认为所有命名空间。

    -c

    指定PVC名称，仅处理该PVC及其对应的PV，需要配合-n参数使用。默认为选中命名空间的所有PV和PVC。

    -p

    生成的CSI的PV和PVC名称的统一前缀，默认无前缀。

    如原Flexvolume的PVC名称为pvc-test，加上-p csi后，CSI对应的PVC名称为csi-pvc-test。

    -s

    生成的CSI的PV和PVC名称的统一后缀，默认无后缀。

    如原Flexvolume的pvc名称为pvc-test，加上-s csi后，CSI对应的PVC名称为pvc-test-csi。

    操作示例

    1. 使用以下内容，在Flexvolume集群中创建pv.yaml文件。

      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" #替换为您存储文件的挂载点地址。
      path: "/k8s"
      vers: "3"
      options: "nolock,tcp,noresvport"

    2. 执行以下命令，在Flexvolume集群中部署示例PV。

      kubectl apply -f pv.yaml

    3. 使用以下内容，在Flexvolume集群中创建pvc.yaml文件。

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

    4. 执行以下命令，在Flexvolume集群中部署示例PVC。

      kubectl apply -f pvc.yaml

    5. 执行以下命令，确认PV和PVC处于Bound状态。

      kubectl get pvc | grep pvc-nas

      预期输出：

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

    6. 执行以下命令，使用Flexvolume2CSI命令行工具，转换集群内的所有PV和PVC的YAML文件。

      flexvolume2csi translate

    7. 执行以下命令，查看输出的CSI的PV和PVC的YAML文件。

      cat ./outputfile.yaml

      预期输出：

      ---

apiVersion: v1
kind: PersistentVolume
metadata:
  labels:
    alicloud-pvname: pv-nas
  name: pv-nas
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
  mountOptions:
  - nolock,tcp,noresvport
  - vers=3
  persistentVolumeReclaimPolicy: Retain
  storageClassName: nas
  volumeMode: Filesystem

---

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: pvc-nas
  namespace: default
spec:
  accessModes:
  - ReadWriteMany
  resources:
    requests:
      storage: 5Gi
  selector:
    matchLabels:
      alicloud-pvname: pv-nas
  storageClassName: nas
  volumeMode: Filesystem
  volumeName: pv-nas

      预期输出表明，已成功生成PV和PVC对应的CSI YAML文件。

    相关文档