4.15. 在带有 AWS Outposts 中的远程 worker 的 AWS 上安装集群

流程

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

   $ ssh-keygen -t ed25519 -N '' -f <path>/<file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   指定新 SSH 密钥的路径和文件名，如 ~/.ssh/id_ed25519。如果您已有密钥对，请确保您的公钥位于 ~/.ssh 目录中。

   注意

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

2. 查看公共 SSH 密钥：

   $ cat <path>/<file_name>.pub

   Copy to Clipboard Toggle word wrap

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

   $ cat ~/.ssh/id_ed25519.pub

   Copy to Clipboard Toggle word wrap

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

   注意

   在某些发行版中，自动管理默认 SSH 私钥身份，如 ~/.ssh/id_rsa 和 ~/.ssh/id_dsa。

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

      $ eval "$(ssh-agent -s)"

      Copy to Clipboard Toggle word wrap

      输出示例

      Agent pid 31874

      Copy to Clipboard Toggle word wrap

      注意

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

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

   $ ssh-add <path>/<file_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   指定 SSH 私钥的路径和文件名，如 ~/.ssh/id_ed25519.pub

   输出示例

   Identity added: /home/<you>/<path>/<file_name> (<computer_name>)

   Copy to Clipboard Toggle word wrap

流程

1. 访问 OpenShift Cluster Manager 站点的 Infrastructure Provider 页面。如果您有红帽帐户，请使用您的凭证登录。如果没有，请创建一个帐户。
2. 选择您的基础架构供应商。

3. 进入到安装类型的页面，下载与您的主机操作系统和架构对应的安装程序，并将该文件放在您要存储安装配置文件的目录中。

   重要

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

   重要

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

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

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

   Copy to Clipboard Toggle word wrap
5. 从 Red Hat OpenShift Cluster Manager 下载安装 pull secret。此 pull secret 允许您与所含授权机构提供的服务进行身份验证，这些服务包括为 OpenShift Container Platform 组件提供容器镜像的 Quay.io。

1. 当未启用并发多线程 (SMT) 或超线程时，一个 vCPU 相当于一个物理内核。启用后，使用以下公式来计算对应的比例：（每个内核数的线程）× sockets = vCPU。
2. OpenShift Container Platform 和 Kubernetes 对磁盘性能非常敏感，建议使用更快的存储速度，特别是 control plane 节点上需要 10 ms p99 fsync 持续时间的 etcd。请注意，在许多云平台上，存储大小和 IOPS 可一起扩展，因此您可能需要过度分配存储卷来获取足够的性能。
3. 与所有用户置备的安装一样，如果您选择在集群中使用 RHEL 计算机器，则负责所有操作系统生命周期管理和维护，包括执行系统更新、应用补丁和完成所有其他必要的任务。RHEL 7 计算机器的使用已弃用，并已在 OpenShift Container Platform 4.10 及更新的版本中删除。

流程

1. 创建 install-config.yaml 文件。

   1. 进入包含安装程序的目录并运行以下命令：

      $ ./openshift-install create install-config --dir <installation_directory> 

      1

      Copy to Clipboard Toggle word wrap

      1

      对于 <installation_directory>，请指定要存储安装程序创建的文件的目录名称。

      在指定目录时：

      • 验证该目录是否具有执行权限。在安装目录中运行 Terraform 二进制文件需要这个权限。

      • 使用空目录。有些安装资产，如 bootstrap X.509 证书的过期间隔较短，因此不得重复使用安装目录。如果要重复使用另一个集群安装中的单个文件，您可以将它们复制到您的目录中。但是，安装资产的文件名可能会在发行版本间有所变化。从以前的 OpenShift Container Platform 版本中复制安装文件时请小心。

        注意

        始终删除 ~/.powervs 目录，以避免重复使用过时的配置。运行以下命令:

        $ rm -rf ~/.powervs

        Copy to Clipboard Toggle word wrap

   2. 在提示符处，提供云的配置详情：

      1. 可选： 选择用于访问集群机器的 SSH 密钥。

         注意

         对于您要在其上执行安装调试或灾难恢复的生产环境 OpenShift Container Platform 集群，请指定 ssh-agent 进程使用的 SSH 密钥。

      2. 选择 AWS 作为目标平台。
      3. 如果计算机上没有保存 Amazon Web Services (AWS) 配置集，请为您配置用于运行安装程序的用户输入 AWS 访问密钥 ID 和 Secret 访问密钥。
      4. 选择要将集群部署到的 AWS 区域。
      5. 选择您为集群配置的 Route 53 服务的基域。
      6. 为集群输入描述性名称。

