OpenShift 文档正在迁移，很快将只在 docs.redhat.com（所有 Red Hat 产品文档的中心）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

准备使用安装程序配置的基础架构安装集群

您需要完成以下步骤，才能在vSphere上安装OpenShift Container Platform集群

  • 下载安装程序。

    如果您在脱机环境中安装，则需要从镜像内容中提取安装程序。更多信息，请参见 脱机安装的镜像镜像。

  • 安装OpenShift CLI (oc)。

    如果您在脱机环境中安装，请将oc安装到镜像主机。

  • 生成SSH密钥对。您可以使用此密钥对在OpenShift Container Platform集群部署后对其节点进行身份验证。

  • 将vCenter的受信任根CA证书添加到您的系统信任存储中。

获取安装程序

在安装OpenShift Container Platform之前，请在您用于安装的主机上下载安装文件。

先决条件

  • 您有一台运行Linux（例如Red Hat Enterprise Linux 8）的机器，具有500 MB的本地磁盘空间。

    如果您尝试在macOS上运行安装程序，则与golang编译器相关的已知问题会导致OpenShift Container Platform集群安装失败。有关此问题的更多信息，请参阅OpenShift Container Platform 4.17发行说明文档中名为“已知问题”的部分。
步骤

  1. 转到Red Hat混合云控制台上的集群类型页面。如果您有Red Hat帐户，请使用您的凭据登录。如果没有，请创建一个帐户。

  2. 从页面自行运行部分选择您的基础架构提供商。

  3. 从OpenShift Installer下的下拉菜单中选择您的主机操作系统和架构，然后单击下载安装程序。

  4. 将下载的文件放在您想要存储安装配置文件的目录中。

    • 安装程序会在您用来安装集群的计算机上创建多个文件。您必须在完成集群安装后保留安装程序和安装程序创建的文件。这两个文件都是删除集群所必需的。

    • 即使集群在安装过程中失败，删除安装程序创建的文件也不会删除您的集群。要删除集群，请完成针对您的特定云提供商的OpenShift Container Platform卸载过程。

  5. 提取安装程序。例如，在使用Linux操作系统的计算机上，运行以下命令

    $ tar -xvf openshift-install-linux.tar.gz

  6. 从Red Hat OpenShift集群管理器下载您的安装pull secret。此pull secret允许您对包含的授权机构提供的服务进行身份验证，包括提供OpenShift Container Platform组件容器镜像的Quay.io。

或者，您可以从Red Hat客户门户检索安装程序，您可以在其中指定要下载的安装程序版本。但是，您必须拥有有效的订阅才能访问此页面。

安装OpenShift CLI

您可以安装OpenShift CLI (oc) 以通过命令行界面与OpenShift Container Platform进行交互。您可以在Linux、Windows或macOS上安装oc。

如果您安装了早期版本的oc，则无法使用它来完成OpenShift Container Platform 4.17中的所有命令。请下载并安装新版本的oc。

在Linux上安装OpenShift CLI

您可以使用以下步骤在Linux上安装OpenShift CLI (oc) 二进制文件。

步骤

  1. 导航到Red Hat客户门户上的OpenShift Container Platform下载页面。

  2. 从产品变体下拉列表中选择架构。

  3. 从**版本**下拉列表中选择相应的版本。

  4. 点击**OpenShift v4.17 Linux客户端**条目旁边的**立即下载**，并保存文件。

  5. 解压归档文件。

    $ tar xvf <file>

  6. 将oc二进制文件放置到您的PATH环境变量包含的目录中。

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

    $ echo $PATH
验证

  • 安装OpenShift CLI后，可以使用oc命令。

    $ oc <command>

在Windows上安装OpenShift CLI

您可以使用以下步骤在Windows上安装OpenShift CLI（oc）二进制文件。

步骤

  1. 导航到Red Hat客户门户上的OpenShift Container Platform下载页面。

  2. 从**版本**下拉列表中选择相应的版本。

  3. 点击**OpenShift v4.17 Windows客户端**条目旁边的**立即下载**，并保存文件。

  4. 使用ZIP程序解压缩归档文件。

  5. 将oc二进制文件移动到PATH环境变量包含的目录中。

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

    C:\> path
验证

  • 安装OpenShift CLI后，可以使用oc命令。

    C:\> oc <command>

在macOS上安装OpenShift CLI

您可以使用以下步骤在macOS上安装OpenShift CLI（oc）二进制文件。

步骤

  1. 导航到Red Hat客户门户上的OpenShift Container Platform下载页面。

  2. 从**版本**下拉列表中选择相应的版本。

  3. 点击**OpenShift v4.17 macOS客户端**条目旁边的**立即下载**，并保存文件。

    对于macOS arm64，请选择**OpenShift v4.17 macOS arm64客户端**条目。

  4. 解压归档文件。

  5. 将oc二进制文件移动到PATH环境变量包含的目录中。

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

    $ echo $PATH
