Container Service for Kubernetes:Use NAS dynamic volumes

kubectl

1. Crie um arquivo chamado alicloud-nas-subpath.yaml com o seguinte conteúdo:

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     # The name of the StorageClass, which must be unique within the cluster.
     name: alicloud-nas-subpath  
   mountOptions:
   - nolock,tcp,noresvport
   - vers=3
   parameters:
     # Set to subpath.
     volumeAs: subpath
     # The format of the server field is <nas-server-address>:/<path>.
     server: "0cd8b4a576-g****.cn-hangzhou.nas.aliyuncs.com:/k8s"
     archiveOnDelete: "true"
   provisioner: nasplugin.csi.alibabacloud.com
   reclaimPolicy: Retain
   allowVolumeExpansion: true

   Parâmetro		Descrição
   mountOptions		As opções de montagem para o NAS, incluindo a versão do protocolo NFS. Por padrão, os volumes são montados usando NFSv3. Você pode especificar uma versão diferente com uma opção como vers=4.0. Para informações sobre os protocolos NFS suportados por diferentes tipos de NAS, consulte Protocolos NFS.
   parameters.volumeAs		O modo de provisionamento do volume. Defina como subpath.
   parameters.server		O destino de montagem do NAS e o subpath a ser montado, no formato <nas-server-address>:/<path>. <nas-server-address>: O destino de montagem do sistema de arquivos NAS. Para mais informações, consulte Gerenciar destinos de montagem. :/<path>: O subpath do NAS a ser montado. Se este parâmetro não for definido ou se o subpath especificado não existir, o diretório raiz será montado por padrão. NAS de uso geral: O diretório raiz é /. Extreme NAS: O diretório raiz é /share. Ao montar um subpath, o path deve começar com /share, como /share/data.
   parameters.archiveOnDelete		Especifica se os dados no armazenamento de backend devem ser excluídos quando um PVC é excluído e seu reclaimPolicy está definido como Delete. Esta opção atua como uma salvaguarda para evitar perda acidental de dados no armazenamento NAS compartilhado. true (padrão): O diretório e seus arquivos não são excluídos. Em vez disso, eles são arquivados e renomeados no formato archived-{pvName}.{timestamp}. false: O diretório correspondente e seus dados são excluídos permanentemente. Esta operação exclui o subpath do NAS e seus arquivos, não o sistema de arquivos NAS em si. Para excluir um sistema de arquivos NAS, consulte Excluir um sistema de arquivos. Em cenários onde PVs são criados e excluídos frequentemente, definir este parâmetro como false pode causar o bloqueio da fila de tarefas do controlador CSI, impedindo a criação de novos PVs. Para mais informações, consulte A fila de tarefas do controlador está cheia e novos PVs não podem ser criados ao usar um volume NAS dinâmico.
   provisioner		O driver. Defina este parâmetro como nasplugin.csi.alibabacloud.com ao usar o plug-in CSI do Alibaba Cloud NAS.
   reclaimPolicy		A política de recuperação do PV. Delete (padrão): Quando o PVC é excluído, os dados do armazenamento de backend são processados com base na configuração archiveOnDelete. Retain: Quando o PVC é excluído, o PV e os dados no sistema de arquivos NAS não são excluídos e devem ser removidos manualmente. Esta política é recomendada para cenários que exigem alta segurança de dados para evitar perda acidental.
   allowVolumeExpansion		Suportado apenas pelo NAS de uso geral. Permite a expansão dinâmica de PVs criados por esta StorageClass modificando a capacidade do PVC. Esta StorageClass usa o recurso de cota de diretório do NAS para gerenciar a capacidade do PV, permitindo controle preciso de tamanho. Você pode expandir o volume online editando o campo spec.resources.requests.storage do PVC. Para mais informações, consulte Definir cotas de diretório para volumes NAS dinâmicos. As cotas de diretório do NAS entram em vigor de forma assíncrona. Se você realizar escritas de dados em grande volume e alta velocidade imediatamente após a criação ou expansão de um PV, poderá exceder a capacidade especificada porque a cota ainda não foi totalmente aplicada. Para mais informações, consulte Limites de uso.

2. Crie a StorageClass.

   kubectl create -f alicloud-nas-subpath.yaml

Console

1. Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Volumes > StorageClasses.

