Container Service for Kubernetes:Use NAS dynamic volumes

kubectl

1. Créez un fichier nommé alicloud-nas-subpath.yaml avec le contenu suivant :

   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

   Paramètre		Description
   mountOptions		Les options de montage pour NAS, y compris la version du protocole NFS. Par défaut, les volumes sont montés en utilisant NFSv3. Vous pouvez spécifier une autre version avec une option telle que vers=4,0. Pour plus d'informations sur les protocoles NFS pris en charge par les différents types de NAS, consultez la rubrique Protocoles NFS.
   parameters.volumeAs		Le mode de provisionnement du volume. Définissez-le sur subpath.
   parameters.server		Le point de montage NAS et le sous-chemin à monter, au format <nas-server-address>:/<path>. <nas-server-address> : le point de montage du système de fichiers NAS. Pour plus d'informations, consultez la rubrique Gérer les points de montage. :/<path> : le sous-chemin NAS à monter. Si ce paramètre n'est pas défini ou si le sous-chemin spécifié n'existe pas, le répertoire racine est monté par défaut. NAS généraliste : le répertoire racine est /. Extreme NAS : le répertoire racine est /share. Lorsque vous montez un sous-chemin, le path doit commencer par /share, par exemple /share/data.
   parameters.archiveOnDelete		Indique s'il faut supprimer les données sur le stockage backend lorsqu'un PVC est supprimé et que sa reclaimPolicy est définie sur Delete. Cette option agit comme une mesure de sécurité pour éviter la perte accidentelle de données sur le stockage NAS partagé. true (par défaut) : le répertoire et ses fichiers ne sont pas supprimés. Ils sont archivés et renommés au format archived-{pvName}.{timestamp}. false : le répertoire correspondant et ses données sont définitivement supprimés. Cette opération supprime le sous-chemin NAS et ses fichiers, mais pas le système de fichiers NAS lui-même. Pour supprimer un système de fichiers NAS, consultez la rubrique Supprimer un système de fichiers. Dans les scénarios où les PV sont fréquemment créés et supprimés, définir ce paramètre sur false peut bloquer la file d'attente des tâches du contrôleur CSI, empêchant ainsi la création de nouveaux PV. Pour plus d'informations, consultez la rubrique La file d'attente des tâches du contrôleur est pleine et de nouveaux PV ne peuvent pas être créés lors de l'utilisation d'un volume NAS dynamique.
   provisioner		Le pilote. Définissez ce paramètre sur nasplugin.csi.alibabacloud.com lorsque vous utilisez le plug-in CSI Alibaba Cloud NAS.
   reclaimPolicy		La politique de récupération du PV. Delete (par défaut) : lorsque le PVC est supprimé, les données du stockage backend sont traitées en fonction du paramètre archiveOnDelete. Retain : lorsque le PVC est supprimé, le PV et les données du système de fichiers NAS ne sont pas supprimés et doivent l'être manuellement. Cette politique est recommandée pour les scénarios nécessitant une sécurité élevée des données afin d'éviter toute perte accidentelle.
   allowVolumeExpansion		Pris en charge uniquement par le NAS généraliste. Permet l'expansion dynamique des PV créés par cette StorageClass en modifiant la capacité du PVC. Cette StorageClass utilise la fonctionnalité de quota de répertoire NAS pour gérer la capacité des PV, permettant un contrôle précis de la taille. Vous pouvez étendre le volume en ligne en modifiant le champ spec.resources.requests.storage du PVC. Pour plus d'informations, consultez la rubrique Définir des quotas de répertoire pour les volumes NAS dynamiques. Les quotas de répertoire NAS s'appliquent de manière asynchrone. Si vous effectuez des écritures de données volumineuses à haute vitesse immédiatement après la création ou l'extension d'un PV, vous risquez de dépasser la capacité spécifiée car le quota n'est pas encore pleinement appliqué. Pour plus d'informations, consultez la rubrique Limites d'utilisation.

2. Créez la StorageClass.

   kubectl create -f alicloud-nas-subpath.yaml

Console

1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.

2. Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Volumes > StorageClasses.

