6.8. À propos de toolbox


la boîte à outils est un outil qui démarre un conteneur sur un système Red Hat Enterprise Linux CoreOS (RHCOS). L’outil est principalement utilisé pour démarrer un conteneur qui comprend les binaires et les plugins nécessaires pour exécuter des commandes telles que sosreport.

Le but principal d’un conteneur de boîte à outils est de recueillir des informations diagnostiques et de les fournir à Red Hat Support. 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 des outils de support standard.

Installation de paquets dans un conteneur de boîte à outils

L’exécution par défaut de la commande toolbox démarre un conteneur avec l’image Registry.redhat.io/rhel9/support-tools:dernière image. Cette image contient les outils de support les plus fréquemment utilisés. Lorsque vous avez besoin de collecter des données spécifiques aux nœuds qui nécessitent un outil de support qui ne fait pas partie de l’image, vous pouvez installer des paquets supplémentaires.

Conditions préalables

  • Accès à un nœud avec la commande oc debug node/<node_name>.
  • En tant qu’utilisateur, vous pouvez accéder à votre système avec des privilèges root.

Procédure

  1. Définissez /host comme le répertoire racine dans le shell debug. Le pod debug monte le système de fichiers racine de l’hôte dans /host dans le pod. En changeant le répertoire root en /host, vous pouvez exécuter des binaires contenus dans les chemins exécutables de l’hôte:

    # chroot /host
    Copy to Clipboard Toggle word wrap
  2. Démarrez le conteneur de boîte à outils:

    # toolbox
    Copy to Clipboard Toggle word wrap
  3. Installez le paquet supplémentaire, tel que wget:

    # dnf install -y <package_name>
    Copy to Clipboard Toggle word wrap

Démarrage d’une image alternative avec boîte à outils

L’exécution par défaut de la commande toolbox démarre un conteneur avec l’image Registry.redhat.io/rhel9/support-tools:dernière image.

Note

Démarrez une image alternative en créant un fichier .toolboxrc et en spécifiant l’image à exécuter. Cependant, l’exécution d’une ancienne version de l’image des outils de support, telle que Registry.redhat.io/rhel8/support-tools:lastest, n’est pas prise en charge sur Red Hat OpenShift Service sur AWS 4.

Conditions préalables

  • Accès à un nœud avec la commande oc debug node/&lt;node_name&gt;.
  • En tant qu’utilisateur, vous pouvez accéder à votre système avec des privilèges root.

Procédure

  1. Définissez /host comme le répertoire racine dans le shell debug. Le pod debug monte le système de fichiers racine de l’hôte dans /host dans le pod. En changeant le répertoire root en /host, vous pouvez exécuter des binaires contenus dans les chemins exécutables de l’hôte:

    # chroot /host
    Copy to Clipboard Toggle word wrap
  2. Facultatif: Si vous devez utiliser une image alternative au lieu de l’image par défaut, créez un fichier .toolboxrc dans le répertoire d’accueil pour l’ID d’utilisateur racine, et spécifiez les métadonnées de l’image:

    REGISTRY=quay.io             
    1
    
    IMAGE=fedora/fedora:latest   
    2
    
    TOOLBOX_NAME=toolbox-fedora-latest  
    3
    Copy to Clipboard Toggle word wrap
    1
    Facultatif: spécifiez un registre de conteneurs alternatif.
    2
    Indiquez une image alternative pour démarrer.
    3
    Facultatif: Spécifiez un nom alternatif pour le conteneur de boîte à outils.
  3. Démarrez un conteneur de boîte à outils en entrant la commande suivante:

    # toolbox
    Copy to Clipboard Toggle word wrap
    Note

    Lorsqu’un pod de boîte à outils existant est déjà en cours d’exécution, la commande toolbox affiche déjà «toolbox-». Essayer de commencer… Afin d’éviter les problèmes avec les plugins sosreport, supprimez le conteneur de boîte à outils en cours d’exécution avec podman rm toolbox-, puis créez un nouveau conteneur de boîte à outils.

Retour au début
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. Découvrez nos récentes mises à jour.

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 le Blog 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.

Theme

© 2025 Red Hat