第 6 章 将容器化命令行助手用于断开连接的环境
断开连接的环境的命令行助手可作为开发者预览提供。您可以在具有有限互联网连接的 air-gapped 网络、远程位置和其他环境中使用它。
用于断开连接的环境的命令行助手封装在基于 UBI 的容器中,关键组件(如基于红帽硬化映像的红帽知识桥映像)包括简化的配置、编排和基本生命周期管理。
将 RHEL 离线容器模型改为不支持的模型可启用任意代码的执行,或破坏 Red Hat Enterprise Linux (RHEL)系统的完整性。
命令行助手工具只是开发者预览软件。红帽不支持以任何方式的开发人员预览软件,且无法正常工作或生产环境就绪。不要将开发人员预览软件用于生产环境或关键业务工作负载。开发人员预览软件提供早期对即将推出的产品软件的访问权限,以将其包括在红帽产品产品中。客户可以使用此软件来测试功能并在开发过程中提供反馈。此软件可能没有任何文档,可以随时更改或删除,并且已获得有限的测试。红帽可能会提供在没有关联 SLA 的情况下对开发者预览软件提交反馈的方法。
有关 Red Hat Developer Preview 软件的支持范围的更多信息,请参阅 开发人员预览支持范围。
使用断开连接的环境的命令行助手,您可以为单个系统创建目标的容器镜像。此容器镜像包括以下组件:
-
一个
安装程序容器,用于拉取其他必需的容器、安装rhel-cla命令以及可选地配置系统服务。 -
RHEL 知识桥容器,用于桥接脱机知识组件。 -
一
个postgres数据库容器,用于存储本地应用程序数据。 -
运行大型语言模型(LLM)推理服务的
ramalama容器。 -
光速堆栈容器,其中包括命令行助手工具。 -
红帽离线知识门户容器,用于服务本地文档。
容器镜像适用于本地断开连接的单一系统上。它不是为多系统部署或大规模环境而设计的。
容器映像包括 Granite-4.1-8B 模型,并作为 Ramalama 容器的默认模型。
6.1. 在断开连接的环境中安装命令行助手 复制链接链接已复制到粘贴板!
使用 Red Hat Container Registry 和 Quay.io 中提供的容器镜像在断开连接的环境中安装命令行助手。在断开连接的环境中,手动将安装程序镜像及其依赖项镜像手动传送到离线系统的本地存储。
先决条件
- 您的 RHEL 系统已在 Red Hat Satellite 订阅中注册。详情请查看 离线 RHEL 命令行助手需要注册该系统吗?
- 您已请求并获得了 RHOKP 容器的 API 密钥。要申请您的 API 密钥,请访问红帽离线知识门户或联系您的红帽客户代表。
- 已安装 Podman。
-
已安装
container-toolsmeta-package。 -
您已创建了
$HOME/.config和$HOME/.local/bin文件夹。 软件要求:
- 操作系统: 支持的操作系统版本,如 RHEL 9.6 或更高版本、RHEL 10 或更高版本、Fedora 43 或更高版本、Windows 11 与 WSL2 和 Podman,或 macOS 15 或更高版本。
硬件要求:
- 存储:所有系统类型中至少有35到40 GB的可用磁盘空间,以容纳容器映像和本地LLM型号。
内存和处理 :
- 对于仅限 CPU 的系统:至少有 8 GB RAM 和 2 个 CPU 内核。
- 对于支持 GPU 的系统:至少 4 GB RAM 和至少 4 GB VRAM 的 GPU。
- 对于 Mac 计算机:一台装有 M2 芯片或更高版本的计算机。
流程
在连接的 RHEL 系统中,完成以下步骤:
登录到 Red Hat registry:
$ podman login registry.redhat.io下载
安装程序和所有依赖项镜像:$ podman pull registry.redhat.io/rhel-cla/installer-rhel10:latest $ podman pull registry.access.redhat.com/hi/postgresql:18 $ podman pull registry.redhat.io/lightspeed-core/lightspeed-stack-rhel9:v0.6-latest $ podman pull quay.io/ramalama/ramalama:latest $ podman pull registry.redhat.io/rhel-cla/rhel-knowledge-bridge-rhel10 $ podman pull registry.redhat.io/offline-knowledge-portal/rhokp-rhel9:latest将所有镜像保存为单个
tar文件:$ podman save -o rhel-cla-installer-images.tar \ registry.redhat.io/rhel-cla/installer-rhel10:latest \ registry.access.redhat.com/hi/postgresql:18 \ registry.redhat.io/lightspeed-core/lightspeed-stack-rhel9:v0.6-latest \ quay.io/ramalama/ramalama:latest \ registry.redhat.io/rhel-cla/rhel-knowledge-bridge-rhel10 \ registry.redhat.io/offline-knowledge-portal/rhokp-rhel9:latest
-
使用 USB 驱动器、网络共享或其他传输方法将
rhel-cla-installer-images.tar文件传送到断开连接的系统中。 在断开连接的系统中载入镜像:
$ podman load -i rhel-cla-installer-images.tar在断开连接的系统中,
运行安装程序容器。此命令使用载入的镜像,并在系统上安装离线命令行助手。$ podman run -u : --rm \ -v $HOME/.config:/config:Z \ -v $HOME/.local/bin:/config/.local/bin:Z \ rhel-cla/installer-rhel10:latest可选: 要在每次系统引导时都自动启动离线命令行助手容器,作为
systemd服务,请运行以下命令:$ rhel-cla enable-service在脱机 RHEL 系统上安装
命令行助手客户端包:# sudo dnf install command-line-assistant更新
endpoint配置选项。-
在文本编辑器中打开
/etc/xdg/command-line-assistant/config.toml文件。 找到
endpoint变量,并将其值更改为托管您离线命令行助手容器的系统地址。例如,要连接到本地系统:endpoint = "http://127.0.0.1:8501/v1"重启
clad服务以应用新配置:$ sudo systemctl restart clad安装完成后,您可以使用
rhel-cla命令启动、停止、卸载并检查离线命令行助手的状态。
-
在文本编辑器中打开
启动容器:
$ rhel-cla start
验证
检查离线命令行助手是否正在运行:
$ rhel-cla status验证容器是否正在运行:
$ podman ps CONTAINER ID IMAGE COMMAND CREATED STATUS ba655e5efdcd installer-rh… /sbin/init 30 seconds ago Up 29 secondsrlsapi和ragdb容器可能需要一分钟的时间来完全初始化。如果助手未运行,请启动它:
$ rhel-cla start通过询问以下问题来检查客户端是否已正确配置:
$ c "What is an immutable file?" + Asking Red Hat Lightspeed This feature uses AI technology. Do not include any personal information or other sensitive information in your input. Interactions may be used to improve Red Hat's products or services.