Container Service for Kubernetes:Use NAS dynamic volumes

kubectl

1. Cree un archivo llamado alicloud-nas-subpath.yaml con el siguiente contenido:

   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		Descripción
   mountOptions		Las opciones de montaje para NAS, incluida la versión del protocolo NFS. De forma predeterminada, los volúmenes se montan con NFSv3. Puede especificar una versión distinta con una opción como vers=4.0. Para obtener información sobre los protocolos NFS compatibles con los distintos tipos de NAS, consulte NFS protocols.
   parameters.volumeAs		El modo de aprovisionamiento del volumen. Establézcalo en subpath.
   parameters.server		El destino de montaje de NAS y la subruta que se va a montar, con el formato <nas-server-address>:/<path>. <nas-server-address>: el destino de montaje del sistema de archivos NAS. Para obtener más información, consulte Manage mount targets. :/<path>: la subruta de NAS que se va a montar. Si no se establece este parámetro o la subruta especificada no existe, se monta el directorio raíz de forma predeterminada. NAS de propósito general: el directorio raíz es /. Extreme NAS: el directorio raíz es /share. Cuando monte una subruta, el valor de path debe comenzar con /share, por ejemplo, /share/data.
   parameters.archiveOnDelete		Indica si se eliminan los datos del almacenamiento del backend cuando se elimina un PVC y su reclaimPolicy está establecido en Delete. Esta opción actúa como medida de protección para evitar la pérdida accidental de datos en el almacenamiento NAS compartido. true (predeterminado): el directorio y sus archivos no se eliminan. En su lugar, se archivan y se les cambia el nombre con el formato archived-{pvName}.{timestamp}. false: el directorio correspondiente y sus datos se eliminan de forma permanente. Esta operación elimina la subruta de NAS y sus archivos, no el sistema de archivos NAS en sí. Para eliminar un sistema de archivos NAS, consulte Delete a file system. En escenarios donde los PV se crean y eliminan con frecuencia, establecer este parámetro en false puede bloquear la cola de tareas del controlador CSI, lo que impide crear nuevos PV. Para obtener más información, consulte The controller's task queue is full and new PVs cannot be created when you use a dynamic NAS volume.
   provisioner		El controlador. Establezca este parámetro en nasplugin.csi.alibabacloud.com cuando use el plugin de CSI de NAS de Alibaba Cloud.
   reclaimPolicy		La directiva de recuperación del PV. Delete (predeterminado): cuando se elimina el PVC, los datos del almacenamiento del backend se procesan según la configuración de archiveOnDelete. Retain: cuando se elimina el PVC, el PV y los datos del sistema de archivos NAS no se eliminan, por lo que deben eliminarse manualmente. Se recomienda esta directiva para escenarios que requieren alta seguridad de datos y así evitar pérdidas accidentales.
   allowVolumeExpansion		Compatible únicamente con NAS de propósito general. Permite expandir dinámicamente los PV creados por este StorageClass al modificar la capacidad del PVC. Este StorageClass utiliza la función directory quota de NAS para gestionar la capacidad del PV, lo que permite un control preciso del tamaño. Puede expandir el volumen en línea si edita el campo spec.resources.requests.storage del PVC. Para obtener más información, consulte Set directory quotas for dynamic NAS volumes. Las cuotas de directorio de NAS se aplican de forma asíncrona. Si ejecuta escrituras de datos rápidas y de gran volumen inmediatamente después de crear o expandir un PV, podría superar la capacidad especificada porque la cuota aún no se aplica por completo. Para obtener más información, consulte Usage limits.

2. Cree el StorageClass.

   kubectl create -f alicloud-nas-subpath.yaml

Console

1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Volumes > StorageClasses.