3. Cliquez sur Create, spécifiez un nom unique pour la StorageClass au sein du cluster, sélectionnez NAS comme PV Type, puis suivez les instructions à l'écran pour créer la StorageClass.

   Les principaux paramètres sont décrits dans le tableau suivant.

   Paramètre	Description
   Select Mount Target	Le point de montage du système de fichiers NAS.
   Volume Mode	Le mode de provisionnement du volume. Sélectionnez Subdirectory. Un sous-chemin est automatiquement créé sous le chemin de montage spécifié. Les données sont stockées à l'emplacement <NAS mount target>:<mount path>/<pv-name>/.
   Mount Path	Le sous-répertoire NAS à monter. Si ce paramètre n'est pas spécifié, le répertoire racine est monté par défaut. Si le répertoire n'existe pas dans le système de fichiers NAS, il est automatiquement créé puis monté. NAS généraliste : le répertoire racine est /. Extreme NAS : le répertoire racine est /share. Lorsque vous montez un sous-répertoire, le path doit commencer par /share, par exemple /share/data.
   Reclaim Policy	La politique de récupération du PV. Delete (par défaut) : lorsque le PVC est supprimé, les données du stockage backend sont traitées en fonction du paramètre archiveOnDelete. Retain : lorsque le PVC est supprimé, le PV et les données du système de fichiers NAS ne sont pas supprimés et doivent l'être manuellement. Cette politique est recommandée pour les scénarios nécessitant une sécurité élevée des données afin d'éviter toute perte accidentelle.
   Mount Options	Les options de montage pour NAS, y compris la version du protocole NFS. Par défaut, les volumes sont montés en utilisant NFSv3. Vous pouvez spécifier une autre version avec une option telle que vers=4,0. Pour plus d'informations sur les protocoles NFS pris en charge par les différents types de NAS, consultez la rubrique Protocoles NFS.

   Une fois la StorageClass créée, vous pouvez la consulter dans la liste StorageClasses.

kubectl

1. Créez un fichier nommé nas-pvc.yaml avec le contenu suivant :

   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  

   Paramètre	Description
   accessModes	Le mode d'accès. Valeurs possibles : ReadWriteMany (par défaut) : le volume peut être monté en lecture-écriture par plusieurs nœuds. ReadWriteOnce : le volume peut être monté en lecture-écriture par un seul nœud. ReadOnlyMany : le volume peut être monté en lecture seule par plusieurs nœuds.
   storageClassName	Le nom de la StorageClass à utiliser.
   storage	La capacité requise du volume de stockage. Par défaut, cette déclaration agit comme une demande de ressource et ne limite pas l'espace de stockage réel disponible pour le pod. La limite de capacité d'un système de fichiers NAS est déterminée par ses spécifications. Pour plus d'informations, consultez les rubriques NAS généraliste et Extreme NAS. Toutefois, lorsque allowVolumeExpansion dans la StorageClass est défini sur true, cette valeur devient une limite stricte appliquée rigoureusement. Le plug-in CSI définit le quota de répertoire NAS en fonction de cette configuration pour limiter la capacité disponible du PV.

2. Créez le PVC.

   kubectl create -f nas-pvc.yaml

3. Vérifiez le PV.

   kubectl get pv

   Le résultat attendu est similaire à ce qui suit, indiquant que la StorageClass a automatiquement provisionné un PersistentVolume (PV) et l'a lié au 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. Dans le volet de navigation de gauche de la page de gestion du cluster, choisissez Storage > PVCs.

2. Sur la page Persistent Volume Claims, cliquez sur Create, configurez les paramètres du PVC, puis cliquez sur Create.

   Paramètre	Description
   PVC Type	Sélectionnez NAS.
   Name	Le nom du PVC. Le nom doit être unique au sein du namespace.
   Allocation Mode	Sélectionnez Use StorageClass.
   Existing Storage Class	Cliquez sur Select Storage Class et choisissez la StorageClass que vous avez créée.
   Total Capacity	La capacité requise du volume de stockage. Par défaut, cette déclaration agit comme une demande de ressource et ne limite pas l'espace de stockage réel disponible pour le pod. La limite de capacité d'un système de fichiers NAS est déterminée par ses spécifications. Pour plus d'informations, consultez les rubriques NAS généraliste et Extreme NAS. Toutefois, lorsque allowVolumeExpansion dans la StorageClass est défini sur true, cette valeur devient une limite stricte appliquée rigoureusement. Le plug-in CSI définit le quota de répertoire NAS en fonction de cette configuration pour limiter la capacité disponible du PV.
   Access Mode	Le mode d'accès. Valeurs possibles : ReadWriteMany (par défaut) : le volume peut être monté en lecture-écriture par plusieurs nœuds. ReadWriteOnce : le volume peut être monté en lecture-écriture par un seul nœud. ReadOnlyMany : le volume peut être monté en lecture seule par plusieurs nœuds.

kubectl

Créez deux Deployments qui référencent le même PVC pour leur permettre de partager le même sous-chemin du système de fichiers NAS.

