断开连接的环境

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 从 产品变体 下拉列表中选择架构。
3. 从 版本 下拉列表中选择适当的版本。
4. 点 OpenShift v4.17 Linux Clients 条目旁的 Download Now 来保存文件。

5. 解包存档：

   $ tar xvf <file>

6. 将 oc 二进制文件放到 PATH 中的目录中。

   要查看您的 PATH，请执行以下命令：

   $ echo $PATH

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 从 版本 下拉列表中选择适当的版本。
3. 点 OpenShift v4.17 Windows Client 条目旁的 Download Now 来保存文件。
4. 使用 ZIP 程序解压存档。

5. 将 oc 二进制文件移到 PATH 中的目录中。

   要查看您的 PATH，请打开命令提示并执行以下命令：

   C:\> path

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 从 版本 下拉列表中选择适当的版本。

3. 点 OpenShift v4.17 macOS Clients 条目旁的 Download Now 来保存文件。

   注意

   对于 macOS arm64，请选择 OpenShift v4.17 macOS arm64 Client 条目。

4. 解包和解压存档。

5. 将 oc 二进制文件移到 PATH 的目录中。

   要查看您的 PATH，请打开终端并执行以下命令：

   $ echo $PATH

1. 创建镜像设置配置文件。

2. 使用以下方法之一将镜像设置为目标镜像 registry：

   • 将镜像直接设置为目标镜像 registry。
   • 镜像集合镜像到磁盘，将镜像设置为目标环境，然后将镜像上传到目标镜像 registry。
3. 配置集群以使用 oc-mirror 插件生成的资源。
4. 根据需要重复这些步骤以更新目标镜像 registry。

流程

1. 下载 oc-mirror CLI 插件：

   1. 导航到 Red Hat Hybrid Cloud Console 的 Downloads 页面。
   2. 在 OpenShift disconnected installation tools 部分中，从下拉菜单中选择 OpenShift Client (oc)镜像插件的操作系统 类型和 架构类型。
   3. 点 Download 保存文件。

2. 运行以下命令来提取存档：

   $ tar xvzf oc-mirror.tar.gz

3. 如有必要，运行以下命令来将插件文件更新为可执行：

   $ chmod +x oc-mirror

   注意

   不要重命名 oc-mirror 文件。

4. 运行以下命令，将文件放在 PATH 中（如 /usr/local/bin ）来安装 oc-mirror CLI 插件：

   $ sudo mv oc-mirror /usr/local/bin/.

1. 从 Red Hat OpenShift Cluster Manager 下载 registry.redhat.io pull secret。

2. 运行以下命令，以 JSON 格式生成 pull secret 副本：

   $ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json> 1

   1

   指定到存储 pull secret 的文件夹的路径，以及您创建的 JSON 文件的名称。

   pull secret 示例

   {
     "auths": {
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

3. 将文件保存为 ~/.docker/config.json 或 $XDG_RUNTIME_DIR/containers/auth.json：

   1. 如果 .docker 或 $XDG_RUNTIME_DIR/containers 目录不存在，请输入以下命令来创建：

      $ mkdir -p <directory_name>

      其中 <directory_name> 是 ~/.docker 或 $XDG_RUNTIME_DIR/containers。

   2. 输入以下命令将 pull secret 复制到适当的目录中：

      $ cp <path>/<pull_secret_file_in_json> <directory_name>/<auth_file>

      其中 <directory_name> 是 ~/.docker 或 $XDG_RUNTIME_DIR/containers，<auth_file> 是 config.json 或 auth.json。

4. 运行以下命令，为您的镜像 registry 生成 base64 编码的用户名和密码或令牌：

   $ echo -n '<user_name>:<password>' | base64 -w0 1

   1

   通过 <user_name> 和 <password> 指定 registry 的用户名和密码。

   输出示例

   BGVtbYk3ZHAtqXs=

5. 编辑 JSON 文件并添加描述 registry 的部分：

     "auths": {
       "<mirror_registry>": { 1
         "auth": "<credentials>", 2
         "email": "you@example.com"
       }
     },

   1

   指定 registry 域名，以及您的镜像 registry 用来提供内容的可选端口。例如：registry.example.com 或 registry.example.com:8443

   2

   指定镜像 registry 的 base64 编码用户名和密码。

   修改的 pull secret 示例

   {
     "auths": {
       "registry.example.com": {
         "auth": "BGVtbYk3ZHAtqXs=",
         "email": "you@example.com"
       },
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

1. 创建镜像设置配置文件。

2. 使用以下工作流之一将镜像设置为目标镜像 registry：

   • 将镜像直接设置为目标镜像 registry (mirror 到 mirror)。
   • 将镜像设置为 disk (mirror to disk)，将 tar 文件传送到目标环境，然后将镜像设置为目标镜像 registry （镜像(mirror)。
3. 配置集群以使用 oc-mirror 插件 v2 生成的资源。
4. 根据需要重复这些步骤以更新目标镜像 registry。

流程

1. 下载 oc-mirror CLI 插件：

   1. 导航到 Red Hat Hybrid Cloud Console 的 Downloads 页面。
   2. 在 OpenShift disconnected installation tools 部分中，从下拉菜单中选择 OpenShift Client (oc)镜像插件的操作系统 类型和 架构类型。
   3. 点 Download 保存文件。

2. 运行以下命令来提取存档：

   $ tar xvzf oc-mirror.tar.gz

3. 如有必要，运行以下命令来将插件文件更新为可执行：

   $ chmod +x oc-mirror

   注意

   不要重命名 oc-mirror 文件。

4. 运行以下命令，将文件放在 PATH 中（如 /usr/local/bin ）来安装 oc-mirror CLI 插件：

   $ sudo mv oc-mirror /usr/local/bin/.

1. 从 Red Hat OpenShift Cluster Manager 下载 registry.redhat.io pull secret。

2. 运行以下命令，以 JSON 格式生成 pull secret 副本：

   $ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json> 1

   1

   指定到存储 pull secret 的文件夹的路径，以及您创建的 JSON 文件的名称。

   pull secret 示例

   {
     "auths": {
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

3. 如果 $XDG_RUNTIME_DIR/containers 目录不存在，请输入以下命令来创建：

   $ mkdir -p $XDG_RUNTIME_DIR/containers

4. 将 pull secret 文件保存为 $XDG_RUNTIME_DIR/containers/auth.json。

5. 运行以下命令，为您的镜像 registry 生成 base64 编码的用户名和密码或令牌：

   $ echo -n '<user_name>:<password>' | base64 -w0 1

   1

   通过 <user_name> 和 <password> 指定 registry 的用户名和密码。

   输出示例

   BGVtbYk3ZHAtqXs=

6. 编辑 JSON 文件并添加描述 registry 的部分：

     "auths": {
       "<mirror_registry>": { 1
         "auth": "<credentials>", 2
         "email": "you@example.com"
       }
     },

   1

   指定 registry 域名，以及您的镜像 registry 用来提供内容的可选端口。例如：registry.example.com 或 registry.example.com:8443

   2

   指定镜像 registry 的 base64 编码用户名和密码。

   修改的 pull secret 示例

   {
     "auths": {
       "registry.example.com": {
         "auth": "BGVtbYk3ZHAtqXs=",
         "email": "you@example.com"
       },
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

验证

1. 进入 < file_path > 目录中生成的 working-dir/cluster-resources 目录。
2. 验证 ImageDigestMirrorSet、ImageTagMirrorSet 和 CatalogSource 资源是否存在 YAML 文件。

1. 镜像到磁盘 ：将镜像设置为存档。
2. 磁盘传输 ：手动将存档传输到断开连接的镜像 registry 的网络。
3. Disk to mirror: 将存档中的镜像集镜像到目标断开连接的 registry。

流程

1. 以具有 cluster-admin 角色的用户身份登录 OpenShift CLI。

2. 运行以下命令，将结果目录中的 YAML 文件应用到集群：

   $ oc apply -f <path_to_oc_mirror_workspace>/working-dir/cluster-resources

验证

1. 运行以下命令验证 ImageDigestMirrorSet 资源是否已成功安装：

   $ oc get imagedigestmirrorset

2. 运行以下命令验证 ImageTagMirrorSet 资源是否已成功安装：

   $ oc get imagetagmirrorset

3. 运行以下命令验证 CatalogSource 资源是否已成功安装：

   $ oc get catalogsource -n openshift-marketplace

流程

1. 创建一个 delete-image-set-config.yaml 文件，并包含以下内容：

   DeleteImageSetConfiguration 文件

   apiVersion: mirror.openshift.io/v2alpha1
   kind: DeleteImageSetConfiguration
   delete:
     platform:
       channels:
         - name: <channel_name> 1
           minVersion: <channel_min_version> 2
           maxVersion: <channel_max_version> 3
     operators:
       - catalog: <operator_catalog_name> 4
         packages:
         - name: <operator_name> 5
            minVersion: <operator_max_version> 6
            maxVersion: <operator_min_version> 7
     additionalImages:
       - name: <additional_images> 8

   1 1

   指定要删除的 OpenShift Container Platform 频道的名称，如 stable-4.15。

   2 3

   指定要在频道中删除的镜像版本范围，例如，4.15.0 用于最大版本，4. 15.1 用于最大版本。要只删除一个版本的镜像，请将该版本号用于 minVersion 和 maxVersion 字段。

   4

   指定要删除的 Operator 目录镜像，如 registry.redhat.io/redhat/redhat-operator-index:v4.14。要删除目录镜像，您必须使用 delete.operators.packages 参数指定独立的 Operator。

   5

   指定要删除的特定 Operator 捆绑包，如 aws-load-balancer-operator。如果指定了单独的 Operator，Operator 目录镜像不会被删除。

   6 7

   为 Operator 指定要删除的镜像版本范围，如最小版本的 0.0.1，以及 0.0.2 代表最大版本。要只删除一个版本的镜像，请将该版本号用于 minVersion 和 maxVersion 字段。

   8

   指定要删除的额外镜像，如 registry.redhat.io/ubi9/ubi-init:latest。

2. 运行以下命令，创建一个 delete-images.yaml 文件：

   $ oc mirror delete --config delete-image-set-config.yaml --workspace file://<previously_mirrored_work_folder> --v2 --generate docker://<remote_registry>

   其中：

   <previously_mirrored_work_folder>

   指定镜像之前在镜像过程中被镜像或存储的目录。

   <remote_registry>

   指定将从中删除镜像的远程容器 registry 的 URL 或地址。

3. 进入创建的 & lt;previously_mirrored_work_folder>/delete 目录。
4. 验证 delete-images.yaml 文件是否已生成。
5. 手工确保文件中列出的每个镜像不再被集群需要，可以安全地从 registry 中删除。

6. 生成 delete-images YAML 文件后，运行以下命令来从远程 registry 中删除镜像：

   $ oc mirror delete --v2 --delete-yaml-file <previously_mirrored_work_folder>/working-dir/delete/delete-images.yaml docker://<remote_registry>

   其中：

   <previously_mirrored_work_folder>

   指定镜像之前在镜像过程中镜像或存储的目录。

   <remote_registry>

   指定将从中删除镜像的远程容器 registry 的 URL 或地址。

   重要

   当使用 mirror-to-mirror 方法镜像镜像时，镜像不会在本地缓存，因此您无法从本地缓存中删除镜像。

验证

1. 进入生成的工作区目录：

   $ cd <oc_mirror_workspace_path>

2. 检查生成的 mapping.txt 和 missing.txt 文件。这些文件包含将要镜像的所有镜像的列表。

流程

1. 检查与服务器相关的问题：

   错误示例

   [ERROR]  : [Worker] error mirroring image localhost:55000/openshift/graph-image:latest error: copying image 1/4 from manifest list: trying to reuse blob sha256:edab65b863aead24e3ed77cea194b6562143049a9307cd48f86b542db9eecb6e at destination: pinging container registry localhost:5000: Get "https://localhost:5000/v2/": http: server gave HTTP response to HTTPS client

   1. 在 oc-mirror 插件 v2 输出目录中，打开 working-dir/logs 文件夹中的 mirroring_error_date_time.log 文件。
   2. 查找表示服务器端问题的错误消息，如 HTTP 500 错误、令牌过期或超时。
   3. 如果问题仍然存在，请重试镜像过程或联系技术支持。

2. 检查对 Operator 进行镜像的过程不完整：

   错误示例

   error mirroring image docker://registry.redhat.io/3scale-amp2/zync-rhel9@sha256:8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d (Operator bundles: [3scale-operator.v0.11.12] - Operators: [3scale-operator]) error: initializing source docker://localhost:55000/3scale-amp2/zync-rhel9:8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d: reading manifest 8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d in localhost:55000/3scale-amp2/zync-rhel9: manifest unknown
   error mirroring image docker://registry.redhat.io/3scale-amp2/3scale-rhel7-operator-metadata@sha256:de0a70d1263a6a596d28bf376158056631afd0b6159865008a7263a8e9bf0c7d error: skipping operator bundle docker://registry.redhat.io/3scale-amp2/3scale-rhel7-operator-metadata@sha256:de0a70d1263a6a596d28bf376158056631afd0b6159865008a7263a8e9bf0c7d because one of its related images failed to mirror
   error mirroring image docker://registry.redhat.io/3scale-amp2/system-rhel7@sha256:fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e (Operator bundles: [3scale-operator.v0.11.12] - Operators: [3scale-operator]) error: initializing source docker://localhost:55000/3scale-amp2/system-rhel7:fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e: reading manifest fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e in localhost:55000/3scale-amp2/system-rhel7: manifest unknown

   1. 在控制台或日志文件中检查相关的警告，以了解哪些 Operator 不完整。

      如果一个 Operator 被标记为不完整，与该 Operator 相关的镜像可能会无法镜像 (mirror)。

   2. 手动镜像（mirror）缺少的镜像或重试镜像 (mirror) 的过程。

3. 检查与生成的集群资源相关的错误。即使无法镜像（mirror）某些镜像，oc-mirror v2 仍会为已成功镜像（mirror）的镜像生成集群资源，如 IDMS.yaml 和 ITMS.yaml 文件。

   1. 在输出目录中检查生成的文件。
   2. 如果特定镜像缺少了这些文件，请确保在镜像（mirror）过程中没有发生关键错误。

1. 用户执行 oc-mirror 插件 v2，将在线 registry 的内容镜像到本地磁盘目录。
2. 镜像内容保存到磁盘中，用于在离线环境中使用。

流程

1. 在断开连接的环境中运行 oc-mirror 插件 v2 之前，请创建一个 registry.conf 文件。该文件的 TOML 格式如下所述：

   注意

   建议将文件存储在 $HOME/.config/containers/registries.conf 或 /etc/containers/registries.conf 下。

   registry.conf 示例

   [[registry]]
   location="registry.redhat.io"
   [[registry.mirror]]
   location="<enterprise-registry.in>"
   
   [[registry]]
   location="quay.io"
   [[registry.mirror]]
   location="<enterprise-registry.in>"

2. 生成镜像存档。

   1. 要将所有 OpenShift Container Platform 内容收集到磁盘的一个归档中（<file_path>/enterprise-content），请运行以下命令：

      $ oc mirror --v2 -c isc.yaml file://<file_path>/enterprise-content

      isc.yaml 示例

      apiVersion: mirror.openshift.io/v2alpha1
      kind: ImageSetConfiguration
      mirror:
        platform:
          architectures:
            - "amd64"
          channels:
            - name: stable-4.15
              minVersion: 4.15.0
              maxVersion: 4.15.3

      生成存档后，它将传送到断开连接的环境中。传输机制不是 oc-mirror 插件 v2 的一部分。企业网络管理员需要负责制定传输策略。

      在某些情况下，传输是手动完成的，例如在一个没有网络连接的环境中，将磁盘从一个物理机器中拔出，并插入到另外一个系统。在其他情况下，使用安全文件传输协议 (SFTP) 或其他协议。

3. 完成存档传输后，您可以再次执行 oc-mirror 插件 v2，以便将相关存档内容镜像到 registry (在示例中是 entrerpise_registry.in)，如下例所示：

   $ oc mirror --v2 -c isc.yaml --from file://<disconnected_environment_file_path>/enterprise-content docker://<enterprise_registry.in>/

   其中：

   • --from 指向包含存档的文件夹。它以 file:// 开头。
   • docker:// 是镜像 (mirror) 的目的地，这是最后的参数。因为它是一个 docker registry。
   • -c (--config)是一个强制参数。它可让 oc-mirror 插件 v2 最终仅将存档的子部分镜像到 registry。一个存档可能包含几个 OpenShift Container Platform 版本，但断开连接的环境或 enclave 可能只镜像几个。

4. 准备 imageSetConfig YAML 文件，该文件描述了要镜像到 enclave 的内容：

   示例 isc-enclave.yaml

   apiVersion: mirror.openshift.io/v2alpha1
   kind: ImageSetConfiguration
   mirror:
     platform:
       architectures:
         - "amd64"
       channels:
         - name: stable-4.15
           minVersion: 4.15.2
           maxVersion: 4.15.2

   您必须在可访问断开连接的 registry 的机器上运行 oc-mirror 插件 v2。在上例中，可以访问断开连接的环境 enterprise-registry.in。

5. 更新图形 URL

   如果您使用 graph:true，oc-mirror 插件 v2 会尝试访问 cincinnati API 端点。由于此环境断开连接，因此请务必导出环境变量 UPDATE_URL_OVERRIDE，以引用 OpenShift Update Service (OSUS)的 URL：

   $ export UPDATE_URL_OVERRIDE=https://<osus.enterprise.in>/graph

   有关在 OpenShift 集群上设置 OSUS 的更多信息，请参阅"使用 OpenShift Update Service 在断开连接的环境中更新集群"。

   注意

   当在 OpenShift Container Platform 延长更新支持(EUS)版本间更新时，还必须在当前和目标版本间包括中间次版本的镜像。oc-mirror 插件 v2 可能并不总是自动检测此要求，因此请检查 Red Hat OpenShift Container Platform Update Graph 页面 以确认所需的中间版本。

   使用 Update Graph 页面查找应用程序推荐的中间次版本，在使用 oc-mirror 插件 v2 时，在 ImageSetConfiguration 文件中包括任何这些版本。

6. 为 enclave 从企业 registry 中生成镜像存档。

   要为 enclave1 准备存档，用户使用针对那个 enclave 专用的 imageSetConfiguration 在企业断开连接的环境中执行 oc-mirror 插件 v2。这样可确保仅镜像 enclave 需要的镜像：

   $ oc mirror --v2 -c isc-enclave.yaml
   file:///disk-enc1/

   此操作将所有 OpenShift Container Platform 内容收集到存档中，并在磁盘上生成存档。

7. 生成存档后，它将传送到 enclave1 网络。传输机制不是 oc-mirror 插件 v2 的责任。

8. 将内容镜像到 enclave registry

   完成存档传输后，用户可以再次执行 oc-mirror 插件 v2，以便将相关存档内容镜像到 registry。

   $ oc mirror --v2 -c isc-enclave.yaml --from file://local-disk docker://registry.enc1.in

   enclave1 中的 OpenShift Container Platform 集群的管理员现在可以安装或升级该集群。

流程

1. 使用 Red Hat OpenShift Container Platform Upgrade Graph visualizer 和 update planner 计划从一个版本升级到另一个版本。OpenShift Upgrade Graph 提供频道图形，并演示了如何确认您的当前和预定集群版本之间有更新路径。

2. 设置所需的环境变量：

   1. 导出发行版本信息：

      $ export OCP_RELEASE=<release_version>

      对于 <release_version>，请指定与升级到的 OpenShift Container Platform 版本对应的标签，如 4.5.4。

   2. 导出本地 registry 名称和主机端口：

      $ LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'

      对于 <local_registry_host_name>，请指定镜像存储库的 registry 域名；对于 <local_registry_host_port>，请指定用于提供内容的端口。

   3. 导出本地存储库名称：

      $ LOCAL_REPOSITORY='<local_repository_name>'

      对于 <local_repository_name>，请指定要在 registry 中创建的仓库名称，如 ocp4/openshift4。

   4. 如果使用 OpenShift Update Service，请导出一个额外的本地存储库名称，使其包含发行镜像：

      $ LOCAL_RELEASE_IMAGES_REPOSITORY='<local_release_images_repository_name>'

      对于 <local_release_images_repository_name>，请指定要在 registry 中创建的仓库名称，如 ocp4/openshift4-release-images。

   5. 导出要进行镜像的存储库名称：

      $ PRODUCT_REPO='openshift-release-dev'

      对于生产环境版本，必须指定 openshift-release-dev。

   6. 导出 registry pull secret 的路径：

      $ LOCAL_SECRET_JSON='<path_to_pull_secret>'

      对于 <path_to_pull_secret>，请指定您创建的镜像 registry 的 pull secret 的绝对路径和文件名。

      注意

      如果您的集群使用 ImageContentSourcePolicy 对象来配置存储库镜像，则只能将全局 pull secret 用于镜像 registry。您不能在项目中添加 pull secret。

   7. 导出发行版本镜像：

      $ RELEASE_NAME="ocp-release"

      对于生产环境版本，您必须指定 ocp-release。

   8. 为您的集群导出构架类型：

      $ ARCHITECTURE=<cluster_architecture> 1

      1

      指定集群的构架，如 x86_64, aarch64, s390x, 获 ppc64le。

   9. 导出托管镜像的目录的路径：

      $ REMOVABLE_MEDIA_PATH=<path> 1

      1

      指定完整路径，包括开始的前斜杠(/)字符。

3. 查看要镜像的镜像和配置清单：

   $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} --dry-run

4. 将版本镜像镜像(mirror)到镜像 registry。

   • 如果您的镜像主机无法访问互联网，请执行以下操作：

     1. 将可移动介质连接到连接到互联网的系统。

     2. 将镜像和配置清单镜像到可移动介质的目录中：

        $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}

        注意

        此命令还会生成镜像发行镜像签名配置映射并将其保存到可移动介质中。

     3. 将介质上传到受限网络环境中，并将镜像上传到本地容器 registry。

        $ oc image mirror  -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror "file://openshift/release:${OCP_RELEASE}*" ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} 1

        1

        对于 REMOVABLE_MEDIA_PATH，您必须使用与镜像镜像时指定的同一路径。

     4. 使用 oc 命令行界面(CLI)登录到您要升级的集群。

     5. 将镜像发行镜像签名配置映射应用到连接的集群：

        $ oc apply -f ${REMOVABLE_MEDIA_PATH}/mirror/config/<image_signature_file> 1

        1

        对于 <image_signature_file>，指定文件的路径和名称，例如 signature-sha256-81154f5c03294534.yaml。

     6. 如果使用 OpenShift Update Service，请将发行镜像镜像到单独的存储库：

        $ oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}

   • 如果本地容器 registry 和集群连接到镜像主机，请执行以下操作：

     1. 将发行镜像直接推送到本地 registry，并使用以下命令将配置映射应用到集群：

        $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \
          --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} --apply-release-image-signature

        注意

        如果包含 --apply-release-image-signature 选项，不要为镜像签名验证创建配置映射。

     2. 如果使用 OpenShift Update Service，请将发行镜像镜像到单独的存储库：

        $ oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}

流程

1. 在 Web 控制台中，点 Operators → OperatorHub。

   注意

   在 Filter by keyword…​ 字段中输入 Update Service，以更快地查找 Operator。

2. 从可用的 Operator 列表中选择 OpenShift Update Service，然后点 Install。

   1. 选择一个 更新频道。
   2. 选择 版本。
   3. 在 Installation Mode 下选择 A specific namespace on the cluster。
   4. 为 Installed Namespace 选择一个命名空间，或接受推荐的命名空间 openshift-update-service。

   5. 选择一个 更新批准策略：

      • Automatic 策略允许 Operator Lifecycle Manager（OLM）在有新版本可用时自动更新 Operator。
      • Manual 策略要求集群管理员批准 Operator 更新。
   6. 点 Install。
3. 进入 Operators → Installed Operators，验证是否安装了 OpenShift Update Service Operator。
4. 确保 OpenShift Update Service 列在正确的命名空间中，Status 为 Succeeded。

流程

1. 为 OpenShift Update Service Operator 创建命名空间：

   1. 为 OpenShift Update Service Operator 创建一个 Namespace 对象 YAML 文件，如 update-service-namespace.yaml：

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-update-service
        annotations:
          openshift.io/node-selector: ""
        labels:
          openshift.io/cluster-monitoring: "true" 1

      1

      将 openshift.io/cluster-monitoring 标签设置为在该命名空间中启用 Operator-recommended 集群监控。

   2. 创建命名空间：

      $ oc create -f <filename>.yaml

      例如：

      $ oc create -f update-service-namespace.yaml

2. 通过创建以下对象来安装 OpenShift Update Service Operator：

   1. 创建一个 OperatorGroup 对象 YAML 文件，如 update-service-operator-group.yaml：

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: update-service-operator-group
        namespace: openshift-update-service
      spec:
        targetNamespaces:
        - openshift-update-service

   2. 创建一个 OperatorGroup 对象：

      $ oc -n openshift-update-service create -f <filename>.yaml

      例如：

      $ oc -n openshift-update-service create -f update-service-operator-group.yaml

   3. 创建一个 Subscription 对象 YAML 文件，如 update-service-subscription.yaml：

      订阅示例

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: update-service-subscription
        namespace: openshift-update-service
      spec:
        channel: v1
        installPlanApproval: "Automatic"
        source: "redhat-operators" 1
        sourceNamespace: "openshift-marketplace"
        name: "cincinnati-operator"

      1

      指定提供 Operator 的目录源的名称。对于不使用自定义 Operator Lifecycle Manager（OLM）的集群，指定 redhat-operators。如果 OpenShift Container Platform 集群安装在断开连接的环境中，请指定配置 Operator Lifecycle Manager (OLM) 时创建的 CatalogSource 对象的名称。

   4. 创建 Subscription 对象：

      $ oc create -f <filename>.yaml

      例如：

      $ oc -n openshift-update-service create -f update-service-subscription.yaml

      OpenShift Update Service Operator 被安装到 openshift-update-service 命名空间，并以 openshift-update-service 命名空间为目标。

3. 验证 Operator 安装：

   $ oc -n openshift-update-service get clusterserviceversions

   输出示例

   NAME                             DISPLAY                    VERSION   REPLACES   PHASE
   update-service-operator.v4.6.0   OpenShift Update Service   4.6.0                Succeeded
   ...

   如果列出了 OpenShift Update Service Operator，则会成功安装。版本号可能与所示不同。

流程

1. 在 Web 控制台中，点 Operators → Installed Operators。
2. 从安装的 Operator 列表中选择 OpenShift Update Service。
3. 点 Update Service 选项卡。
4. 点 Create UpdateService。
5. 在 Name 字段中输入名称，如 service。
6. 在 Graph Data Image 字段中输入本地 pullspec，指向在"创建 OpenShift Update Service 图形数据容器镜像"中创建的图形数据容器镜像，如 registry.example.com/openshift/graph-data:latest。
7. 在 Releases 字段中，输入创建的 registry 和存储库，以在"镜像 OpenShift Container Platform 镜像存储库"中包括发行镜像，例如 registry.example.com/ocp4/openshift4-release-images。
8. 在 Replicas 字段中输入 2。
9. 单击 Create 以创建 OpenShift Update Service 应用。

10. 验证 OpenShift Update Service 应用程序：

    • 从 Update Service 选项卡中的 UpdateServices 列表中，点刚才创建的 Update Service 应用程序。
    • 单击 Resources 选项卡。
    • 验证每个应用资源的状态是否为 Created。

流程

1. 配置 OpenShift Update Service 目标命名空间，如 openshift-update-service：

   $ NAMESPACE=openshift-update-service

   命名空间必须与 operator 组中的 targetNamespaces 值匹配。

2. 配置 OpenShift Update Service 应用程序的名称，如 service：

   $ NAME=service

3. 按照"镜像 OpenShift Container Platform 镜像存储库"中配置，为发行镜像配置 registry 和存储库，如 registry.example.com/ocp4/openshift4-release-images：

   $ RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images

4. 将 graph-data 镜像的本地 pullspec 设置为在"创建 OpenShift Update Service 图形数据容器镜像"中创建的图形数据容器镜像，如 registry.example.com/openshift/graph-data:latest:

   $ GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest

5. 创建 OpenShift Update Service 应用程序对象：

   $ oc -n "${NAMESPACE}" create -f - <<EOF
   apiVersion: updateservice.operator.openshift.io/v1
   kind: UpdateService
   metadata:
     name: ${NAME}
   spec:
     replicas: 2
     releases: ${RELEASE_IMAGES}
     graphDataImage: ${GRAPH_DATA_IMAGE}
   EOF

6. 验证 OpenShift Update Service 应用程序：

   1. 使用以下命令获取策略引擎路由：

      $ while sleep 1; do POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"; SCHEME="${POLICY_ENGINE_GRAPH_URI%%:*}"; if test "${SCHEME}" = http -o "${SCHEME}" = https; then break; fi; done

      您可能需要轮询，直到命令成功为止。

   2. 从策略引擎检索图形。确保为 channel 指定一个有效版本。例如，如果在 OpenShift Container Platform 4.17 中运行，请使用 stable-4.17 ：

      $ while sleep 10; do HTTP_CODE="$(curl --header Accept:application/json --output /dev/stderr --write-out "%{http_code}" "${POLICY_ENGINE_GRAPH_URI}?channel=stable-4.6")"; if test "${HTTP_CODE}" -eq 200; then break; fi; echo "${HTTP_CODE}"; done

      这会轮询到图形请求成功为止，但生成的图形可能为空，具体取决于您已镜像的发行镜像。