2.2. 安装 RHEL 镜像构建器

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

先决条件

您已登陆到要在其上安装 RHEL 镜像构建器的 RHEL 主机。
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
- 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

如果要在 web 控制台中使用 RHEL 镜像构建器，请启用并启动它。
```
*systemctl enable --now cockpit.socket*
```
```
# *systemctl enable --now cockpit.socket*
```
Copy to Clipboard
osbuild-composer 和 cockpit 服务在第一次访问时自动启动。
加载 shell 配置脚本，以便 composer-cli 命令的自动完成功能立即开始工作，而无需退出，然后再次登录：
```
*source /etc/bash_completion.d/composer-cli*
```
```
$ *source /etc/bash_completion.d/composer-cli*
```
Copy to Clipboard
在 Red Hat Enterprise Linux 主机上重启 running osbuild-composer 服务。
```
*systemctl restart osbuild-composer*
```
```
# *systemctl restart osbuild-composer*
```
Copy to Clipboard

验证

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

故障排除

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

要查找回溯的日志输出，请运行以下命令：
```
*journalctl | grep osbuild*
```
```
$ *journalctl | grep osbuild*
```
Copy to Clipboard

显示远程或本地 worker：

journalctl -u osbuild-worker*

$ journalctl -u osbuild-worker*

Copy to Clipboard

显示运行的服务：

*journalctl -u osbuild-composer.service*

$ *journalctl -u osbuild-composer.service*

Copy to Clipboard

返回顶部

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat