OpenShift4.17.17离线安装Operator ODF指南

OpenShift4.17.17离线安装Operator ODF指南

目标: 准备一台 Registry 主机（堡垒机）和本地容器镜像仓库，以便后续使用 oc-mirror 工具镜像 OpenShift Container Platform (OCP) 及其 Operator 镜像，用于离线安装。

环境假设:

• Registry 主机: 一台 RHEL 9 (或兼容系统，如 CentOS Stream 9, Rocky Linux 9) 服务器，具有访问互联网（或通过代理访问）以及目标 OpenShift 集群网络的权限。
• 工具: Registry 主机上需要安装 podman, httpd-tools (提供 htpasswd), tar, curl, wget。
• 域名/主机名: Registry 主机需要一个稳定且可被集群节点解析的主机名或 FQDN。我们将在配置中使用占位符 ${DNSDOMAINNAME}，请替换为您实际使用的 FQDN（例如：registry.example.org）。
• 存储: Registry 主机需要足够的磁盘空间来存储镜像文件和本地仓库数据。

一、 Registry 主机准备

1. 安装必要工具:

   • 目的: 确保运行 oc-mirror 和创建本地仓库所需的软件包已安装。

   • 命令 (在 Registry 主机执行):

     sudo dnf install -y podman httpd-tools curl tar wget
     

2. 下载并安装 oc-mirror 工具:

   • 目的: 获取 OpenShift 提供的镜像工具。

   • 操作 (在 Registry 主机执行):

     • 选择 OCP 版本 (示例为 4.17.17，请根据需要调整):

       # 设置 OCP 版本变量 (请根据需要修改)
       OCP_VERSION="4.17.17"
       OC_MIRROR_URL="[https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$](https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$){OCP_VERSION}/oc-mirror.rhel9.tar.gz"
       

     • 下载 oc-mirror 压缩包:

       wget ${OC_MIRROR_URL}
       

     • 解压、添加执行权限并移动到系统路径:

       # 注意：根据实际下载的文件名调整通配符
       tar -xvf oc-mirror.*.tar.gz
       chmod +x ./oc-mirror
       sudo mv ./oc-mirror /usr/local/bin/
       

     • 验证安装:

       oc-mirror version
       

二、 本地容器镜像仓库设置 (使用 Podman)

1. 定义仓库主机名/域名:

   • 目的: 确定本地仓库的访问地址，用于生成证书和配置。

   • 操作:

     # **重要:** 请将 'registry.example.org' 替换为您 Registry 主机的实际 FQDN
     export DNSDOMAINNAME="registry.example.org"
     

   • 注意: 确保后续所有节点（包括 Registry 自身和 OCP 集群节点）都能将此 ${DNSDOMAINNAME} 解析到 Registry 主机的 IP 地址。这可能需要配置 DNS 或修改 /etc/hosts 文件。

2. 创建仓库所需目录:

   • 目的: 准备用于存储仓库数据、认证文件和 TLS 证书的持久化目录。

   • 命令 (在 Registry 主机执行):

     sudo mkdir -p /opt/registry/{
            
            data,auth,certs}
     

3. 创建仓库认证文件:

   • 目的: 设置访问本地仓库的用户名和密码。

   • 操作 (在 Registry 主机执行):

     • 重要: 将 [REGISTRY_PASSWORD] 替换为您要设置的强密码。建议使用安全的方式输入密码，例如：

       # 设置密码变量 (避免密码直接出现在命令行历史中)
       # read -sp "请输入本地镜像仓库 'admin' 用户的密码: " REGISTRY_PASSWORD; echo
       export REGISTRY_PASSWORD="[REGISTRY_PASSWORD]" # 或者直接在此处设置
       # 创建 htpasswd 文件
       sudo htpasswd -bBc /opt/registry/auth/htpasswd admin "${REGISTRY_PASSWORD}"
       

     • 记录此密码，后续配置和登录时需要使用。