7.7. Enquêter sur les questions relatives aux nacelles

Procédure

1. Passer à un projet :

   oc project <nom_du_projet>

2. Liste des pods en cours d'exécution dans l'espace de noms, ainsi que l'état des pods, les états d'erreur, les redémarrages et l'âge :

   $ oc get pods

3. Déterminez si l'espace de noms est géré par une configuration de déploiement :

   $ oc status

   Si l'espace de noms est géré par une configuration de déploiement, le résultat comprend le nom de la configuration de déploiement et une référence à l'image de base.

4. Inspecter l'image de base référencée dans la sortie de la commande précédente :

   skopeo inspect docker://<image_reference>

5. Si la référence de l'image de base n'est pas correcte, mettez à jour la référence dans la configuration du déploiement :

   $ oc edit deployment/my-deployment

6. Lorsque la configuration du déploiement change à la sortie, la configuration sera automatiquement redéployée. Surveillez l'état du pod au fur et à mesure que le déploiement progresse, afin de déterminer si le problème a été résolu :

   $ oc get pods -w

7. Examinez les événements de l'espace de noms pour y trouver des informations de diagnostic relatives aux défaillances des pods :

   $ oc get events

Procédure

1. Interroger les journaux pour un module spécifique :

   oc logs <nom_du_pod>

2. Interroger les journaux d'un conteneur spécifique au sein d'un pod :

   oc logs <nom_du_pod> -c <nom_du_conteneur>

   Les journaux récupérés à l'aide des commandes oc logs précédentes sont composés de messages envoyés à stdout à l'intérieur des pods ou des conteneurs.

3. Inspecter les grumes contenues dans /var/log/ à l'intérieur d'une nacelle.

   1. Liste des fichiers journaux et des sous-répertoires contenus dans /var/log au sein d'un pod :

      oc exec <nom_du_pod> ls -alh /var/log

   2. Interroger un fichier journal spécifique contenu dans /var/log au sein d'un pod :

      oc exec <nom_du_pod> cat /var/log/<chemin_vers_log>

   3. Liste des fichiers journaux et des sous-répertoires contenus dans /var/log à l'intérieur d'un conteneur spécifique :

      oc exec <nom_du_pod> -c <nom_du_conteneur> ls /var/log

   4. Interroger un fichier journal spécifique contenu dans /var/log à l'intérieur d'un conteneur spécifique :

      oc exec <nom_du_pod> -c <nom_du_conteneur> cat /var/log/<chemin_vers_log>

Procédure

1. Entrez dans le projet qui contient le pod auquel vous souhaitez accéder. Cette opération est nécessaire car la commande oc rsh n'accepte pas l'option d'espace de noms -n:

   oc project <namespace>

2. Démarrer un shell à distance dans un pod :

   $ oc rsh <pod_name>  1

   1

   Si un module a plusieurs conteneurs, oc rsh prend par défaut le premier conteneur, à moins que -c <container_name> ne soit spécifié.

3. Lancer un shell à distance dans un conteneur spécifique au sein d'un pod :

   oc rsh -c <container_name> pod/<pod_name>

4. Créer une session de transfert de port vers un port d'un pod :

   $ oc port-forward <pod_name> <host_port>:<pod_port>  1

   1

   Saisissez Ctrl C pour annuler la session de transfert de port.

Procédure

1. Démarrer un pod de débogage avec un accès root, sur la base d'un déploiement.

   1. Obtenir le nom de déploiement d'un projet :

      oc get deployment -n <nom_du_projet>

   2. Démarrer un pod de débogage avec les privilèges root, en fonction du déploiement :

      $ oc debug deployment/my-deployment --as-root -n <nom_du_projet>

2. Démarrer un pod de débogage avec un accès root, sur la base d'une configuration de déploiement.

   1. Obtenir le nom de la configuration de déploiement d'un projet :

      oc get deploymentconfigs -n <nom_du_projet>

   2. Démarrer un pod de débogage avec les privilèges de root, en fonction de la configuration du déploiement :

      $ oc debug deploymentconfig/my-deployment-configuration --as-root -n <nom_du_projet>

Procédure

1. Copier un fichier dans un pod :

   $ oc cp <local_path> <pod_name>:/<path> -c <container_name>  1

   1

   Le premier conteneur d'un pod est sélectionné si l'option -c n'est pas spécifiée.

2. Copier un fichier à partir d'un pod :

   $ oc cp <pod_name>:/<path>  -c <container_name><local_path>  1

   1

   Le premier conteneur d'un pod est sélectionné si l'option -c n'est pas spécifiée.

   Note

   Pour que oc cp fonctionne, le binaire tar doit être disponible dans le conteneur.