3. Haga clic en Create, especifique un nombre único para el StorageClass dentro del clúster, seleccione NAS como PV Type y siga las instrucciones en pantalla para crear el StorageClass.

   A continuación se describen los parámetros clave.

   Parámetro	Descripción
   Select Mount Target	El destino de montaje del sistema de archivos NAS.
   Volume Mode	El modo de aprovisionamiento del volumen. Seleccione Subdirectory. Se crea automáticamente una subruta bajo la ruta de montaje especificada. Los datos se almacenan en <NAS mount target>:<mount path>/<pv-name>/.
   Mount Path	El subdirectorio de NAS que se va a montar. Si no se especifica este parámetro, se monta el directorio raíz de forma predeterminada. Si el directorio no existe en el sistema de archivos NAS, se crea automáticamente y luego se monta. NAS de propósito general: el directorio raíz es /. Extreme NAS: el directorio raíz es /share. Cuando monte un subdirectorio, el valor de path debe comenzar con /share, por ejemplo, /share/data.
   Reclaim Policy	La directiva de recuperación del PV. Delete (predeterminado): cuando se elimina el PVC, los datos del almacenamiento del backend se procesan según la configuración de archiveOnDelete. Retain: cuando se elimina el PVC, el PV y los datos del sistema de archivos NAS no se eliminan, por lo que deben eliminarse manualmente. Se recomienda esta directiva para escenarios que requieren alta seguridad de datos y así evitar pérdidas accidentales.
   Mount Options	Las opciones de montaje para NAS, incluida la versión del protocolo NFS. De forma predeterminada, los volúmenes se montan con NFSv3. Puede especificar una versión distinta con una opción como vers=4.0. Para obtener información sobre los protocolos NFS compatibles con los distintos tipos de NAS, consulte NFS protocols.

   Una vez creado el StorageClass, podrá consultarlo en la lista StorageClasses.

kubectl

1. Cree un archivo llamado nas-pvc.yaml con el siguiente contenido:

   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	Descripción
   accessModes	El modo de acceso. Valores válidos: ReadWriteMany (predeterminado): varios nodos pueden montar el volumen con permisos de lectura y escritura. ReadWriteOnce: un solo nodo puede montar el volumen con permisos de lectura y escritura. ReadOnlyMany: varios nodos pueden montar el volumen con permisos de solo lectura.
   storageClassName	El nombre del StorageClass que se va a usar.
   storage	La capacidad requerida del volumen de almacenamiento. De forma predeterminada, esta declaración actúa como una solicitud de recursos y no limita el espacio de almacenamiento real disponible para el pod. El límite de capacidad de un sistema de archivos NAS se determina según sus especificaciones. Para obtener más información, consulte General-purpose NAS y Extreme NAS. Sin embargo, cuando allowVolumeExpansion en el StorageClass se establece en true, este valor se convierte en un límite estricto. El plugin de CSI establece la cuota del directorio NAS con base en esta configuración para limitar la capacidad disponible del PV.

2. Cree el PVC.

   kubectl create -f nas-pvc.yaml

3. Compruebe el PV.

   kubectl get pv

   El resultado esperado es similar al siguiente, lo que indica que el StorageClass aprovisionó automáticamente un PersistentVolume (PV) y lo vinculó al 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. En el panel de navegación izquierdo de la página de gestión del clúster, elija Storage > PVCs.

2. En la página Persistent Volume Claims, haga clic en Create, configure los parámetros del PVC y luego haga clic en Create.

   Parámetro	Descripción
   PVC Type	Seleccione NAS.
   Name	El nombre del PVC. Debe ser único dentro del namespace.
   Allocation Mode	Seleccione Use StorageClass.
   Existing Storage Class	Haga clic en Select Storage Class y elija el StorageClass que creó.
   Total Capacity	La capacidad requerida del volumen de almacenamiento. De forma predeterminada, esta declaración actúa como una solicitud de recursos y no limita el espacio de almacenamiento real disponible para el pod. El límite de capacidad de un sistema de archivos NAS se determina según sus especificaciones. Para obtener más información, consulte General-purpose NAS y Extreme NAS. Sin embargo, cuando allowVolumeExpansion en el StorageClass se establece en true, este valor se convierte en un límite estricto. El plugin de CSI establece la cuota del directorio NAS con base en esta configuración para limitar la capacidad disponible del PV.
   Access Mode	El modo de acceso. Valores válidos: ReadWriteMany (predeterminado): varios nodos pueden montar el volumen con permisos de lectura y escritura. ReadWriteOnce: un solo nodo puede montar el volumen con permisos de lectura y escritura. ReadOnlyMany: varios nodos pueden montar el volumen con permisos de solo lectura.

kubectl

Cree dos Deployments que hagan referencia al mismo PVC para permitirles compartir la misma subruta del sistema de archivos NAS.

Para montar distintas subrutas del mismo sistema de archivos NAS en diferentes pods, debe crear un StorageClass único y su PVC correspondiente para cada subruta.

