1.2. 在 RHV 上快速安装集群

流程

1. 检查 RHV 版本。

   1. 在 RHV 管理门户中，点右上角的 ? 帮助图表，选 About。
   2. 在打开的窗口中，确认 RHV Software Version 为 4.3.9 或更新版本。

2. 检查数据中心、集群和存储。

   1. 在 RHV 管理门户中，点 Compute Data Centers。
   2. 确认您要安装 OpenShift Container Platform 的数据中心显示绿色上箭头，代表已上线。
   3. 点击该数据中心的名称。
   4. 在数据中心详情中，存储 标签中确认您要安装 OpenShift Container Platform 的存储域是 Active。
   5. 记录下域名以供以后使用。
   6. 确认 Free Space 至少为 230 GiB。
   7. 确认存储域满足了 这些 etcd 后端性能要求，可 使用 FIO 性能基准工具来测量。
   8. 在数据中心详情中点击 Clusters 选项卡。
   9. 找到您要安装 OpenShift Container Platform 的 RHV 集群。记录集群名称，以供稍后使用。

3. 检查 RHV 主机资源。

   1. 在 RHV 管理门户中，点 Compute > Clusters。
   2. 点击要安装 OpenShift Container Platform 的集群。
   3. 在集群详情中点击 Hosts 标签页。
   4. 检查主机，确认这些主机有至少 28 个 逻辑 CPU 内核，专门 用于 OpenShift Container Platform 集群。
   5. 记录逻辑 CPU 内核数以供稍后使用。
   6. 请确认这些 CPU 内核被正确分配，在安装过程中创建的七台虚拟机中的每一台都可以有四个内核。

   7. 确认主机总共有 112 GiB 的 Max free Memory for scheduling new VMs 值，以满足以下每个 OpenShift Container Platform 机器的要求：

      • bootstrap 机器需要 16 GiB
      • 三个 control plane 机器每个机器都需要 16 GiB
      • 三个计算机器每个机器都需要 16 GiB
   8. 记录下 Max free Memory for scheduling new VMs 的值以便稍后使用。

4. 验证安装 OpenShift Container Platform 的虚拟网络能否访问 RHV Manager 的 REST API。在这个网络上的虚拟机上，使用带 RHV Manager REST API 的 curl 命令。使用以下命令：

   curl -k -u <username>@<profile>:<password> \ 1
   https://<engine-fqdn>/ovirt-engine/api 2

   1

   对于 <username>，请指定 RHV 管理员的用户名。对于 <profile>，请指定登录配置集，您可以登陆到 RHV 管理门户查看 Profile 下拉列表。对于 <password>，请指定管理员密码。

   2

   对于 <engine-fqdn>，请指定 RHV 环境的完全限定域名。

   例如：

   $ curl -k -u rhvadmin@internal:pw123 \
   https://rhv-env.virtlab.example.com/ovirt-engine/api

流程

1. 保留三个静态 IP 地址

   1. 在您要安装 OpenShift Container Platform 的网络上，标识 DHCP 租期池之外的三个静态 IP 地址。

   2. 连接到此网络中的主机，并确认每个 IP 地址都没有被使用。例如，使用地址解析协议（ARP）检查 IP 地址是否有条目：

      $ arp 10.35.1.19
      10.35.1.19 (10.35.1.19) -- no entry

   3. 为您的网络环境保留三个静态 IP 地址。
   4. 记录这些 IP 地址以备将来参考。

2. 为 OpenShift Container Platform REST API 创建 DNS 条目，并使用以下格式应用域名：

   api.<cluster-name>.<base-domain>   <ip-address> 1
   *.apps.<cluster-name>.<base-domain>   <ip-address> 2

   1

   对于 <cluster-name>、<base-domain>和 <ip-address>，请指定 OpenShift Container Platform API 的集群名称、基域和静态 IP 地址。

   2

   指定 Ingress 和负载均衡器的 OpenShift Container Platform 应用程序的集群名称、基域和静态 IP 地址。

   例如：

   api.my-cluster.virtlab.example.com	10.35.1.19
   *.apps.my-cluster.virtlab.example.com	10.35.1.20

   注意

   第三个静态 IP 地址不需要 DNS 条目。OpenShift Container Platform 集群将该地址用于其内部 DNS 服务。

流程

1. 使用这两个方法之一下载 CA 证书：

   • 进入 Manager 网页 https://<engine-fqdn>/ovirt-engine/。然后在 下载 中点击 CA 证书 链接。

   • 运行以下命令：

     $ curl -k 'https://<engine-fqdn>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA' -o /tmp/ca.pem  1

     1

     对于 <engine-fqdn>，请指定 RHV Manager 的全限定域名，如 rhv-env.virtlab.example.com。

2. 配置 CA 文件，为 Manager 授予无根用户访问权限。将 CA 文件权限设置为 0644 （symbolic 值： -rw-r—​r--）:

   $ sudo chmod 0644 /tmp/ca.pem

3. 对于 Linux，将 CA 证书复制到服务器证书目录中。使用 -p 保留权限：

   $ sudo cp -p /tmp/ca.pem /etc/pki/ca-trust/source/anchors/ca.pem

4. 将证书添加到您操作系统的证书管理器：

   • 对于 macOS，请双击这个证书文件，并使用 Keychain Access 程序将该文件添加到 System 密钥链中。

   • 对于 Linux，更新 CA 信任：

     $ sudo update-ca-trust

     注意

     如果使用您自己的证书认证机构，请确定系统信任它。

流程

1. 如果还没有为计算机上免密码身份验证而配置的 SSH 密钥，请创建一个。例如，在使用 Linux 操作系统的计算机上运行以下命令：

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

   1

   指定 SSH 密钥的路径和文件名，如 ~/.ssh/id_rsa。不要指定已存在的 SSH 密钥，因为它会被覆盖。

   运行此命令会在指定的位置生成不需要密码的 SSH 密钥。