3. Clique em Create, especifique um nome exclusivo para a StorageClass dentro do cluster, selecione NAS como o PV Type e siga as instruções na tela para criar a StorageClass.

   Os principais parâmetros estão descritos na tabela a seguir.

   Parâmetro	Descrição
   Select Mount Target	O destino de montagem do sistema de arquivos NAS.
   Volume Mode	O modo de provisionamento do volume. Selecione Subdirectory. Um subpath é criado automaticamente sob o caminho de montagem especificado. Os dados são armazenados em <NAS mount target>:<mount path>/<pv-name>/.
   Mount Path	O subdiretório do NAS a ser montado. Se este parâmetro não for especificado, o diretório raiz será montado por padrão. Se o diretório não existir no sistema de arquivos NAS, ele será criado automaticamente e depois montado. NAS de uso geral: O diretório raiz é /. Extreme NAS: O diretório raiz é /share. Ao montar um subdiretório, o path deve começar com /share, como /share/data.
   Reclaim Policy	A política de recuperação do PV. Delete (padrão): Quando o PVC é excluído, os dados do armazenamento de backend são processados com base na configuração archiveOnDelete. Retain: Quando o PVC é excluído, o PV e os dados no sistema de arquivos NAS não são excluídos e devem ser removidos manualmente. Esta política é recomendada para cenários que exigem alta segurança de dados para evitar perda acidental.
   Mount Options	As opções de montagem para o NAS, incluindo a versão do protocolo NFS. Por padrão, os volumes são montados usando NFSv3. Você pode especificar uma versão diferente com uma opção como vers=4.0. Para informações sobre os protocolos NFS suportados por diferentes tipos de NAS, consulte Protocolos NFS.

   Após a criação da StorageClass, você pode visualizá-la na lista StorageClasses.

kubectl

1. Crie um arquivo chamado nas-pvc.yaml com o seguinte conteúdo:

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata: 
     name: nas-csi-pvc
   spec:
     accessModes:
     - ReadWriteMany 
     # Specify the StorageClass to use.
     storageClassName: alicloud-nas-subpath  
     resources: 
       requests:
         # Declare the required capacity of the storage volume.
         storage: 20Gi  

   Parâmetro	Descrição
   accessModes	O modo de acesso. Valores válidos: ReadWriteMany (padrão): O volume pode ser montado como leitura e escrita por vários nós. ReadWriteOnce: O volume pode ser montado como leitura e escrita por um único nó. ReadOnlyMany: O volume pode ser montado como somente leitura por vários nós.
   storageClassName	O nome da StorageClass a ser usada.
   storage	A capacidade necessária do volume de armazenamento. Por padrão, esta declaração atua como uma solicitação de recurso e não limita o espaço de armazenamento real disponível para o pod. O limite de capacidade de um sistema de arquivos NAS é determinado por suas especificações. Para mais informações, consulte NAS de uso geral e Extreme NAS. No entanto, quando allowVolumeExpansion na StorageClass está definido como true, este valor torna-se um limite rígido estritamente aplicado. O plug-in CSI define a cota de diretório do NAS com base nesta configuração para limitar a capacidade disponível do PV.

2. Crie o PVC.

   kubectl create -f nas-pvc.yaml

3. Verifique o PV.

   kubectl get pv

   A saída esperada é semelhante à seguinte, mostrando que a StorageClass provisionou automaticamente um PersistentVolume (PV) e o vinculou ao PVC.

   NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                 STORAGECLASS             VOLUMEATTRIBUTESCLASS   REASON   AGE
   nas-a7540d97-0f53-4e05-b7d9-557309******   20Gi       RWX            Retain           Bound    default/nas-csi-pvc   alicloud-nas-subpath     <unset>                          5m

Console

1. No painel de navegação à esquerda da página de gerenciamento do cluster, escolha Storage > PVCs.