Pour monter différents sous-chemins du même système de fichiers NAS sur différents pods, vous devez créer une StorageClass unique et un PVC correspondant pour chaque sous-chemin.

1. Créez deux fichiers nommés nginx-1.yaml et nginx-2.yaml avec le contenu suivant.

   Les configurations des deux applications sont presque identiques. Elles référencent toutes deux le même 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. Créez les deux Deployments.

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

3. Vérifiez l'état des pods.

   kubectl get pod -l app=nginx

   Résultat attendu :

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

4. Inspectez chaque pod pour vérifier qu'il utilise le bon PersistentVolumeClaim (PVC).

   Remplacez <podName> par le nom réel de chaque pod.

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

   Dans le résultat attendu, les deux pods utilisent le même PVC, ce qui confirme qu'ils partagent le même sous-chemin du système de fichiers NAS.

Console

Répétez les étapes suivantes pour créer deux Deployments qui utilisent le même PVC, ce qui leur permet de partager le même sous-chemin du système de fichiers NAS.

1. Sur la page Clusters ACK, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Workloads > Deployments.

2. Cliquez sur Create from Image et suivez les instructions à l'écran pour configurer et créer l'application.

   Les principaux paramètres sont décrits ci-dessous. Vous pouvez conserver les valeurs par défaut pour les autres paramètres. Pour plus d'informations, consultez la rubrique Créer une application sans état (Deployment).

   Section	Paramètre	Description
   Basic Information	Replicas:	Le nombre de réplicas pour le Deployment.
   Container	Image	L'adresse de l'image utilisée pour déployer l'application.
   	Required Resources	Les ressources vCPU et mémoire requises par le conteneur.
   	Volumes	Cliquez sur Add PVC puis configurez les paramètres. Mount Source : sélectionnez le PVC que vous avez créé. Container Path : saisissez le chemin au sein du conteneur où le système de fichiers NAS sera monté.

   Une fois le déploiement terminé, vous pouvez cliquer sur le nom de l'application sur la page Deployments et vérifier l'onglet Pods pour confirmer que les pods fonctionnent correctement (leur statut est Running).

kubectl

Console

1. Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Volumes > StorageClasses.

2. Cliquez sur Create, spécifiez un nom unique pour la StorageClass et sélectionnez NAS comme PV Type.

   Paramètre	Description
   Select Mount Target	La cible de montage du système de fichiers NAS.
   Volume Mode	Le mode de provisionnement du volume. Dans cet exemple, sélectionnez Shared Directory, ce qui active le mode sharepath.
   Mount Path	Le sous-répertoire NAS à monter. Si ce paramètre n'est pas spécifié, le répertoire racine est monté par défaut. Si le répertoire n'existe pas dans le système de fichiers NAS, il est automatiquement créé puis monté. NAS généraliste : le répertoire racine est /. Extreme NAS : le répertoire racine est /share. Lorsque vous montez un sous-répertoire, le path doit commencer par /share, par exemple /share/data.
   Reclaim policy	Pour le mode sharepath, cette valeur doit être Retain.
   Mount options	Les options de montage pour NAS, y compris la version du protocole NFS. Par défaut, les volumes sont montés avec NFSv3. Vous pouvez spécifier une autre version avec une option telle que vers=4,0. Pour plus d'informations sur les protocoles NFS pris en charge par les différents types de NAS, consultez Protocoles NFS.

kubectl

1. Créez deux namespaces, ns1 et ns2.

   kubectl create ns ns1
   kubectl create ns ns2

2. Créez un fichier nommé pvc.yaml avec le contenu suivant afin de créer un PVC portant le même nom dans les namespaces ns1 et 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

   Paramètre	Description
   accessModes	Le mode d'accès. Valeurs possibles : ReadWriteMany (par défaut) : le volume peut être monté en lecture-écriture par plusieurs nœuds. ReadWriteOnce : le volume peut être monté en lecture-écriture par un seul nœud. ReadOnlyMany : le volume peut être monté en lecture seule par plusieurs nœuds.
   storageClassName	Le nom de la StorageClass à utiliser.
   storage	La capacité requise du volume de stockage. Par défaut, cette déclaration agit comme une demande de ressource et ne limite pas l'espace de stockage réel disponible pour le pod. La limite de capacité d'un système de fichiers NAS est déterminée par ses spécifications. Pour plus d'informations, consultez NAS généraliste et Extreme NAS. Toutefois, lorsque allowVolumeExpansion dans la StorageClass est défini sur true, cette valeur devient une limite stricte imposée. Le plug-in CSI définit le quota du répertoire NAS en fonction de cette configuration pour limiter la capacité disponible du PV.