1. Cree dos archivos llamados nginx-1.yaml y nginx-2.yaml con a continuación contenido.

   Las configuraciones de ambas aplicaciones son casi idénticas. Ambas hacen referencia al mismo 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. Cree los dos Deployments.

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

3. Compruebe el estado de los pods.

   kubectl get pod -l app=nginx

   Salida 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. Inspeccione cada pod para comprobar que utiliza el PersistentVolumeClaim (PVC) correcto.

   Reemplace <podName> por el nombre real de cada pod.

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

   En la salida esperada, ambos pods utilizan el mismo PVC. Esto confirma que comparten la misma subruta del sistema de archivos NAS.

Console

Repita a continuación pasos para crear dos Deployments que utilicen el mismo PVC. De este modo, podrán compartir la misma subruta del sistema de archivos NAS.

1. En la página ACK Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workloads > Deployments.

2. Haga clic en y siga las instrucciones en pantalla para configurar y crear la aplicación.

   A continuación se describen los parámetros clave. Puede conservar los valores predeterminados para el resto de los parámetros. Para obtener más información, consulte Create a stateless application (Deployment).

   Sección	Parámetro	Descripción
   Basic Information	Replicas:	El número de réplicas del Deployment.
   Container	Image	La dirección de la imagen utilizada para desplegar la aplicación.
   	Required Resources	Los recursos de vCPU y memoria que requiere el contenedor.
   	Volumes	Haga clic en Add PVC y configure los parámetros. Mount Source: seleccione el PVC que creó. Container Path: introduzca la ruta dentro del contenedor donde se montará el sistema de archivos NAS.

   Cuando finalice el despliegue, haga clic en el nombre de la aplicación en la página Deployments y compruebe la pestaña Pods para confirmar que los pods se ejecutan correctamente (su estado es Running).

kubectl

Console

1. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Volumes > StorageClasses.

2. Haga clic en Create, especifique un nombre único para el StorageClass y seleccione NAS como PV Type.

   Parámetro	Descripción
   Select Mount Target	El destino de montaje del sistema de archivos NAS.
   Volume Mode	El modo de aprovisionamiento del volumen. En este ejemplo, seleccione Shared Directory, que habilita el modo sharepath.
   Mount Path	El subdirectorio de NAS que se va a montar. Si no se especifica este parámetro, se monta el directorio raíz de forma predeterminada. Si el directorio no existe en el sistema de archivos NAS, se crea automáticamente y luego se monta. NAS de uso general: el directorio raíz es /. Extreme NAS: el directorio raíz es /share. Al montar un subdirectorio, el valor de path debe comenzar con /share, por ejemplo, /share/data.
   Reclaim policy	Para el modo sharepath, debe ser Retain.
   Mount options	Las opciones de montaje para NAS, incluida la versión del protocolo NFS. De forma predeterminada, los volúmenes se montan con NFSv3. Puede especificar una versión distinta con una opción como vers=4.0. Para obtener información sobre los protocolos NFS compatibles con los distintos tipos de NAS, consulte NFS protocols.

kubectl

1. Cree dos namespaces, ns1 y ns2.

   kubectl create ns ns1
   kubectl create ns ns2

2. Cree un archivo llamado pvc.yaml con a continuación contenido para crear un PVC con el mismo nombre en los namespaces ns1 y 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	Descripción
   accessModes	El modo de acceso. Valores válidos: ReadWriteMany (predeterminado): varios nodos pueden montar el volumen con permisos de lectura y escritura. ReadWriteOnce: un solo nodo puede montar el volumen con permisos de lectura y escritura. ReadOnlyMany: varios nodos pueden montar el volumen con permisos de solo lectura.
   storageClassName	El nombre del StorageClass que se va a utilizar.
   storage	La capacidad requerida del volumen de almacenamiento. De forma predeterminada, esta declaración actúa como una solicitud de recursos y no limita el espacio de almacenamiento real disponible para el pod. El límite de capacidad de un sistema de archivos NAS depende de sus especificaciones. Para obtener más información, consulte General-purpose NAS y Extreme NAS. Sin embargo, cuando allowVolumeExpansion en el StorageClass se establece en true, este valor se convierte en un límite estricto. El complemento CSI establece la cuota del directorio de NAS según esta configuración para limitar la capacidad disponible del PV.