2. Na página Persistent Volume Claims, clique em Create, configure os parâmetros do PVC e clique em Create.

   Parâmetro	Descrição
   PVC Type	Selecione NAS.
   Name	O nome do PVC. O nome deve ser exclusivo dentro do namespace.
   Allocation Mode	Selecione Use StorageClass.
   Existing Storage Class	Clique em Select Storage Class e escolha a StorageClass que você criou.
   Total Capacity	A capacidade necessária do volume de armazenamento. Por padrão, esta declaração atua como uma solicitação de recurso e não limita o espaço de armazenamento real disponível para o pod. O limite de capacidade de um sistema de arquivos NAS é determinado por suas especificações. Para mais informações, consulte NAS de uso geral e Extreme NAS. No entanto, quando allowVolumeExpansion na StorageClass está definido como true, este valor torna-se um limite rígido estritamente aplicado. O plug-in CSI define a cota de diretório do NAS com base nesta configuração para limitar a capacidade disponível do PV.
   Access Mode	O modo de acesso. Valores válidos: ReadWriteMany (padrão): O volume pode ser montado como leitura e escrita por vários nós. ReadWriteOnce: O volume pode ser montado como leitura e escrita por um único nó. ReadOnlyMany: O volume pode ser montado como somente leitura por vários nós.

kubectl

Crie dois Deployments que referenciem o mesmo PVC para permitir que eles compartilhem o mesmo subpath do sistema de arquivos NAS.

Para montar subpaths diferentes do mesmo sistema de arquivos NAS em pods diferentes, você deve criar uma StorageClass exclusiva e um PVC correspondente para cada subpath.

1. Crie dois arquivos chamados nginx-1.yaml e nginx-2.yaml com o seguinte conteúdo.

   As configurações para ambas as aplicações são quase idênticas. Ambas referenciam o mesmo PVC.

   • nginx-1.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test-1     
       labels:
         app: 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
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 # The mount path for the NAS volume inside the container.
                 mountPath: "/data"          
           volumes:
             - name: nas-pvc                 
               persistentVolumeClaim:
                 # Reference the previously created PVC.
                 claimName: nas-csi-pvc      

   • nginx-2.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test-2     
       labels:
         app: 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
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 # The mount path for the NAS volume inside the container.
                 mountPath: "/data"           
           volumes:
             - name: nas-pvc                 
               persistentVolumeClaim:
                 # Reference the previously created PVC.
                 claimName: nas-csi-pvc       

2. Crie os dois Deployments.

   kubectl create -f nginx-1.yaml -f nginx-2.yaml

3. Verifique o status dos pods.

   kubectl get pod -l app=nginx

   Saída esperada:

   NAME                         READY   STATUS    RESTARTS   AGE
   nas-test-1-b75d5b6bc-*****   1/1     Running   0          51s
   nas-test-2-b75d5b6bc-*****   1/1     Running   0          44s

4. Inspecione cada pod para verificar se ele usa o PersistentVolumeClaim (PVC) correto.

   Substitua <podName> pelo nome real de cada pod.

   kubectl describe pod <podName> | grep "ClaimName:"

   Na saída esperada, ambos os pods usam o mesmo PVC, o que confirma que eles compartilham o mesmo subpath do sistema de arquivos NAS.

Console

Repita as etapas a seguir para criar dois Deployments que usam o mesmo PVC, o que permite que eles compartilhem o mesmo subpath do sistema de arquivos NAS.

1. Na página Clusters do ACK, clique no nome do seu cluster. No painel de navegação à esquerda, clique em > Deployments.

2. Clique em Create from Image e siga as instruções na tela para configurar e criar a aplicação.

   Os principais parâmetros estão descritos abaixo. Você pode manter os valores padrão para outros parâmetros. Para mais informações, consulte Criar uma aplicação stateless (Deployment).

   Seção	Parâmetro	Descrição
   Basic Information	Replicas:	O número de réplicas para o Deployment.
   Container	Image	O endereço da imagem usada para implantar a aplicação.
   	Required Resources	Os recursos de vCPU e memória necessários pelo contêiner.
   	Volumes	Clique em Add PVC e configure os parâmetros. Mount Source: Selecione o PVC que você criou. Container Path: Insira o caminho dentro do contêiner onde o sistema de arquivos NAS será montado.

   Após a conclusão da implantação, você pode clicar no nome da aplicação na página Deployments e verificar a aba Pods para confirmar que os pods estão executando normalmente (seu status é Running).

kubectl

Console

1. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Volumes > StorageClasses.

