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)。

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>