3. Cree los PVC.

   kubectl create -f pvc.yaml

4. Compruebe el estado de los PV para confirmar que se crearon automáticamente y se vincularon a los PVC.

   kubectl get pv

   La salida esperada es similar a la siguiente. El estado de ambos PV es Bound, y la columna CLAIM muestra que cada PV está vinculado a un PVC en un namespace distinto (ns1/nas-csi-pvc y 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. Cree los namespaces.

   • En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Namespaces and Quotas.

   • Haga clic en Launch y siga las instrucciones en pantalla para crear los namespaces ns1 y ns2.

2. En el panel de navegación izquierdo de la página de gestión del clúster, elija Storage > PVCs.

3. En el namespace ns1, cree una solicitud de almacenamiento.

   En la página Persistent Volume Claims, seleccione ns1 en la lista desplegable Namespace y siga las instrucciones en pantalla para crear el PVC.

   Parámetro	Descripción
   PVC Type	Seleccione NAS.
   Name	El nombre del PVC. El nombre debe ser único dentro del namespace.
   Allocation Mode	Seleccione Use StorageClass.
   Existing Storage Class	Haga clic en Select Storage Class y elija el StorageClass que creó.
   Capacity	La capacidad requerida del volumen de almacenamiento. De forma predeterminada, esta declaración actúa como una solicitud de recursos y no limita el espacio de almacenamiento real disponible para el pod. El límite de capacidad de un sistema de archivos NAS depende de sus especificaciones. Para obtener más información, consulte General-purpose NAS y Extreme NAS. Sin embargo, cuando allowVolumeExpansion en el StorageClass se establece en true, este valor se convierte en un límite estricto. El complemento CSI establece la cuota del directorio de NAS según esta configuración para limitar la capacidad disponible del PV.
   Access Mode	El modo de acceso. Valores válidos: ReadWriteMany (predeterminado): varios nodos pueden montar el volumen con permisos de lectura y escritura. ReadWriteOnce: un solo nodo puede montar el volumen con permisos de lectura y escritura. ReadOnlyMany: varios nodos pueden montar el volumen con permisos de solo lectura.

4. Siga el paso anterior para crear otro PVC en el namespace ns2.

   Después de la creación, vuelva a la página Persistent Volume Claims. En los namespaces ns1 y ns2, confirme que ambos PVC están vinculados a sus PV creados automáticamente.

kubectl

1. Cree dos archivos llamados nginx-ns1.yaml y nginx-ns2.yaml con a continuación contenido.

   Las configuraciones de ambas aplicaciones son casi idénticas. Cada una se vincula al PVC de su 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. Cree los dos Deployments.

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

3. Compruebe el estado de los pods.

   kubectl get pod -A -l app=nginx

   Salida 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. Revise la configuración detallada de un pod para confirmar el montaje del PVC.

   Reemplace <namespace-name> y <pod-name> por el namespace y el nombre reales del pod.

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

   En la salida esperada, los dos pods montan ns1/nas-csi-pvc y ns2/nas-csi-pvc, respectivamente.

Console

1. En la página ACK Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workloads > Deployments.

2. En el namespace ns1, cree un Deployment y monte el PVC correspondiente.

   1. Seleccione Namespace en la lista desplegable Namespace y haga clic en Create from Image.

   2. Siga las instrucciones en pantalla para crear la aplicación.

      A continuación se describen los parámetros clave. Conserve los valores predeterminados para el resto de los parámetros. Para obtener más información, consulte Create a stateless workload (Deployment).

      Sección	Parámetro	Descripción
      Basic Information	Replicas:	El número de réplicas del Deployment.
      Container	Image	La dirección de la imagen utilizada para desplegar la aplicación.
      	Required Resources	Los recursos de vCPU y memoria necesarios.
      	Volumes	Haga clic en Add PVC y configure los parámetros. Mount Source: seleccione el PVC que creó. Container Path: introduzca la ruta dentro del contenedor donde se montará el sistema de archivos NAS, por ejemplo, /data.

3. Siga el paso anterior para crear otro Deployment en el namespace ns2 y monte el PVC correspondiente.

   Vuelva a la página Deployments . En los namespaces ns1 y ns2 , compruebe el estado de cada Deployment para confirmar que los pods se están ejecutando y que han montado los PVC correctos.