2. 作为后台任务启动 ssh-agent 进程：

   $ eval "$(ssh-agent -s)"
   
   Agent pid 31874

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

   $ ssh-add <path>/<file_name> 1
   
   Identity added: /home/<you>/<path>/<file_name> (<computer_name>)

   1

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

流程

1. 访问 Red Hat OpenShift Cluster Manager 网站的 Infrastructure Provider 页面。如果您有红帽帐号，请使用自己的凭证登录。如果没有，请创建一个帐户。

2. 进入适用于您的安装类型的页面，下载您的操作系统的安装程序，并将文件放在要保存安装配置文件的目录中。。

   重要

   安装程序会在用来安装集群的计算机上创建若干文件。在完成集群安装后，您必须保留安装程序和安装程序所创建的文件。

   重要

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

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

   $ tar xvf <installation_program>.tar.gz

4. 在 Red Hat OpenShift Cluster Manager 站点的 Pull Secret 页面中，下载您的安装 pull secret 的 .txt 文件。通过此 pull secret，您可以进行所含授权机构提供的服务的身份验证，这些服务包括为 OpenShift Container Platform 组件提供容器镜像的 Quay.io。

流程

1. 运行安装程序：

   $ sudo ./openshift-install create cluster --dir=<installation_directory> \ 1
       --log-level=info 2

   1

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

   2

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

   重要

   指定一个空目录。一些安装信息，如 bootstrap X.509 证书，有较短的过期间隔，因此不要重复使用安装目录。如果要重复使用另一个集群安装中的个别文件，可以将其复制到您的目录中。但是，一些安装数据的文件名可能会在发行版本之间有所改变。从 OpenShift Container Platform 老版本中复制安装文件时要格外小心。

   根据安装程序提示输入相关的值。

   1. 可选： SSH Public Key，请选择无密码公钥，如 ~/.ssh/id_rsa.pub。这个密钥被用来验证与新的 OpenShift Container Platform 集群的连接。

      注意

      如果您要在生产环境中执行安装调试或灾难恢复，请指定 ssh-agent 进程需要使用的 SSH 密钥。

   2. 对于 Platform，选择 ovirt。

   3. 对于 Enter oVirt’s API endpoint URL，使用以下格式输入 RHV API 的 URL：

      https://<engine-fqdn>/ovirt-engine/api 1

      1

      对于 <engine-fqdn>，请指定 RHV 环境的完全限定域名。

      例如：

      https://rhv-env.virtlab.example.com/ovirt-engine/api

   4. 对于 Is the installed oVirt certificate trusted?，输入 Yes，因为您已设置了一个 CA 证书。否则，请输入 No。
   5. 对于 oVirt 的 CA bundle，如果您为前一个问题输入的是 Yes，请从 /etc/pki/ca-trust/source/anchors/ca.pem 中复制证书内容并粘贴到这里。然后按两次 Enter 键。如果您就前一个问题输入 No，则不会出现这个问题。

   6. 对于 Enter the oVirt engine username，请使用以下格式输入 RHV 管理员的用户名和密码：

      <username>@<profile> 1

      1

      对于 <username>，请指定 RHV 管理员的用户名。对于 <profile>，请指定登录配置集，您可以登陆到 RHV 管理门户查看 Profile 下拉列表。用户名和配置集应与以下示例相似：

      admin@internal

   7. 对于 Enter password，请输入 RHV 管理密码。
   8. 对于Select the oVirt cluster，请选择用于安装 OpenShift Container Platform 的集群。
   9. 对于 Select the oVirt storage domain，请选择安装 OpenShift Container Platform 的存储域。
   10. 对于Select the oVirt network，请选择可访问 RHV Manager REST API 的虚拟网络。
   11. 对于 Enter the internal API Virtual IP，请为集群的 REST API 输入您设置的静态 IP 地址。
   12. 对于 Enter the internal DNS Virtual IP，请为集群的内部 DNS 服务输入您设置的静态 IP 地址。
   13. 对于 Enter the ingress IP，请为通配符应用程序域输入您保留的静态 IP 地址。
   14. 对于 Base domain，请输入 OpenShift Container Platform 集群的基域。如果这个群集暴露于外部世界，这必须是 DNS 基础结构可识别的有效域。例如： 输入 virtlab.example.com
   15. 对于 Cluster name，请输入集群名称。例如： my-cluster。使用您为 OpenShift Container Platform REST API 创建的外部注册/可解析 DNS 条目的集群名称，以及应用域名。安装程序也将此名称提供给 RHV 环境中的集群。
   16. 对于 Pull secret，请从之前下载并粘贴的 pull-secret.txt 文件中复制 pull secret。您也可以从 Red Hat OpenShift Cluster Manager 站点的Pull Secret 页面中下载这个 pull secret。
   注意

   如果您在主机上配置的云供应商帐户没有足够的权限来部署集群，安装过程将会停止，并且显示缺少的权限。

   集群部署完成后，终端会显示访问集群的信息，包括指向其 Web 控制台的链接和 kubeadmin 用户的凭证。

   重要

   安装程序生成的 Ignition 配置文件包含在 24 小时后过期的证书，然后在过期时进行续订。如果在更新证书前关闭集群，且集群在 24 小时后重启，集群会自动恢复过期的证书。一个例外情况是，您需要手动批准待处理的 node-bootstrapper 证书签名请求（CSR）来恢复 kubelet 证书。如需更多信息，请参阅从过期的 control plane 证书中恢复的文档。

   重要

   您不得删除安装程序或安装程序所创建的文件。需要这两者才能删除集群。