2. Clique em Create, especifique um nome exclusivo para a StorageClass e selecione NAS como o PV Type.

   Parâmetro	Descrição
   Select Mount Target	O destino de montagem do sistema de arquivos NAS.
   Volume Mode	O modo de provisionamento do volume. Neste exemplo, selecione Shared Directory, que habilita o modo sharepath.
   Mount Path	O subdiretório do NAS a ser montado. Se este parâmetro não for especificado, o diretório raiz será montado por padrão. Se o diretório não existir no sistema de arquivos NAS, ele será criado automaticamente e depois montado. NAS de uso geral: O diretório raiz é /. Extreme NAS: O diretório raiz é /share. Ao montar um subdiretório, o path deve começar com /share, como /share/data.
   Reclaim policy	Para o modo sharepath, deve ser Retain.
   Mount options	As opções de montagem para o NAS, incluindo a versão do protocolo NFS. Por padrão, os volumes são montados usando NFSv3. Você pode especificar uma versão diferente com uma opção como vers=4.0. Para informações sobre os protocolos NFS suportados por diferentes tipos de NAS, consulte Protocolos NFS.

kubectl

1. Crie dois namespaces, ns1 e ns2.

   kubectl create ns ns1
   kubectl create ns ns2

2. Crie um arquivo chamado pvc.yaml com o seguinte conteúdo para criar um PVC com o mesmo nome nos namespaces ns1 e ns2.

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata: 
     name: nas-csi-pvc
     namespace: ns1
   spec:
     accessModes:
     - ReadWriteMany 
     storageClassName: alicloud-nas-sharepath
     resources: 
       requests:
         storage: 20Gi
   ---
   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata: 
     name: nas-csi-pvc
     namespace: ns2
   spec:
     accessModes:
     - ReadWriteMany 
     storageClassName: alicloud-nas-sharepath
     resources: 
       requests:
         storage: 20Gi

   Parâmetro	Descrição
   accessModes	O modo de acesso. Valores válidos: ReadWriteMany (padrão): O volume pode ser montado como leitura e escrita por vários nós. ReadWriteOnce: O volume pode ser montado como leitura e escrita por um único nó. ReadOnlyMany: O volume pode ser montado como somente leitura por vários nós.
   storageClassName	O nome da StorageClass a ser usada.
   storage	A capacidade necessária do volume de armazenamento. Por padrão, esta declaração atua como uma solicitação de recurso e não limita o espaço de armazenamento real disponível para o pod. O limite de capacidade de um sistema de arquivos NAS é determinado por suas especificações. Para mais informações, consulte NAS de uso geral e Extreme NAS. No entanto, quando allowVolumeExpansion na StorageClass está definido como true, este valor torna-se um limite rígido estritamente aplicado. O plug-in CSI define a cota de diretório do NAS com base nesta configuração para limitar a capacidade disponível do PV.

3. Crie os PVCs.

   kubectl create -f pvc.yaml

4. Verifique o status do PV para confirmar que os PVs foram criados automaticamente e vinculados aos PVCs.

   kubectl get pv

   A saída esperada é semelhante à seguinte. O status de ambos os PVs é Bound, e a coluna CLAIM mostra que cada PV está vinculado a um PVC em um namespace diferente (ns1/nas-csi-pvc e ns2/nas-csi-pvc).

   NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                 STORAGECLASS             VOLUMEATTRIBUTESCLASS   REASON   AGE
   nas-0b448885-6226-4d22-8a5b-d0768c******   20Gi       RWX            Retain           Bound    ns1/nas-csi-pvc       alicloud-nas-sharepath   <unset>                          74s
   nas-bcd21c93-8219-4a11-986b-fd934a******   20Gi       RWX            Retain           Bound    ns2/nas-csi-pvc       alicloud-nas-sharepath   <unset>                          74s

Console

1. Crie namespaces.

   • Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Namespaces and Quotas.

   • Clique em Launch e siga as instruções na tela para criar os namespaces ns1 e ns2.

2. No painel de navegação à esquerda da página de gerenciamento do cluster, escolha Storage > PVCs.