2. 修改 install-config.yaml 文件。AWS Outposts 安装有以下限制，需要手动修改 install-config.yaml 文件：

   • 与提供接近规模的 AWS 区域不同，AWS Outposts 被其置备的容量、EC2 系列和生成、配置的实例大小以及尚未被其他工作负载消耗的计算容量的限制。因此，在创建新的 OpenShift Container Platform 集群时，您需要在配置文件的 compute.platform.aws.type 部分中提供支持的实例类型。
   • 当使用在 AWS Outposts 中运行的远程 worker 部署 OpenShift Container Platform 集群时，只有一个可用区可用于计算实例 - 创建 Outpost 实例的可用区。因此，在创建新的 OpenShift Container Platform 集群时，建议您在配置文件中的 compute.platform.aws.zones 部分中提供相关的可用区，以便将计算实例限制到此可用区。
   • AWS Outposts 服务不支持 Amazon Elastic Block Store (EBS) gp3 卷。此卷类型是 OpenShift Container Platform 集群使用的默认类型。因此，在创建新的 OpenShift Container Platform 集群时，必须将 compute.platform.aws.rootVolume.type 部分中的卷类型改为 gp2。您将找到有关如何更改这些值的更多信息。

3. 备份 install-config.yaml 文件，以便您可以使用它安装多个集群。

   重要

   install-config.yaml 文件会在安装过程中消耗掉。如果要重复使用此文件，必须现在备份。

流程

1. 可选：创建 install-config.yaml 文件的备份副本：

   $ cp install-config.yaml install-config.yaml.backup

   Copy to Clipboard Toggle word wrap

2. 在资产目录中生成一组清单：

   $ openshift-install create manifests --dir <installation_-_directory>

   Copy to Clipboard Toggle word wrap

   此命令显示以下消息：

   输出示例

   INFO Consuming Install Config from target directory
   INFO Manifests created in: <installation_directory>/manifests and <installation_directory>/openshift

   Copy to Clipboard Toggle word wrap

   该命令生成以下清单文件：

   输出示例

   $ tree
   .
   ├── manifests
   │   ├── cluster-config.yaml
   │   ├── cluster-dns-02-config.yml
   │   ├── cluster-infrastructure-02-config.yml
   │   ├── cluster-ingress-02-config.yml
   │   ├── cluster-network-01-crd.yml
   │   ├── cluster-network-02-config.yml
   │   ├── cluster-proxy-01-config.yaml
   │   ├── cluster-scheduler-02-config.yml
   │   ├── cvo-overrides.yaml
   │   ├── kube-cloud-config.yaml
   │   ├── kube-system-configmap-root-ca.yaml
   │   ├── machine-config-server-tls-secret.yaml
   │   └── openshift-config-secret-pull-secret.yaml
   └── openshift
       ├── 99_cloud-creds-secret.yaml
       ├── 99_kubeadmin-password-secret.yaml
       ├── 99_openshift-cluster-api_master-machines-0.yaml
       ├── 99_openshift-cluster-api_master-machines-1.yaml
       ├── 99_openshift-cluster-api_master-machines-2.yaml
       ├── 99_openshift-cluster-api_master-user-data-secret.yaml
       ├── 99_openshift-cluster-api_worker-machineset-0.yaml
       ├── 99_openshift-cluster-api_worker-user-data-secret.yaml
       ├── 99_openshift-machineconfig_99-master-ssh.yaml
       ├── 99_openshift-machineconfig_99-worker-ssh.yaml
       ├── 99_role-cloud-creds-secret-reader.yaml
       └── openshift-install-manifests.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 从 产品变体 下拉列表中选择架构。
