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
/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
Démarrer le conteneur de la boîte à outils :
# toolbox
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
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
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
Démarrer un conteneur de boîte à outils avec l'image alternative :
# toolbox
NoteSi un pod
toolbox
est déjà en cours d'exécution, la commandetoolbox
produit'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
.