Container Compute Service:Use NAS volumes

Étape 1 : Obtenir les informations du système de fichiers NAS

1. Récupérez l'ID du VPC et l'ID du vSwitch utilisés par les pods ACS.

   Remarque

   Ces informations sont disponibles dans la console. Vous pouvez également exécuter la commande kubectl get cm -n kube-system acs-profile -o yaml pour afficher le fichier YAML de la ConfigMap acs-profile. L'ID du VPC et l'ID du vSwitch figurent respectivement dans les champs vpcId et vSwitchIds.

   1. Connectez-vous à la console ACS.

   2. Sur la page , cliquez sur le nom du cluster pour accéder à sa page de gestion.

   3. Dans le volet de navigation de gauche, choisissez Configuration > ConfigMaps.

   4. En haut de la page , remplacez le namespace par kube-system. Recherchez ensuite acs-profile et cliquez sur .

   5. Récupérez l'ID du VPC et l'ID du vSwitch depuis les champs vpcId et vSwitchIds.

2. Vérifiez que le système de fichiers NAS existant répond aux exigences et obtenez l'adresse de la cible de montage.

   1. Connectez-vous à la console NAS. Dans le volet de navigation de gauche, cliquez sur File System List.

   2. Localisez le système de fichiers NAS cible et assurez-vous que sa région, sa zone et son type de protocole sont conformes aux exigences.

      • Le montage inter-VPC n'étant pas pris en charge, NAS ne fonctionne pas entre différentes régions. Le système de fichiers NAS doit impérativement se trouver dans la même région que votre cluster ACS.

      • Au sein d'un même VPC, le montage entre zones est possible. Toutefois, pour des performances optimales, placez de préférence le système de fichiers NAS et les pods du cluster ACS dans la même zone.

      • Confirmez que le type de protocole du système de fichiers NAS est NFS. Les systèmes utilisant le protocole SMB ne peuvent pas être montés.

   3. Validez la conformité de la cible de montage et notez son adresse.

      1. Cliquez sur l'ID du système de fichiers.

      2. Sur la page de détails du système de fichiers, cliquez sur Mount Targets dans le volet de navigation de gauche.

      3. Dans la section Mount Target, vérifiez qu'une cible de montage existante satisfait aux exigences, puis récupérez son adresse.

         Remarque

         • Une cible de montage est créée automatiquement lors de la création d'un système de fichiers NAS universel. Pour un système NAS Extreme, vous devez la créer manuellement.

         • Si aucune cible de montage existante ne convient, créez-en une nouvelle. Pour plus d'informations, consultez Gérer les cibles de montage.

         • Le VPC de la cible de montage doit correspondre à celui du cluster ACS, faute de quoi le montage échouera.

         • Pour optimiser les performances, il est recommandé d'utiliser le même vSwitch pour la cible de montage et les pods du cluster ACS.

         • La cible de montage doit présenter le statut Available.

Étape 2 : Créer une StorageClass

1. Adaptez le contenu YAML ci-dessous selon la description des paramètres, puis enregistrez-le sous le nom 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

   Description des paramètres :

   Paramètre	Description
   volumeAs	Mode de provisionnement. Définissez cette valeur sur subpath pour créer chaque volume persistant (PV) sous forme de sous-répertoire. Chaque PV correspond alors à un sous-répertoire du système de fichiers NAS.
   server	Adresse de la cible de montage du système de fichiers NAS, au format mount-target-address:path, où path désigne le sous-répertoire NAS à monter. En l'absence de chemin spécifié, le répertoire racine est monté par défaut. Si le répertoire n'existe pas encore dans le système de fichiers NAS, il est créé automatiquement avant le montage. Le répertoire racine est / pour les systèmes NAS universels et /share pour les systèmes NAS Extreme.
   provisioner	Type de provisionneur. Cette valeur doit être définie sur nasplugin.csi.alibabacloud.com afin d'utiliser le plug-in CSI NAS d'Alibaba Cloud.
   reclaimPolicy	Politique de récupération du PV. Seule la valeur Retain est prise en charge. Elle garantit la conservation du système de fichiers NAS et de la cible de montage associés lors de la suppression du PV.

Étape 3 : Créer une PVC

Étape 4 : Créer une application et monter le volume

Étape 1 : Créer une StorageClass

