5.12. 关于 toolbox
toolbox
是一个在 Red Hat Enterprise Linux CoreOS(RHCOS)系统上启动容器的工具。该工具主要用于启动包含运行 sosreport
和 redhat-support-tool
等命令所需的二进制文件和插件的容器。
toolbox
容器的主要目的是收集诊断信息并将其提供给红帽支持。但是,如果需要额外的诊断工具,您可以添加 RPM 软件包或运行标准支持工具镜像的替代镜像。
将软件包安装到 toolbox
容器
默认情况下,运行 toolbox
命令使用 registry.redhat.io/rhel9/support-tools:latest
镜像启动一个容器。该镜像包含最常用的支持工具。如果需要一个不是镜像的一部分的支持工具来收集特定于具体节点的数据,可以安装额外的软件包。
先决条件
-
已使用
oc debug node/<node_name>
命令访问节点。 - 您可以使用具有 root 权限的用户访问您的系统。
流程
将
/host
设为 debug shell 中的根目录。debug pod 在 pod 中的/host
中挂载主机的 root 文件系统。将根目录改为/host
,您可以运行主机可执行路径中包含的二进制文件:# chroot /host
启动 toolbox 容器:
# toolbox
安装额外的软件包,如
wget
:# dnf install -y <package_name>
使用 toolbox
启动备用镜像
默认情况下,运行 toolbox
命令使用 registry.redhat.io/rhel9/support-tools:latest
镜像启动一个容器。
您可以通过创建 .toolboxrc
文件并指定要运行的镜像来启动其他镜像。但是,OpenShift Container Platform 4.17 不支持运行 support-tools
镜像的旧版本,如 registry.redhat.io/rhel8/support-tools:latest
。
先决条件
-
已使用
oc debug node/<node_name>
命令访问节点。 - 您可以使用具有 root 权限的用户访问您的系统。
流程
将
/host
设为 debug shell 中的根目录。debug pod 在 pod 中的/host
中挂载主机的 root 文件系统。将根目录改为/host
,您可以运行主机可执行路径中包含的二进制文件:# chroot /host
可选: 如果您需要使用替代镜像而不是默认镜像,请在 root 用户 ID 的主目录中创建一个
.toolboxrc
文件,并指定镜像元数据:REGISTRY=quay.io 1 IMAGE=fedora/fedora:latest 2 TOOLBOX_NAME=toolbox-fedora-latest 3
输入以下命令启动 toolbox 容器:
# toolbox
注意如果一个已存在的
toolbox
pod 已在运行,则toolbox
命令会输出'toolbox-' already exists.Trying to start…
.为了避免sosreport
插件出现问题,请使用podman rm toolbox-
删除正在运行的 toolbox 容器,然后生成新的 toolbox 容器。