Gestion des volumes persistants dans Tanzu Kubernetes Grid
Comment déployer une application dans Tanzu Kubernetes Grid avec des volumes persistants
Dernière mise à jour le 10/11/2022
Objectif
Ce guide vous permet de gérer les volumes persistants sur un cluster Tanzu Kubernetes Grid.
OVHcloud vous met à disposition des services dont la configuration, la gestion et la responsabilité vous incombent. Il vous appartient donc de ce fait d’en assurer le bon fonctionnement.
Ce guide a pour but de vous accompagner au mieux sur des tâches courantes. Néanmoins, nous vous recommandons de faire appel à un prestataire spécialisé si vous éprouvez des difficultés ou des doutes concernant l’administration, l’utilisation ou la mise en place d’un service sur un serveur.
Prérequis
- Être contact administrateur de l'infrastructure Hosted Private Cloud, afin de recevoir les identifiants de connexion.
- Avoir un identifiant actif dans l'espace client OVHcloud.
- Avoir un identifiant actif dans vSphere.
- Avoir déployé le cluster de Workload TKG à l'aide du guide « administrer Tanzu Management Cluster Grid ».
Présentation
Les volumes persistants sont utilisés pour conserver des données de manière permanente sur un cluster Kubernetes. Ce mécanisme s'appuie sur des Storage Classes. Il existe diverses Storage Classes. Consultez le guide « Kubernetes Storage Classes » pour plus d'informations.
Lors du déploiement d'un cluster de WorkLoad, une Storage Class CSI provisioner est créée et pointe dans le dossier du Datastore qui contient les machines virtuelles du cluster de WorkLoad.
A partir de votre cluster VMware, rendez-vous dans l'inventaire. Sélectionnez à gauche l'icône concernant le stockage, positionnez-vous sur le datastore où a été déployé votre cluster de WorkLoad. Allez dans l'onglet Fichiers et cliquez sur le dossier fcd.
Le dossier est vide car le cluster de WorkLoad n'utilise pas encore de volumes persistants.
Il est possible de créer d'autres Storage Classes pour chaque cluster de WorkLoad.
En pratique
Nous allons nous connecter sur un cluster de WorkLoad à partir de la console de la machine virtuelle Bootstrap. Vous pouvez vous aider du guide « Administrer Tanzu Management Cluster Grid » pour créer un cluster de workload et l'administrer.
A partir de la console de la machine virtuelle de Bootstrap, utilisez cette commande pour voir les contextes que l'on peut utiliser sur ce cluster :
# Affichage de tous les contextes de votre cluster TANZU KUBERNETES GRID
kubectl config get-contexts
Saisissez cette commande pour utiliser le cluster de WorkLoad :
# Connexion au cluster de WorkLoad
kubectl config use-context tkgm-workload-cluster-admin@tkgm-workload-cluster
Affichage des Storage Classes existantes
Pour obtenir des informations sur les Storage Classes d'un cluster de WorkLoad, saisissez ces commandes :
# Affichage des Storage Classes
kubectl get storageclass
# Description d'une Storage Class
kubectl describe storageclass nomclasse
Création d'une storage class sur un autre Datastore
Sur notre cluster VMware, nous avons deux Datastores connectés sur des serveur NFS. Un des datastores contient les machines virtuelles du cluster de WorkLoad ainsi que le dossier fcd utilisé par la Storage Class du cluster de Workload.
Nous allons créer une nouvelle Storage Class sur le deuxième Datastore.
Revenez sur votre cluster VMware dans la gestion du stockage, sélectionnez le second datastore et cliquez sur Résumé dans l'onglet à gauche.
Copiez l'URL en dessous de « Type: NFS 3 ».
Allez dans la console de la machine virtuelle Bootstrap, éditez un nouveau fichier nommé secondstorageclass.yaml avec ce contenu :
kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
name: secondstorageclass
annotations:
storageclass.kubernetes.io/is-default-class: "true"
provisioner: csi.vsphere.vmware.com
parameters:
datastoreurl: "ds:///vmfs/volumes/xxxxxxxxxxxxxxxxx/"
Modifiez le fichier en remplaçant ds:///vmfs/volumes/xxxxxxxxxxxxxxxxx/ par l'URL que vous venez de copier.
Exécutez ensuite cette commande :
# Création du storageclass à partir du fichier yaml
kubectl apply -f secondstorageclass.yaml
# Affichage des storageclass
kubectl get storageclass
Nous voyons donc apparaitre deux Storage Classes :
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
default (default) csi.vsphere.vmware.com Delete Immediate true 3d18h
secondstorageclass (default) csi.vsphere.vmware.com Delete Immediate false 12s
tanzu@bootstrap:~$
Création d'un volume persistant dans la Storage class par défaut
Créez un fichier nommé default-pvc-storage.yaml avec ce contenu :
kind: persistantVolumeClaim
apiVersion: v1
metadata:
name: default-pvc-storage
spec:
accessModes:
- ReadWriteOnce
storageClassName: "default"
resources:
requests:
storage: 2Gi
Le nom du stockage persistant se trouve à coté de name, storageClassName contient le nom de la Storage Class qui est utilisée pour ce volume.
Exécutez cette commande pour créer le volume persistant :
# Creation d'un espace de nom qui sera utilisé pour mon volume persistant.
kubectl create namespace myspace
# Application du fichier de configuration dans l'espace de nom créé.
kubectl apply -f default-pvc-storage.yaml -n myspace
# Affichage des volumes persistants de l'espace de nom créé
kubectl get pv,pvc -n myspace
Revenez sur l'inventaire dans votre interface vCenter, cliquez à gauche sur l'icône DataCenter puis allez dans l'onglet Surveiller à droite et cliquez sur Volume de conteneur pour voir les volumes persistants.
Le volume persistant qui a été créé est affiché et l'on voit à sa droite le nom du Datastore sur lequel il est stocké.
Cliquez sur l'icône en forme de bloc-notes à gauche du volume pour afficher les détails.
Les informations concernant ce stockage persistant sont affichées et correspondent à ce qui a été créé à partir des commandes Kubernetes.
Rendez-vous sur le Datastore qui est utilisé par défaut, cliquez à droite sur l'onglet Fichiers et faites défiler les dossiers du Datastore jusqu'au dossier fcd.
Vous constatez que le dossier contient deux fichiers, un fichier vmdk qui contient les données du volumes persistant et un fichier temporaire associé.
Création d'un volume persistant sur le deuxième Storage Class
Revenez sur la machine virtuelle Bootstrap et utilisez la ligne de commande.
Créez un fichier nommé second-storage-pvc.yaml :
kind: persistantVolumeClaim
apiVersion: v1
metadata:
name: second-storage-pvc
spec:
accessModes:
- ReadWriteOnce
storageClassName: "secondstorageclass"
resources:
requests:
storage: 2Gi
Le fichier utilise la même syntaxe que pour le premier stockage persistant mais avec un nom et une Storage Class différents.
Exécutez cette commande pour créer le volume persistant dans l'espace de nom myspace :
# Application du fichier de configuration dans l'espace de nom créé.
kubectl apply -f second-storage-pvc.yaml -n myspace
# Affichage des volumes persistants de l'espace de nom créé
kubectl get pv,pvc -n myspace
Le volume persistant est créé sur le deuxième Datastore.
Revenez dans l'interface vCenter. Vous constaterez que vous n'avez pas de nouveaux fichiers dans le dossier fcd.
Cliquez à droite sur le second Datastore, allez dans le dossier fcd de ce datastore. Vous constaterez que vous avez deux nouveaux fichiers comme sur le premier Datastore.
Revenez dans le Datacenter à la racine des datacenters, cliquez sur l'onglet Surveiller et choisissez Volumes de conteneur pour voir apparaitre les deux volumes persistants avec leurs emplacements dans les Datastores.
Aller plus loin
Présentation de Tanzu Kubernetes Grid au sein d'OVHcloud
Installer Tanzu Kubernetes Grid
Administrer Tanzu Management Cluster Grid
Présentation de VMware Tanzu Kubernetes Grid
Documentation de VMware Tanzu Kubenetes Grid
Installation manuelle de l'outil CLI pour le déploiement de Tanzu Kubernetes GRID
Échangez avec notre communauté d'utilisateurs sur https://community.ovh.com.
Cette documentation vous a-t-elle été utile ?
N’hésitez pas à nous proposer des suggestions d’amélioration afin de faire évoluer cette documentation.
Images, contenu, structure… N’hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !
Vos demandes d’assistance ne seront pas traitées par ce formulaire. Pour cela, utilisez le formulaire "Créer un ticket" .
Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..