1. Modifiez le contenu YAML ci-dessous en fonction de la description des paramètres, puis enregistrez le fichier sous le nom 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

   Le tableau suivant décrit les paramètres.

   Important

   La prise en charge des types de systèmes de fichiers NAS et des classes de stockage varie selon les régions et les zones de disponibilité. Assurez-vous que la région, la zone de disponibilité, le VPC et le vSwitch choisis pour le système de fichiers NAS et sa cible de montage sont compatibles avec votre cluster ACS ainsi qu'avec le VPC et le vSwitch utilisés par vos pods. Pour plus d'informations, consultez les rubriques suivantes :

   • Pour connaître les classes de stockage, les performances, la facturation ainsi que les régions et zones de disponibilité prises en charge pour les différents types de systèmes de fichiers NAS, reportez-vous à NAS universel et NAS Extreme.

   • Le NAS universel et le NAS Extreme imposent des limites différentes concernant la connectivité de montage, le nombre de systèmes de fichiers et les types de protocoles. Pour en savoir plus, consultez Limites.

   • Exécutez la commande kubectl get cm -n kube-system acs-profile -o yaml pour afficher le fichier YAML acs-profile et obtenir les ID du VPC et des vSwitch utilisés par les pods depuis les champs vpcId et vSwitchIds.

   Paramètre	Description
   volumeAs	Méthode de provisionnement du volume. Définissez cette valeur sur filesystem pour créer automatiquement un nouveau système de fichiers NAS pour chaque volume.
   fileSystemType	Type du système de fichiers NAS. standard (par défaut) : NAS universel. Pour plus d'informations, consultez NAS universel. extreme : NAS Extreme. Pour plus d'informations, consultez NAS Extreme.
   storageType	Classe de stockage du système de fichiers NAS. Pour le NAS universel, les valeurs valides sont : Performance (par défaut) : Performance Capacity : Capacité Pour le NAS Extreme, les valeurs valides sont : standard (par défaut) : Standard advanced : Avancé
   regionId	Région où se trouve le système de fichiers NAS. Elle doit correspondre à celle de votre cluster ACS.
   zoneId	Zone de disponibilité où se trouve le système de fichiers NAS. Choisissez une zone de disponibilité en fonction du vSwitch utilisé par les pods de votre cluster ACS. Remarque Au sein d'un même VPC, le montage d'un système de fichiers NAS entre plusieurs zones de disponibilité est possible. Pour des performances optimales, privilégiez toutefois la même zone de disponibilité.
   vpcId, vSwitchId	Identifiants du VPC et du vSwitch pour la cible de montage du système de fichiers NAS. Ils doivent correspondre à ceux utilisés par les pods de votre cluster ACS.
   accessGroupName	Groupe de permissions de la cible de montage pour le système de fichiers NAS. La valeur par défaut est DEFAULT_VPC_GROUP_NAME.
   provisioner	Provisionneur. Cette valeur doit être définie sur nasplugin.csi.alibabacloud.com, ce qui spécifie l'utilisation du plug-in CSI NAS d'Alibaba Cloud.
   reclaimPolicy	Politique de récupération du PV. La seule politique prise en charge est Retain, ce qui signifie que le système de fichiers NAS et la cible de montage correspondants sont conservés lors de la suppression du PV.

2. Créez la StorageClass.

   kubectl create -f nas-sc.yaml

3. Vérifiez la StorageClass.

   kubectl get sc

   Sortie attendue :

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

Étape 2 : Créer une PersistentVolumeClaim

1. Enregistrez le contenu suivant dans un fichier nommé nas-pvc-fs.yaml.

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

   Le tableau suivant décrit les paramètres.

   Paramètre	Description
   accessModes	Mode d'accès.
   storage	Capacité du volume NAS à créer. Remarque La capacité minimale du NAS Extreme est de 100 GiB. Si le type de système de fichiers NAS défini dans la StorageClass est NAS Extreme, la valeur de storage doit être supérieure ou égale à 100 GiB. Sinon, le PersistentVolume correspondant ne pourra pas être créé.
   storageClassName	Nom de la StorageClass à utiliser.

2. Créez la PersistentVolumeClaim.

   kubectl create -f nas-pvc-fs.yaml

3. Vérifiez la PersistentVolumeClaim.

   kubectl get pvc

   La sortie indique que la PersistentVolumeClaim est liée au PersistentVolume créé automatiquement. Vous pouvez également consulter le système de fichiers NAS correspondant dans la 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

Étape 3 : Créer une application et monter le volume NAS

1. Créez un fichier nommé nas-test-fs.yaml avec le contenu suivant.

   Ce fichier YAML crée un Deployment composé de deux pods. Chacun demande du stockage via la PersistentVolumeClaim nommée nas-pvc-fs et monte le volume sur le chemin /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. Créez le Deployment et montez le volume NAS.

   kubectl create -f nas-test-fs.yaml

3. Vérifiez l'état de déploiement des pods du Deployment.

   kubectl get pod | grep nas-test

   La sortie suivante confirme la création de deux pods.

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

4. Vérifiez le chemin de montage.

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

   Sortie attendue :

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

   Cette sortie confirme le montage réussi du système de fichiers.

Étape 1 : Obtenir les informations du système de fichiers NAS

Pour plus d'informations sur l'obtention de l'adresse de la cible de montage NAS, consultez Obtenir les informations du système de fichiers NAS.

Étape 2 : Créer une application et monter le NAS

1. Créez un fichier nommé nas-test-nfs.yaml avec le contenu suivant.

   Ce fichier YAML définit un Deployment composé de deux pods. Chaque pod monte le système de fichiers NAS sur le chemin /data à l'aide d'un volume nommé 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. Créez le Deployment et montez le volume NAS.

   kubectl create -f nas-test-nfs.yaml

3. Vérifiez l'état de déploiement des pods du Deployment.

   kubectl get pod | grep nas-test

   La sortie suivante confirme la création de deux pods.

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

4. Vérifiez le chemin de montage.

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

   Sortie attendue :

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

   Cette sortie confirme le montage réussi du système de fichiers.