Container Compute Service:Use NAS volumes

Etapa 1: Obter informações do sistema de arquivos NAS

1. Obtenha o ID da VPC e o ID do vSwitch utilizados pelos pods do ACS.

   Nota

   Essas informações estão disponíveis no console. Alternativamente, execute o comando kubectl get cm -n kube-system acs-profile -o yaml para visualizar o arquivo YAML do ConfigMap acs-profile. O ID da VPC e o ID do vSwitch encontram-se nos campos vpcId e vSwitchIds.

   1. Faça login no console ACS.

   2. Em Clusters, clique em nome do cluster para acessar a página de gerenciamento do cluster.

   3. No painel de navegação à esquerda, escolha Configuration > ConfigMaps.

   4. No topo da página ConfigMap, altere o namespace para kube-system. Em seguida, localize acs-profile e clique em Edit YAML.

   5. Extraia o ID da VPC e o ID do vSwitch dos campos vpcId e vSwitchIds.

2. Verifique se o sistema de arquivos NAS existente atende aos requisitos e obtenha o endereço do destino de montagem.

   1. Faça login no console NAS. No painel de navegação à esquerda, clique em File System List.

   2. Localize o sistema de arquivos NAS desejado e confirme se sua região, zona e tipo de protocolo atendem aos requisitos.

      • Como o NAS não suporta montagem entre VPCs diferentes, ele não pode ser usado entre regiões. Certifique-se de que o sistema de arquivos NAS esteja na mesma região do seu cluster ACS.

      • Dentro da mesma VPC, é possível montar um sistema de arquivos NAS entre zonas. Contudo, para obter o melhor desempenho, recomenda-se que o sistema de arquivos NAS e os pods do cluster ACS estejam na mesma zona.

      • Confirme se o tipo de protocolo do sistema de arquivos NAS é NFS. Sistemas de arquivos NAS que utilizam o protocolo SMB não podem ser montados.

   3. Valide se o destino de montagem atende aos requisitos e obtenha seu endereço.

      1. Clique em ID do sistema de arquivos.

      2. Na página de detalhes do sistema de arquivos, clique em Mount Targets no painel de navegação à esquerda.

      3. Na área Mount Target, verifique se existe um destino de montagem que atenda aos requisitos e obtenha o endereço correspondente.

         Nota

         • Um destino de montagem é criado automaticamente ao criar um sistema de arquivos NAS de uso geral. Para sistemas de arquivos NAS Extreme, a criação do destino de montagem deve ser manual.

         • Se nenhum destino de montagem existente atender aos requisitos, crie um novo. Para mais informações, consulte Manage mount targets.

         • A VPC do destino de montagem deve ser idêntica à VPC do cluster ACS. Caso contrário, a montagem falhará.

         • Para otimizar o desempenho, recomenda-se que o destino de montagem e os pods do cluster ACS utilizem o mesmo vSwitch.

         • O status do destino de montagem deve ser Available.

Etapa 2: Criar uma StorageClass

1. Ajuste o conteúdo YAML abaixo conforme as descrições dos parâmetros e salve-o como nas-sc.yaml.

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-nas-subpath
   mountOptions:
   - nolock,tcp,noresvport
   - vers=3
   parameters:
     volumeAs: subpath
     server: "*******-mw***.cn-shanghai.nas.aliyuncs.com:/csi"
   provisioner: nasplugin.csi.alibabacloud.com
   reclaimPolicy: Retain

   Descrição dos parâmetros:

   Parâmetro	Descrição
   volumeAs	Modo de provisionamento. Defina como subpath para criar cada volume persistente (PV) como um subdiretório. Cada PV corresponde a um subdiretório do sistema de arquivos NAS.
   server	Endereço do destino de montagem do sistema de arquivos NAS, no formato mount-target-address:path, onde path representa o subdiretório do NAS que você deseja montar. Se nenhum caminho for especificado, o diretório raiz será montado por padrão. Caso o diretório não exista no sistema de arquivos NAS, ele será criado automaticamente antes da montagem. O diretório raiz é / para sistemas de arquivos NAS de uso geral e /share para sistemas de arquivos NAS Extreme.
   provisioner	Define o tipo de provisionador. Deve ser definido como nasplugin.csi.alibabacloud.com para utilizar o plug-in CSI do Alibaba Cloud NAS.
   reclaimPolicy	Política de recuperação do PV. Apenas Retain é suportado, o que significa que o sistema de arquivos NAS e o destino de montagem correspondentes são mantidos quando o PV é excluído.