3. No namespace ns1, crie uma solicitação de armazenamento.

   Na página Persistent Volume Claims, selecione ns1 na lista suspensa Namespace e siga as instruções na tela para criar o PVC.

   Parâmetro	Descrição
   PVC Type	Selecione NAS.
   Name	O nome do PVC. O nome deve ser exclusivo dentro do namespace.
   Allocation Mode	Selecione Use StorageClass.
   Existing Storage Class	Clique em Select Storage Class e escolha a StorageClass que você criou.
   Capacity	A capacidade necessária do volume de armazenamento. Por padrão, esta declaração atua como uma solicitação de recurso e não limita o espaço de armazenamento real disponível para o pod. O limite de capacidade de um sistema de arquivos NAS é determinado por suas especificações. Para mais informações, consulte NAS de uso geral e Extreme NAS. No entanto, quando allowVolumeExpansion na StorageClass está definido como true, este valor torna-se um limite rígido estritamente aplicado. O plug-in CSI define a cota de diretório do NAS com base nesta configuração para limitar a capacidade disponível do PV.
   Access Mode	O modo de acesso. Valores válidos: ReadWriteMany (padrão): O volume pode ser montado como leitura e escrita por vários nós. ReadWriteOnce: O volume pode ser montado como leitura e escrita por um único nó. ReadOnlyMany: O volume pode ser montado como somente leitura por vários nós.

4. Siga a etapa anterior para criar outro PVC no namespace ns2.

   Após a criação, retorne à página Persistent Volume Claims. Nos namespaces ns1 e ns2, confirme que ambos os PVCs estão vinculados aos seus PVs criados automaticamente.

kubectl

1. Crie dois arquivos chamados nginx-ns1.yaml e nginx-ns2.yaml com o seguinte conteúdo.

   As configurações para ambas as aplicações são quase idênticas. Cada uma se vincula ao PVC em seu respectivo namespace.

   • nginx-ns1.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test
       namespace: ns1   
     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
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 mountPath: "/data"
           volumes:
             - name: nas-pvc
               persistentVolumeClaim:
                 claimName: nas-csi-pvc

   • nginx-ns2.yaml

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: nas-test
       namespace: ns2   
     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
             ports:
             - containerPort: 80
             volumeMounts:
               - name: nas-pvc
                 mountPath: "/data"
           volumes:
             - name: nas-pvc
               persistentVolumeClaim:
                 claimName: nas-csi-pvc

2. Crie os dois Deployments.

   kubectl create -f nginx-ns1.yaml -f nginx-ns2.yaml

3. Verifique o status do Pod.

   kubectl get pod -A -l app=nginx

   Saída esperada:

   NAMESPACE   NAME                         READY   STATUS    RESTARTS   AGE
   ns1         nas-test-b75d5b6bc-*****     1/1     Running   0          2m19s
   ns2         nas-test-b75d5b6bc-*****     1/1     Running   0          2m11s

4. Verifique a configuração detalhada de um Pod para confirmar a montagem do PVC.

   Substitua <namespace-name> e <pod-name> pelo namespace e nome do Pod reais.

   kubectl describe pod -n <namespace-name> <pod-name> | grep "ClaimName:"

   Na saída esperada, os dois Pods montam ns1/nas-csi-pvc e ns2/nas-csi-pvc respectivamente.

Console

1. Na página Clusters do ACK, clique no nome do seu cluster. No painel de navegação à esquerda, clique em > Deployments.

2. No namespace ns1, crie um Deployment e monte o PVC correspondente.

   1. Selecione Namespace na lista suspensa Namespace e clique em Create from Image.

   2. Siga as instruções na tela para criar a aplicação.

      Os principais parâmetros estão descritos abaixo. Mantenha os outros parâmetros com seus valores padrão. Para mais informações, consulte Criar um workload stateless (Deployment).

      Seção	Parâmetro	Descrição
      Basic Information	Replicas:	A contagem de réplicas do Deployment.
      Container	Image	O endereço da imagem usada para implantar a aplicação.
      	Required Resources	Os recursos de vCPU e memória necessários.
      	Volumes	Clique em Add PVC e configure os parâmetros. Mount Source: Selecione o PVC que você criou. Container Path: Insira o caminho dentro do contêiner onde o sistema de arquivos NAS será montado, como /data.

3. Siga a etapa anterior para criar outro Deployment no namespace ns2 e montar o PVC correspondente.

   Retorne à página Deployments . Nos namespaces ns1 e ns2 , verifique o status de cada Deployment para confirmar que os Pods estão em execução e montaram os PVCs corretos.