Inspecter les charges de travail avec état

Cette page explique comment inspecter les charges de travail avec état existantes qui s'exécutent dans un cluster Kubernetes d'une appliance Google Distributed Cloud (GDC) isolée. Les charges de travail avec état vous permettent d'exécuter votre application avec un stockage de conteneurs persistant. Vous pouvez afficher vos charges de travail avec état à l'aide de la console GDC ou de l'CLI kubectl pour surveiller l'utilisation des ressources et l'état des charges de travail.

Cette page s'adresse aux développeurs du groupe d'opérateurs d'applications, qui sont chargés de gérer les charges de travail d'applications pour leur organisation.

Avant de commencer

Pour effectuer les tâches décrites dans ce document, vous devez demander les autorisations nécessaires et préparer votre environnement.

Demander des rôles IAM

Demandez à votre administrateur IAM de l'organisation de vous accorder les rôles suivants dans l'espace de noms de votre projet en fonction de la tâche à effectuer :

  • Lecteur de charges de travail (workload-viewer) : permet d'afficher toutes les charges de travail déployées dans un cluster.
  • Administrateur d'espace de noms (namespace-admin) : permet de créer, supprimer, modifier ou afficher des charges de travail dans un espace de noms de projet de cluster.

Préparer votre environnement

Pour exécuter des commandes sur le cluster Kubernetes bare metal préconfiguré, assurez-vous de disposer des ressources suivantes :

  1. Recherchez le nom du cluster Kubernetes ou demandez-le à votre administrateur de plate-forme.

  2. Connectez-vous et générez le fichier kubeconfig pour le cluster Kubernetes si vous n'en avez pas.

  3. Utilisez le chemin d'accès kubeconfig du cluster Kubernetes pour remplacer CLUSTER_KUBECONFIG dans ces instructions.

Afficher les charges de travail de conteneurs d'un projet

Exécutez la commande suivante pour afficher la liste de tous les pods de votre projet :

kubectl get pods -n PROJECT_NAMESPACE

Le résultat ressemble à ce qui suit :

NAME                        READY   STATUS    RESTARTS   AGE
nginx-workload-ah-aa-1228   1/1     Running   0          12h
nginx-workload-ah-ab-6784   1/1     Running   0          11h
nginx-workload-ah-ac-0045   1/1     Running   0          12h

Inspecter une ressource StatefulSet

Pour demander des informations plus détaillées sur les composants d'une ressource StatefulSet, exécutez des commandes qui ciblent directement l'entité que vous souhaitez inspecter.

Obtenir des informations sur l'objet StatefulSet

Pour obtenir des informations détaillées sur l'objet StatefulSet, exécutez la commande suivante :

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe statefulset STATEFULSET_NAME

Remplacez les éléments suivants :

  • CLUSTER_KUBECONFIG : fichier kubeconfig du cluster Kubernetes exécutant l'objet StatefulSet.

  • NAMESPACE : espace de noms du projet.

  • STATEFULSET_NAME: nom de l'objet StatefulSet.

Afficher la configuration active au format YAML

Pour afficher la configuration active de la ressource StatefulSet au format YAML, exécutez la commande suivante :

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get statefulset STATEFULSET_NAME -o yaml

Remplacez les éléments suivants :

  • CLUSTER_KUBECONFIG : fichier kubeconfig du cluster Kubernetes exécutant l'objet StatefulSet.

  • NAMESPACE : espace de noms du projet.

  • STATEFULSET_NAME: nom de l'objet StatefulSet.

Répertorier les pods

Pour afficher la liste des objets Pod créés par le StatefulSet, exécutez la commande suivante :

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pods -l app=APP_NAME

Dans cette commande, l'option -l affiche la liste de tous les objets Pod libellés avec APP_NAME.

Remplacez les éléments suivants :

  • CLUSTER_KUBECONFIG : fichier kubeconfig du cluster Kubernetes exécutant l'objet StatefulSet.

  • NAMESPACE : espace de noms du projet.

  • APP_NAME: nom de l'application avec état gérée par l'objet StatefulSet.

Obtenir des informations spécifiques sur un pod

Pour obtenir des informations sur un Pod spécifique dans le cluster, exécutez la commande suivante :

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pod POD_NAME

Remplacez les éléments suivants :

  • CLUSTER_KUBECONFIG : fichier kubeconfig du cluster Kubernetes exécutant le pod.

  • NAMESPACE : espace de noms du projet.

  • POD_NAME: nom du pod géré par l'objet StatefulSet.

Répertorier les PVC

Pour afficher la liste des objets PersistentVolumeClaim (PVC) dans le cluster, exécutez la commande suivante :

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    get pvc

Remplacez les éléments suivants :

  • CLUSTER_KUBECONFIG: fichier kubeconfig du cluster Kubernetes exécutant les PVC.

  • NAMESPACE : espace de noms du projet.

Obtenir des informations spécifiques sur une PVC

Pour obtenir des informations sur une PersistentVolumeClaim (PVC) spécifique dans le cluster, exécutez la commande suivante :

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pvc PVC_NAME

Remplacez les éléments suivants :

  • CLUSTER_KUBECONFIG : fichier kubeconfig du cluster Kubernetes exécutant la PVC.

  • NAMESPACE : espace de noms du projet.

  • PVC_NAME: nom de la PVC configurée pour l'objet StatefulSet.

Obtenir des informations sur un PV

Pour obtenir des informations sur un PersistentVolume (PV) spécifique dans le cluster, exécutez la commande suivante :

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    describe pv PV_NAME

Remplacez les éléments suivants :

  • CLUSTER_KUBECONFIG : fichier kubeconfig pour le cluster Kubernetes exécutant le PV.

  • NAMESPACE : espace de noms du projet.

  • PV_NAME: nom du PV configuré pour l'objet StatefulSet.