Etapa 3: Criar um PVC

Etapa 4: Criar uma aplicação e montar o volume

Etapa 1: Criar uma StorageClass

1. Ajuste o conteúdo YAML abaixo conforme as descrições dos parâmetros e salve o arquivo como nas-sc.yaml.

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: alicloud-nas-fs
   mountOptions:
   - nolock,tcp,noresvport
   - vers=3
   parameters:
     volumeAs: filesystem
     fileSystemType: standard
     storageType: Performance
     regionId: cn-shanghai
     zoneId: cn-shanghai-e
     vpcId: "vpc-2ze2fxn6popm8c2mzm****"
     vSwitchId: "vsw-2zwdg25a2b4y5juy****"
     accessGroupName: DEFAULT_VPC_GROUP_NAME
     deleteVolume: "false"
   provisioner: nasplugin.csi.alibabacloud.com
   reclaimPolicy: Retain

   A tabela a seguir descreve os parâmetros.

   Importante

   O suporte a tipos de sistemas de arquivos NAS e classes de armazenamento varia conforme a região e a zona de disponibilidade. Certifique-se de que a região, zona de disponibilidade, VPC e vSwitch selecionados para o sistema de arquivos NAS e seu destino de montagem sejam compatíveis com seu cluster ACS, bem como com a VPC e o vSwitch utilizados pelos seus pods. Para mais informações, consulte os tópicos a seguir:

   • Para informações sobre classes de armazenamento, desempenho, faturamento e regiões e zonas de disponibilidade suportadas para diferentes tipos de sistemas de arquivos NAS, consulte General-purpose NAS e Extreme NAS.

   • O NAS de uso geral e o NAS Extreme possuem limitações diferentes quanto à conectividade de montagem, quantidade de sistemas de arquivos e tipos de protocolo. Para mais informações, consulte Limitations.

   • Execute o comando kubectl get cm -n kube-system acs-profile -o yaml para visualizar o YAML do acs-profile e obter os IDs da VPC e dos vSwitches usados pelos pods nos campos vpcId e vSwitchIds.

   Parâmetro	Descrição
   volumeAs	Define como o volume é provisionado. Configure como filesystem para criar automaticamente um novo sistema de arquivos NAS para cada volume.
   fileSystemType	Tipo do sistema de arquivos NAS. standard (padrão): NAS de uso geral. Para mais informações, consulte General-purpose NAS. extreme: NAS Extreme. Para mais informações, consulte Extreme NAS.
   storageType	Classe de armazenamento do sistema de arquivos NAS. Para NAS de uso geral, os valores válidos são: Performance (padrão): Performance Capacity: Capacity Para NAS Extreme, os valores válidos são: standard (padrão): Standard advanced: Advanced
   regionId	Região onde o sistema de arquivos NAS está localizado. Deve ser a mesma região do seu cluster ACS.
   zoneId	Zona de disponibilidade onde o sistema de arquivos NAS está localizado. Escolha uma zona de disponibilidade com base no vSwitch utilizado pelos pods do seu cluster ACS. Nota Dentro da mesma VPC, é possível montar um sistema de arquivos NAS entre zonas de disponibilidade. Para obter o melhor desempenho, recomenda-se selecionar a mesma zona de disponibilidade.
   vpcId, vSwitchId	IDs da VPC e do vSwitch para o destino de montagem do sistema de arquivos NAS. Devem corresponder aos IDs da VPC e do vSwitch utilizados pelos pods do seu cluster ACS.
   accessGroupName	Grupo de permissões do destino de montagem para o sistema de arquivos NAS. O valor padrão é DEFAULT_VPC_GROUP_NAME.
   provisioner	Provisionador. Deve ser definido como nasplugin.csi.alibabacloud.com, indicando o uso do plug-in CSI do Alibaba Cloud NAS.
   reclaimPolicy	Política de recuperação do PV. A única política suportada é Retain, o que significa que o sistema de arquivos NAS e o destino de montagem correspondentes são mantidos quando o PV é excluído.

2. Crie a StorageClass.

   kubectl create -f nas-sc.yaml

3. Verifique a StorageClass.

   kubectl get sc

   Saída esperada:

   NAME                             PROVISIONER                       RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
   alicloud-nas-fs                  nasplugin.csi.alibabacloud.com    Retain          Immediate              false                  13m
   ......

Etapa 2: Criar um PersistentVolumeClaim

