5.12. A propos de toolbox
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
Définissez
/hostcomme 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/hostau 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
# chroot /hostCopy to Clipboard Copied! Toggle word wrap Toggle overflow Démarrer le conteneur de la boîte à outils :
toolbox
# toolboxCopy to Clipboard Copied! Toggle word wrap Toggle overflow Installez le paquet supplémentaire, tel que
wget:dnf install -y <nom_du_paquet>
# dnf install -y <nom_du_paquet>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
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
Définissez
/hostcomme 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/hostau 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
# chroot /hostCopy to Clipboard Copied! Toggle word wrap Toggle overflow Créez un fichier
.toolboxrcdans le répertoire personnel de l'utilisateur root :vi ~/.toolboxrc
# vi ~/.toolboxrcCopy to Clipboard Copied! Toggle word wrap Toggle overflow REGISTRY=quay.io IMAGE=fedora/fedora:33-x86_64 TOOLBOX_NAME=toolbox-fedora-33
REGISTRY=quay.io1 IMAGE=fedora/fedora:33-x86_642 TOOLBOX_NAME=toolbox-fedora-333 Copy to Clipboard Copied! Toggle word wrap Toggle overflow Démarrer un conteneur de boîte à outils avec l'image alternative :
toolbox
# toolboxCopy to Clipboard Copied! Toggle word wrap Toggle overflow NoteSi un pod
toolboxest déjà en cours d'exécution, la commandetoolboxproduit'toolbox-' already exists. Trying to start…. Supprimez le conteneur de boîte à outils en cours d'exécution avecpodman rm toolbox-et créez un nouveau conteneur de boîte à outils, afin d'éviter tout problème avec les pluginssosreport.