3. 从 版本 下拉列表中选择适当的版本。
4. 点 OpenShift v4.14 Linux Client 条目旁的 Download Now 来保存文件。

5. 解包存档：

   $ tar xvf <file>

   Copy to Clipboard Toggle word wrap

6. 将 oc 二进制文件放到 PATH 中的目录中。

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

   $ echo $PATH

   Copy to Clipboard Toggle word wrap

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 从 版本 下拉列表中选择适当的版本。
3. 点 OpenShift v4.14 Windows Client 条目旁的 Download Now 来保存文件。
4. 使用 ZIP 程序解压存档。

5. 将 oc 二进制文件移到 PATH 中的目录中。

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

   C:\> path

   Copy to Clipboard Toggle word wrap

流程

1. 导航到红帽客户门户网站上的 OpenShift Container Platform 下载页面。
2. 从 版本 下拉列表中选择适当的版本。

3. 点 OpenShift v4.14 macOS Client 条目旁的 Download Now 来保存文件。

   注意

   对于 macOS arm64，请选择 OpenShift v4.14 macOS arm64 Client 条目。

4. 解包和解压存档。

5. 将 oc 二进制文件移到 PATH 的目录中。

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

   $ echo $PATH

   Copy to Clipboard Toggle word wrap

流程

1. 进入包含安装程序的目录并初始化集群部署：

   $ ./openshift-install create cluster --dir <installation_directory> \ 

   1

   
       --log-level=info 

   2

   Copy to Clipboard Toggle word wrap

   1

   对于 <installation_directory>，请指定自定义 ./install-config.yaml 文件的位置。

   2

   要查看不同的安装详情，请指定 warn、debug 或 error，而不是 info。

2. 可选：从您用来安装集群的 IAM 帐户删除或禁用 AdministratorAccess 策略。

   注意

   只有在安装过程中才需要 AdministratorAccess 策略提供的升级权限。

流程

1. 导出 kubeadmin 凭证：

   $ export KUBECONFIG=<installation_directory>/auth/kubeconfig 

   1

   Copy to Clipboard Toggle word wrap

   1

   对于 <installation_directory>，请指定安装文件保存到的目录的路径。

2. 验证您可以使用导出的配置成功运行 oc 命令：

   $ oc whoami

   Copy to Clipboard Toggle word wrap

   输出示例

   system:admin

   Copy to Clipboard Toggle word wrap

流程

1. 从安装主机上的 kubeadmin -password 文件中获取 kubeadmin 用户的密码：

   $ cat <installation_directory>/auth/kubeadmin-password

   Copy to Clipboard Toggle word wrap
   注意

   另外，您还可以从安装主机上的 <installation_directory>/.openshift_install.log 日志文件获取 kubeadmin 密码。

2. 列出 OpenShift Container Platform Web 控制台路由：

   $ oc get routes -n openshift-console | grep 'console-openshift'

   Copy to Clipboard Toggle word wrap
   注意

   另外，您还可以从安装主机上的 <installation_directory>/.openshift_install.log 日志 文件获取 OpenShift Container Platform 路由。

   输出示例

   console     console-openshift-console.apps.<cluster_name>.<base_domain>            console     https   reencrypt/Redirect   None

   Copy to Clipboard Toggle word wrap

3. 在 Web 浏览器中导航到上一命令输出中包括的路由，以 kubeadmin 用户身份登录。