验证

  • 使用oc命令验证您的安装。

    $ oc <command>

生成集群节点SSH访问的密钥对

在OpenShift Container Platform安装期间，您可以向安装程序提供SSH公钥。该密钥通过其Ignition配置文件传递给Red Hat Enterprise Linux CoreOS (RHCOS)节点，并用于验证对节点的SSH访问。该密钥将添加到每个节点上core用户的~/.ssh/authorized_keys列表中，从而启用无密码身份验证。

密钥传递到节点后，您可以使用密钥对以core用户身份通过SSH登录到RHCOS节点。要通过SSH访问节点，必须由本地用户的SSH管理私钥身份。

如果您想通过SSH登录到集群节点以执行安装调试或灾难恢复，则必须在安装过程中提供SSH公钥。./openshift-install gather命令也需要集群节点上存在SSH公钥。

在需要灾难恢复和调试的生产环境中，请勿跳过此步骤。

您必须使用本地密钥，而不是使用特定于平台的方法（例如AWS密钥对）配置的密钥。
步骤

  1. 如果您的本地机器上没有现有的SSH密钥对可用于身份验证到您的集群节点，请创建一个。例如，在使用Linux操作系统的计算机上，运行以下命令：

    $ ssh-keygen -t ed25519 -N '' -f <path>/<file_name> (1)
    1 指定新SSH密钥的路径和文件名，例如~/.ssh/id_ed25519。如果您有现有的密钥对，请确保您的公钥位于~/.ssh目录中。

    如果您计划安装一个使用已提交给NIST进行FIPS 140-2/140-3验证的RHEL加密库的OpenShift Container Platform集群（仅限于x86_64、ppc64le和s390x架构），请不要创建使用ed25519算法的密钥。而是创建一个使用rsa或ecdsa算法的密钥。

  2. 查看SSH公钥

    $ cat <path>/<file_name>.pub

    例如，运行以下命令查看~/.ssh/id_ed25519.pub公钥：

    $ cat ~/.ssh/id_ed25519.pub

  3. 如果尚未添加，请将SSH私钥身份添加到本地用户的SSH代理。如果要对集群节点进行无密码SSH身份验证，或者要使用./openshift-install gather命令，则需要SSH代理管理密钥。

    在某些发行版上，默认的SSH私钥身份（例如~/.ssh/id_rsa和~/.ssh/id_dsa）会自动管理。

    1. 如果本地用户的ssh-agent进程尚未运行，请将其作为后台任务启动：

      $ eval "$(ssh-agent -s)"
      示例输出
      Agent pid 31874

      如果您的集群处于FIPS模式，则只能使用符合FIPS的算法来生成SSH密钥。密钥必须是RSA或ECDSA。

  4. 将您的SSH私钥添加到ssh-agent

    $ ssh-add <path>/<file_name> (1)
    1 指定SSH私钥的路径和文件名，例如~/.ssh/id_ed25519
    示例输出
    Identity added: /home/<you>/<path>/<file_name> (<computer_name>)
后续步骤

  • 安装OpenShift Container Platform时，请向安装程序提供SSH公钥。

将vCenter根CA证书添加到您的系统信任库

由于安装程序需要访问您的vCenter的API，因此您必须在安装OpenShift Container Platform集群之前将vCenter的受信任根CA证书添加到您的系统信任库。

步骤

  1. 从vCenter主页下载vCenter的根CA证书。点击vSphere Web Services SDK部分中的**下载受信任的根CA证书**。将下载<vCenter>/certs/download.zip文件。

  2. 解压缩包含vCenter根CA证书的压缩文件。压缩文件的内容类似于以下文件结构：

    certs
├── lin
│   ├── 108f4d17.0
│   ├── 108f4d17.r1
│   ├── 7e757f6a.0
│   ├── 8e4f8471.0
│   └── 8e4f8471.r0
├── mac
│   ├── 108f4d17.0
│   ├── 108f4d17.r1
│   ├── 7e757f6a.0
│   ├── 8e4f8471.0
│   └── 8e4f8471.r0
└── win
    ├── 108f4d17.0.crt
    ├── 108f4d17.r1.crl
    ├── 7e757f6a.0.crt
    ├── 8e4f8471.0.crt
    └── 8e4f8471.r0.crl

3 directories, 15 files

  3. 将您的操作系统所需的文件添加到系统信任库。例如，在Fedora操作系统上，运行以下命令：

    # cp certs/lin/* /etc/pki/ca-trust/source/anchors

  4. 更新您的系统信任库。例如，在Fedora操作系统上，运行以下命令：

    # update-ca-trust extract