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
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
# chroot /host
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Démarrez le conteneur de boîte à outils:
toolbox
# toolbox
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Installez le paquet supplémentaire, tel que wget:
dnf install -y <package_name>
# dnf install -y <package_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
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.
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/<node_name>.
- En tant qu’utilisateur, vous pouvez accéder à votre système avec des privilèges root.
Procédure
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
# chroot /host
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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 IMAGE=fedora/fedora:latest TOOLBOX_NAME=toolbox-fedora-latest
REGISTRY=quay.io
1 IMAGE=fedora/fedora:latest
2 TOOLBOX_NAME=toolbox-fedora-latest
3 Copy to Clipboard Copied! Toggle word wrap Toggle overflow Démarrez un conteneur de boîte à outils en entrant la commande suivante:
toolbox
# toolbox
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteLorsqu’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.