3. Créez les PVC.

   kubectl create -f pvc.yaml

4. Vérifiez l'état des PV pour confirmer que des PV ont été automatiquement créés et liés aux PVC.

   kubectl get pv

   Le résultat attendu est similaire à ce qui suit. L'état des deux PV est Bound et la colonne CLAIM indique que chaque PV est lié à un PVC dans un namespace différent (ns1/nas-csi-pvc et 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. Créez des namespaces.

   • Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Namespaces and Quotas.

   • Cliquez sur Create et suivez les instructions à l'écran pour créer les namespaces ns1 et ns2.

2. Dans le volet de navigation de gauche de la page de gestion du cluster, choisissez Storage > PVCs.

3. Dans le namespace ns1, créez une revendication de stockage.

   Sur la page Persistent Volume Claims, sélectionnez ns1 dans la liste déroulante Namespace et suivez les instructions à l'écran pour créer le PVC.

   Paramètre	Description
   PVC Type	Sélectionnez NAS.
   Name	Le nom du PVC. Le nom doit être unique au sein du namespace.
   Allocation Mode	Sélectionnez Use StorageClass.
   Existing Storage Class	Cliquez sur Select Storage Class et choisissez la StorageClass que vous avez créée.
   Capacity	La capacité requise du volume de stockage. Par défaut, cette déclaration agit comme une demande de ressource et ne limite pas l'espace de stockage réel disponible pour le pod. La limite de capacité d'un système de fichiers NAS est déterminée par ses spécifications. Pour plus d'informations, consultez NAS généraliste et Extreme NAS. Toutefois, lorsque allowVolumeExpansion dans la StorageClass est défini sur true, cette valeur devient une limite stricte imposée. Le plug-in CSI définit le quota du répertoire NAS en fonction de cette configuration pour limiter la capacité disponible du PV.
   Access Mode	Le mode d'accès. Valeurs possibles : ReadWriteMany (par défaut) : le volume peut être monté en lecture-écriture par plusieurs nœuds. ReadWriteOnce : le volume peut être monté en lecture-écriture par un seul nœud. ReadOnlyMany : le volume peut être monté en lecture seule par plusieurs nœuds.

4. Suivez l'étape précédente pour créer un autre PVC dans le namespace ns2.

   Après la création, revenez à la page Persistent Volume Claims. Dans les namespaces ns1 et ns2, confirmez que les deux PVC sont liés à leurs PV créés automatiquement.

kubectl

1. Créez deux fichiers nommés nginx-ns1.yaml et nginx-ns2.yaml avec le contenu suivant.

   Les configurations des deux applications sont presque identiques. Chacune se lie au PVC de son namespace respectif.

   • 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. Créez les deux Deployments.

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

3. Vérifiez l'état des Pods.

   kubectl get pod -A -l app=nginx

   Résultat attendu :

   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. Vérifiez la configuration détaillée d'un Pod pour confirmer le montage du PVC.

   Remplacez <namespace-name> et <pod-name> par le namespace et le nom du Pod réels.

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

   Dans le résultat attendu, les deux Pods montent respectivement ns1/nas-csi-pvc et ns2/nas-csi-pvc.

Console

1. Sur la page ACK Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Workloads > Deployments.

2. Dans le namespace ns1, créez un Deployment et montez le PVC correspondant.

   1. Sélectionnez Namespace dans la liste déroulante Namespace et cliquez sur Create from Image.

   2. Suivez les instructions à l'écran pour créer l'application.

      Les paramètres clés sont décrits ci-dessous. Laissez les autres paramètres avec leurs valeurs par défaut. Pour plus d'informations, consultez Créer une charge de travail sans état (Deployment).

      Section	Paramètre	Description
      Basic Information	Replicas:	Le nombre de réplicas du Deployment.
      Container	Image	L'adresse de l'image utilisée pour déployer l'application.
      	Required Resources	Les ressources vCPU et mémoire requises.
      	Volumes	Cliquez sur Add PVC et configurez les paramètres. Mount Source : sélectionnez le PVC que vous avez créé. Container Path : saisissez le chemin au sein du conteneur où le système de fichiers NAS sera monté, par exemple /data.

3. Suivez l'étape précédente pour créer un autre Deployment dans le namespace ns2 et monter le PVC correspondant.

   Revenez à la page Deployments. Dans les namespaces ns1 et ns2, vérifiez l'état de chaque Deployment pour confirmer que les Pods sont en cours d'exécution et ont monté les bons PVC.