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

准备在 Azure Stack Hub 上安装集群

您可以通过完成以下步骤来准备在 Azure Stack Hub 上安装 OpenShift Container Platform 集群

  • 验证集群的互联网连接。

  • 配置 Azure Stack Hub 帐户.

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

  • 下载安装程序。

  • 安装 OpenShift CLI (oc)。

  • Cloud Credential Operator (CCO) 仅以手动模式支持您的云提供商。因此，您必须手动管理云凭据，方法是指定云提供商的身份和访问管理 (IAM) 密钥。

OpenShift Container Platform 的互联网访问

在 OpenShift Container Platform 4.17 中，您需要访问互联网才能安装集群。

您必须具有互联网访问权限才能

  • 访问OpenShift 集群管理器以下载安装程序并执行订阅管理。如果集群具有互联网访问权限并且您没有禁用遥测，则该服务会自动授权您的集群。

  • 访问Quay.io获取安装集群所需的软件包。

  • 获取执行集群更新所需的软件包。

如果您的集群无法直接访问互联网，您可以在您配置的某些类型的基础设施上执行受限网络安装。在此过程中，您可以下载所需内容并使用它来填充镜像注册表中的安装包。对于某些安装类型，您安装集群的环境不需要访问互联网。在更新集群之前，请更新镜像注册表的内容。

生成用于集群节点 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目录中。

    如果您计划安装一个 OpenShift Container Platform 集群，该集群仅在x86_64、ppc64le和s390x架构上使用已提交给 NIST 用于 FIPS 140-2/140-3 验证的 RHEL 加密库，请不要创建使用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 公钥。

获取安装程序

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

先决条件

  • 您需要一台运行 Linux 或 macOS 的计算机，并具有 500 MB 的本地磁盘空间。

步骤

  1. 转到 Red Hat Hybrid Cloud Console 上的集群类型页面。如果您有 Red Hat 帐户，请使用您的凭据登录。如果没有，请创建一个帐户。

  2. 从页面上的“自己运行”部分选择您的基础设施提供商。

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

  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>

OpenShift Container Platform 的遥测访问

在 OpenShift Container Platform 4.17 中，默认运行的遥测服务用于提供有关集群健康状况和更新成功情况的指标，需要访问互联网。如果您的集群已连接到互联网，则遥测服务会自动运行，并且您的集群会注册到OpenShift 集群管理器。

确认您的OpenShift 集群管理器清单正确无误后（无论是由遥测服务自动维护还是通过 OpenShift 集群管理器手动维护），使用订阅监控来跟踪您在帐户或多集群级别上的 OpenShift Container Platform 订阅。

其他资源