1. Salve o conteúdo abaixo em um arquivo chamado nas-pvc-fs.yaml.

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

   A tabela a seguir descreve os parâmetros.

   Parâmetro	Descrição
   accessModes	Modo de acesso.
   storage	Capacidade do volume NAS a ser criado. Nota O NAS Extreme possui capacidade mínima de 100 GiB. Se o tipo de sistema de arquivos NAS definido na StorageClass for NAS Extreme, o valor de storage deve ser igual ou superior a 100 GiB. Caso contrário, o PersistentVolume correspondente não poderá ser criado.
   storageClassName	Nome da StorageClass a ser utilizada.

2. Crie o PersistentVolumeClaim.

   kubectl create -f nas-pvc-fs.yaml

3. Verifique o PersistentVolumeClaim.

   kubectl get pvc

   A saída mostra que o PersistentVolumeClaim está vinculado ao PersistentVolume criado automaticamente. Também é possível visualizar o sistema de arquivos NAS correspondente no console NAS.

   NAME         STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS      VOLUMEATTRIBUTESCLASS  AGE
   nas-pvc-fs   Bound    nas-04a730ba-010d-4fb1-9043-476d8c38****   20Gi       RWX            alicloud-nas-fs   <unset>                14s

Etapa 3: Criar uma aplicação e montar o volume NAS

1. Crie um arquivo chamado nas-test-fs.yaml com o conteúdo a seguir.

   O YAML abaixo cria um Deployment com dois pods. Ambos os pods solicitam armazenamento do PersistentVolumeClaim chamado nas-pvc-fs e montam o volume no caminho de montagem /data.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nas-test
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
           ports:
           - containerPort: 80
           volumeMounts:
             - name: pvc-nas
               mountPath: /data
         volumes:
           - name: pvc-nas
             persistentVolumeClaim:
               claimName: nas-pvc-fs

2. Crie o Deployment e monte o volume NAS.

   kubectl create -f nas-test-fs.yaml

3. Verifique o status de implantação dos pods no Deployment.

   kubectl get pod | grep nas-test

   A saída abaixo mostra que dois pods foram criados.

   nas-test-****-***a   1/1     Running   0          40s
   nas-test-****-***b   1/1     Running   0          40s

4. Verifique o caminho de montagem.

   kubectl exec nas-test-****-***a -- df -h /data

   Saída esperada:

   Filesystem                                        Size  Used Avail Use% Mounted on
   350514*****-mw***.cn-shanghai.nas.aliyuncs.com:/   1.0P     0  1.0P   0% /data

   Essa saída confirma que o sistema de arquivos foi montado com sucesso.

Etapa 1: Obter informações do sistema de arquivos NAS

Para mais informações sobre como obter o endereço do destino de montagem do NAS, consulte Obtain NAS file system information.

Etapa 2: Criar uma aplicação e montar o NAS

1. Crie um arquivo chamado nas-test-nfs.yaml com o conteúdo a seguir.

   Este YAML define um Deployment com dois pods. Cada pod monta o sistema de arquivos NAS no caminho /data utilizando um volume chamado nfs-nas.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nas-test
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest
           ports:
           - containerPort: 80
           volumeMounts:
             - name: nfs-nas
               mountPath: /data
         volumes:
         - name: nfs-nas
           nfs:
             server: file-system-id.region.nas.aliyuncs.com    # The mount target address of the Alibaba Cloud NAS file system. Replace this with your actual value. Example: 7bexxxxxx-xxxx.ap-southeast-1.nas.aliyuncs.com.
             path: /    # The directory path in the NAS file system. The directory must be an existing directory or the root directory. The root directory of a General-purpose NAS file system is "/", and the root directory of an Extreme NAS file system is "/share".

2. Crie o Deployment e monte o volume NAS.

   kubectl create -f nas-test-nfs.yaml

3. Verifique o status de implantação dos pods no Deployment.

   kubectl get pod | grep nas-test

   A saída abaixo mostra que dois pods foram criados.

   nas-test-****-***a   1/1     Running   0          40s
   nas-test-****-***b   1/1     Running   0          40s

4. Verifique o caminho de montagem.

   kubectl exec nas-test-****-***a -- df -h /data

   Saída esperada:

   Filesystem                                        Size  Used Avail Use% Mounted on
   350514*****-mw***.cn-shanghai.nas.aliyuncs.com:/   1.0P     0  1.0P   0% /data

   Essa saída confirma que o sistema de arquivos foi montado com sucesso.