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 存储库。

步骤

  1. 创建镜像 registry。请参阅为 Red Hat OpenShift 创建带有镜像 registry 的镜像 registry
  2. 安装 oc-mirror OpenShift CLI 插件(版本 4.12 或更高版本)来 mirror registry 镜像。请参阅安装 oc-mirror OpenShift CLI 插件
  3. 配置 registry 身份验证。请参阅配置允许镜像镜像的凭证
  4. 断开连接的安装程序帮助程序 存储库中打开示例镜像设置配置文件(rhoai-<version>.md)并检查其内容。
  5. 使用示例镜像设置配置文件,创建一个名为 imageset-config.yaml 的文件,并在部署中为适合镜像设置配置的值填充。

    重要

    示例镜像设置配置仅用于演示目的,可能需要根据部署进行进一步更改。

    要识别最适合您的部署的属性,请查看 使用 oc-mirror 插件为断开连接的安装 mirror 镜像 的文档和用例。

    您的 imageset-config.yaml 应该类似以下示例,其中 Data Science 管道需要 openshift-pipelines-operator-rh,KServe 组件都需要 serverless-operatorservicemeshoperator

    mirror:
      operators:
        - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.15
          packages:
            - name: rhods-operator
            - name: openshift-pipelines-operator-rh
              channels:
                - name: latest
            - name: serverless-operator
              channels:
                - name: stable
            - name: servicemeshoperator
              channels:
                - name: stable
    Copy to Clipboard Toggle word wrap
    • 查看可用 OpenShift 版本列表:

      oc-mirror list operators
      Copy to Clipboard Toggle word wrap
    • 查看软件包的可用频道:

      oc-mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.15 --package=<package-name>
      Copy to Clipboard Toggle word wrap
  6. 运行 oc mirror 命令将指定的镜像集配置镜像到磁盘:

    $ oc mirror --config=./imageset-config.yaml file://mirror-rhods
    Copy to Clipboard Toggle word wrap
    • mirror-rhods 替换为您要输出镜像集文件的目标目录。
    • 目标目录路径必须以 file:// 开头。

      重要

      要成功将镜像设置配置镜像到磁盘,请确保您已安装了 oc-mirror OpenShift CLI (oc) 插件版本 4.12 或更高版本。以前版本 4.12 的 oc-mirror 版本不允许镜像提供的完整镜像设置配置。

  7. 验证镜像设置 .tar 文件是否已创建:

    $ ls mirror-rhods
    mirror_seq1_000000.tar mirror_seq1_000001.tar
    Copy to Clipboard Toggle word wrap

    如果在镜像设置配置文件中指定了 archiveSize 值,则镜像集可能会划分为多个 .tar 文件。

  8. 将生成的镜像设置为目标镜像 registry 的内容:

    $ oc mirror --from=./mirror-rhods docker://registry.example.com:5000
    Copy to Clipboard Toggle word wrap
    • mirror-rhods 替换为包含镜像设置 .tar 文件的目录。
    • registry.example.com:5000 替换为您的镜像 registry。
  9. 验证 ImageContentSourcePolicyCatalogSource 资源是否存在 YAML 文件:

    $ ls oc-mirror-workspace/results-1639608488/
    
    catalogSource-rhods-operator-live-catalog.yaml
    charts
    imageContentSourcePolicy.yaml
    mapping.txt
    release-signatures
    Copy to Clipboard Toggle word wrap

    results-1639608488 替换为结果目录的名称。

  10. 以具有 cluster-admin 角色的用户身份登录 OpenShift CLI。
  11. 将生成的 ImageContentSourcePolicyCatalogSource 资源安装到集群中:

    $ 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 Toggle word wrap

    results-1639608488 替换为结果目录的名称。

验证

  • 运行以下命令,以验证 CatalogSource 和 pod 是否已成功创建:

    $ oc get catalogsource,pod -n openshift-marketplace | grep redhat-operators
    Copy to Clipboard Toggle word wrap
  • 检查 OperatorHub 中是否存在 Red Hat OpenShift AI Operator:

    1. 登录到 OpenShift Container Platform 集群 Web 控制台。
    2. Operators OperatorHub

      OperatorHub 页面将打开。

    3. 找到 Red Hat OpenShift AI Operator。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat