2.2. 安装 RHEL 镜像构建器

安装 RHEL 镜像构建器以访问所有 osbuild-composer 软件包功能。

先决条件

您已登录到要在其上安装 RHEL 镜像构建器的 Red Hat Enterprise Linux 主机。
Red Hat Enterprise Linux 主机已订阅了 Red Hat Subscription Manager (RHSM)或 Red Hat Satellite。
您已启用了 BaseOS 和 AppStream 存储库，以便能安装 RHEL 镜像构建器软件包。

流程

安装 RHEL 镜像构建器和其他必要的软件包：
```
dnf install osbuild-composer composer-cli cockpit-image-builder
```
```
# dnf install osbuild-composer composer-cli cockpit-image-builder
```
Copy to Clipboard Toggle word wrap
- osbuild-composer - 一个构建自定义 RHEL 操作系统镜像的服务。
- composer-cli- 这个软件包提供对 CLI 界面的访问。
- cockpit-image-builder - 此软件包允许对 Web UI 界面的访问。Web 控制台作为 cockpit-image-builder 软件包的依赖项安装。
启用并启动 RHEL 镜像构建器套接字：
```
systemctl enable --now osbuild-composer.socket
```
```
# systemctl enable --now osbuild-composer.socket
```
Copy to Clipboard Toggle word wrap
如果要在 web 控制台中使用 RHEL 镜像构建器，请启用并启动它。
```
systemctl enable --now cockpit.socket
```
```
# systemctl enable --now cockpit.socket
```
Copy to Clipboard Toggle word wrap
osbuild-composer 和 cockpit 服务在第一次访问时自动启动。
加载 shell 配置脚本，以便 composer-cli 命令的自动完成功能立即开始工作，而无需退出，然后再次登录：
```
source /etc/bash_completion.d/composer-cli
```
```
$ source /etc/bash_completion.d/composer-cli
```
Copy to Clipboard Toggle word wrap
在 Red Hat Enterprise Linux 主机上重启运行的 osbuild-composer 服务。
```
systemctl restart osbuild-composer
```
```
# systemctl restart osbuild-composer
```
Copy to Clipboard Toggle word wrap

验证

通过运行 composer-cli 来验证安装是否正常工作：
```
composer-cli status show
```
```
# composer-cli status show
```
Copy to Clipboard Toggle word wrap

故障排除

您可以使用系统日志来跟踪 RHEL 镜像构建器活动。此外，您还可以在文件中找到日志消息。

要查找回溯的日志输出，请运行以下命令：
```
journalctl | grep osbuild
```
```
$ journalctl | grep osbuild
```
Copy to Clipboard Toggle word wrap
显示远程或本地 worker：
```
journalctl -u osbuild-worker
```
```
$ journalctl -u osbuild-worker
```
Copy to Clipboard Toggle word wrap

显示运行的服务：

journalctl -u osbuild-composer.service

$ journalctl -u osbuild-composer.service

Copy to Clipboard

Toggle word wrap

返回顶部

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat