3.3. 对 Red Hat OpenShift Service on AWS 经典架构镜像存储库进行镜像(mirror)

流程

1. 查看 Download Red Hat OpenShift Service on AWS 经典架构 页面，以确定您要安装的 Red Hat OpenShift Service on AWS 经典架构版本，并在 Repository Tags 页面中确定对应的标签。

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

   1. 导出发行版本信息：

      $ OCP_RELEASE=<release_version>

      对于 <release_version >，请指定与要安装的 Red Hat OpenShift Service on AWS 经典架构对应的标签，如 4.20.1。

   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. 导出要进行镜像的存储库名称：

      $ PRODUCT_REPO='openshift-release-dev'

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

   5. 导出 registry pull secret 的路径：

      $ LOCAL_SECRET_JSON='<path_to_pull_secret>'

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

   6. 导出发行版本镜像：

      $ RELEASE_NAME="ocp-release"

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

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

      $ ARCHITECTURE=<cluster_architecture>

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

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

      $ REMOVABLE_MEDIA_PATH=<path>

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

3. 将版本镜像(mirror)到镜像 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} \
           --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}

      该命令将发行信息提取为摘要，其输出包括安装集群时所需的 imageContentSources 数据。

   2. 记录上一命令输出中的 imageContentSources 部分。您的镜像信息与您的镜像存储库相对应，您必须在安装过程中将 imageContentSources 部分添加到 install-config.yaml 文件中。

      注意

      在镜像过程中，镜像名称会修补到 Quay.io，Podman 镜像在 bootstrap 虚拟机上的 registry 中显示 quay.io。

4. 要创建基于您镜像内容的安装程序，请运行以下命令将其固定到发行版本中：

   $ oc adm release extract -a ${LOCAL_SECRET_JSON} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}"

   重要

   要确保为您选择的 Red Hat OpenShift Service on AWS 经典架构使用正确的镜像，您必须从镜像内容中提取安装程序。

   您必须在有活跃互联网连接的机器上执行这个步骤。

5. 对于使用安装程序置备的基础架构的集群，运行以下命令：

   $ openshift-install