2.3. 为断开连接的安装将镜像镜像到私有 registry
您可以通过将所需的容器镜像镜像到私有容器 registry,在断开连接的环境中将 Red Hat OpenShift AI Operator 安装到 OpenShift 集群。将镜像镜像到容器 registry 后,您可以使用 OperatorHub 安装 Red Hat OpenShift AI Operator。
您可以使用 mirror registry for Red Hat OpenShift,它是一个小型容器 registry,可用作在断开连接的环境中为 OpenShift AI 镜像所需的容器镜像的目标。如果安装环境中已有另一个容器 registry,则使用 mirror registry for Red Hat OpenShift 是可选的。
先决条件
-
有
cluster-admin
访问正在运行的 OpenShift Container Platform 集群,版本 4.12 或更高版本。 - 您的主机可以访问互联网,以便它可以获取镜像来填充镜像存储库。
-
已安装 OpenShift CLI(
oc
)。 - 您有一个 GitHub 帐户,链接到验证的电子邮件地址。
- 如果您计划使用 NVIDIA GPU,则代表已镜像并部署了 NVIDIA GPU Operator。请参阅配置 NVIDIA GPU Operator。
- 如果您计划使用分布式工作负载组件,则已镜像 Ray 集群镜像。
- 如果您计划将演示笔记本用于分布式工作负载,则已克隆 codeflare-sdk 存储库。
步骤
- 创建镜像 registry。请参阅为 Red Hat OpenShift 创建带有镜像 registry 的镜像 registry。
-
安装
oc-mirror
OpenShift CLI 插件(版本 4.12 或更高版本)来 mirror registry 镜像。请参阅安装 oc-mirror OpenShift CLI 插件。 - 配置 registry 身份验证。请参阅配置允许镜像镜像的凭证。
-
从 断开连接的安装程序帮助程序 存储库中打开示例镜像设置配置文件(
rhoai-<version>.md
)并检查其内容。 使用示例镜像设置配置文件,创建一个名为
imageset-config.yaml
的文件,并在部署中为适合镜像设置配置的值填充。重要示例镜像设置配置仅用于演示目的,可能需要根据部署进行进一步更改。
要识别最适合您的部署的属性,请查看 使用 oc-mirror 插件为断开连接的安装 mirror 镜像 的文档和用例。
您的
imageset-config.yaml
应该类似以下示例,其中 Data Science 管道需要openshift-pipelines-operator-rh
,KServe 组件都需要serverless-operator
和servicemeshoperator
。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 查看可用 OpenShift 版本列表:
oc-mirror list operators
oc-mirror list operators
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 查看软件包的可用频道:
oc-mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.15 --package=<package-name>
oc-mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.15 --package=<package-name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
运行
oc mirror
命令将指定的镜像集配置镜像到磁盘:oc mirror --config=./imageset-config.yaml file://mirror-rhods
$ oc mirror --config=./imageset-config.yaml file://mirror-rhods
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
将
mirror-rhods
替换为您要输出镜像集文件的目标目录。 目标目录路径必须以
file://
开头。重要要成功将镜像设置配置镜像到磁盘,请确保您已安装了
oc-mirror
OpenShift CLI (oc
) 插件版本 4.12 或更高版本。以前版本 4.12 的oc-mirror
版本不允许镜像提供的完整镜像设置配置。
-
将
验证镜像设置
.tar
文件是否已创建:ls mirror-rhods
$ ls mirror-rhods mirror_seq1_000000.tar mirror_seq1_000001.tar
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果在镜像设置配置文件中指定了
archiveSize
值,则镜像集可能会划分为多个.tar
文件。将生成的镜像设置为目标镜像 registry 的内容:
oc mirror --from=./mirror-rhods docker://registry.example.com:5000
$ oc mirror --from=./mirror-rhods docker://registry.example.com:5000
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
将
mirror-rhods
替换为包含镜像设置.tar
文件的目录。 -
将
registry.example.com:5000
替换为您的镜像 registry。
-
将
验证
ImageContentSourcePolicy
和CatalogSource
资源是否存在 YAML 文件:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 将
results-1639608488
替换为结果目录的名称。- 以具有 cluster-admin 角色的用户身份登录 OpenShift CLI。
将生成的
ImageContentSourcePolicy
和CatalogSource
资源安装到集群中:oc apply -f ./oc-mirror-workspace/results-1639608488/imageContentSourcePolicy.yaml oc apply -f ./oc-mirror-workspace/results-1639608488/catalogSource-rhods-operator-live-catalog.yaml
$ oc apply -f ./oc-mirror-workspace/results-1639608488/imageContentSourcePolicy.yaml $ oc apply -f ./oc-mirror-workspace/results-1639608488/catalogSource-rhods-operator-live-catalog.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 将
results-1639608488
替换为结果目录的名称。
验证
运行以下命令,以验证
CatalogSource
和 pod 是否已成功创建:oc get catalogsource,pod -n openshift-marketplace | grep redhat-operators
$ oc get catalogsource,pod -n openshift-marketplace | grep redhat-operators
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 检查 OperatorHub 中是否存在 Red Hat OpenShift AI Operator:
- 登录到 OpenShift Container Platform 集群 Web 控制台。
点 Operators
OperatorHub。 OperatorHub 页面将打开。
- 找到 Red Hat OpenShift AI Operator。