Rechercher

5.12. A propos de toolbox

download PDF

toolbox est un outil qui permet de démarrer un conteneur sur un système Red Hat Enterprise Linux CoreOS (RHCOS). L'outil est principalement utilisé pour démarrer un conteneur qui inclut les binaires et les plugins nécessaires à l'exécution de commandes telles que sosreport et redhat-support-tool.

L'objectif premier d'un conteneur toolbox est de rassembler des informations de diagnostic et de les fournir à l'équipe d'assistance de Red Hat. Cependant, si des outils de diagnostic supplémentaires sont nécessaires, vous pouvez ajouter des paquets RPM ou exécuter une image qui est une alternative à l'image standard des outils de support.

Installation de paquets dans un conteneur toolbox

Par défaut, la commande toolbox lance un conteneur avec l'image registry.redhat.io/rhel8/support-tools:latest. Cette image contient les outils d'assistance les plus fréquemment utilisés. Si vous devez collecter des données spécifiques à un nœud nécessitant un outil d'assistance qui ne fait pas partie de l'image, vous pouvez installer des paquets supplémentaires.

Conditions préalables

  • Vous avez accédé à un nœud avec la commande oc debug node/<node_name>.

Procédure

  1. Définissez /host comme répertoire racine dans le shell de débogage. Le pod de débogage monte le système de fichiers racine de l'hôte dans /host au sein du pod. En changeant le répertoire racine en /host, vous pouvez exécuter les binaires contenus dans les chemins d'exécution de l'hôte :

    # chroot /host
  2. Démarrer le conteneur de la boîte à outils :

    # toolbox
  3. Installez le paquet supplémentaire, tel que wget:

    # dnf install -y <nom_du_paquet>

Démarrage d'une image alternative avec toolbox

Par défaut, la commande toolbox lance un conteneur avec l'image registry.redhat.io/rhel8/support-tools:latest. Vous pouvez démarrer une autre image en créant un fichier .toolboxrc et en spécifiant l'image à exécuter.

Conditions préalables

  • Vous avez accédé à un nœud avec la commande oc debug node/<node_name>.

Procédure

  1. Définissez /host comme répertoire racine dans le shell de débogage. Le pod de débogage monte le système de fichiers racine de l'hôte dans /host au sein du pod. En changeant le répertoire racine en /host, vous pouvez exécuter les binaires contenus dans les chemins d'exécution de l'hôte :

    # chroot /host
  2. Créez un fichier .toolboxrc dans le répertoire personnel de l'utilisateur root :

    # vi ~/.toolboxrc
    REGISTRY=quay.io                1
    IMAGE=fedora/fedora:33-x86_64   2
    TOOLBOX_NAME=toolbox-fedora-33  3
    1
    Facultatif : Indiquez un autre registre de conteneurs.
    2
    Indiquer une autre image à lancer.
    3
    Facultatif : Indiquez un autre nom pour le conteneur de la boîte à outils.
  3. Démarrer un conteneur de boîte à outils avec l'image alternative :

    # toolbox
    Note

    Si un pod toolbox est déjà en cours d'exécution, la commande toolbox produit 'toolbox-' already exists. Trying to start…​. Supprimez le conteneur de boîte à outils en cours d'exécution avec podman rm toolbox- et créez un nouveau conteneur de boîte à outils, afin d'éviter tout problème avec les plugins sosreport.

Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.