12.6. 创建安装配置文件

流程

1. 可选：如果您之前在这个计算机上运行安装程序，并希望使用替代的服务主体或受管身份，请进入 ~/.azure/ 目录并删除 osServicePrincipal.json 配置文件。

   删除此文件可防止安装程序自动重复使用之前安装中的订阅和验证值。

2. 创建 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. 选择 azure 作为目标平台。

         如果安装程序无法找到之前安装中的 osServicePrincipal.json 配置文件，会提示您输入 Azure 订阅和验证值。

      3. 为您的订阅输入以下 Azure 参数值：

         • Azure subscription id ：输入用于集群的订阅 ID。
         • Azure 租户 id ：输入租户 ID。

      4. 根据您用来部署集群的 Azure 身份，在提示输入 azure 服务主体客户端 id 时执行以下操作之一：

         • 如果您使用服务主体，请输入其应用程序 ID。
         • 如果您使用系统分配的受管身份，请将此值设为空白。
         • 如果您使用用户分配的受管身份，请指定其客户端 ID。

      5. 根据您用来部署集群的 Azure 身份，在提示输入 azure 服务主体客户端 secret 时执行以下操作之一：

         • 如果您使用服务主体，请输入其密码。
         • 如果您使用系统分配的受管身份，请将此值设为空白。
         • 如果您使用用户分配的受管身份，请将此值设为空白。
      6. 选择要将集群部署到的区域。
      7. 选择集群要部署到的基域。基域与您为集群创建的 Azure DNS 区对应。

      8. 为集群输入一个描述性名称。

         重要

         所有通过公共端点提供的 Azure 资源均存在资源名称的限制，您无法创建使用某些名称的资源。如需 Azure 限制词语列表，请参阅 Azure 文档中的解决保留资源名称错误。

      9. 粘贴 Red Hat OpenShift Cluster Manager 中的 pull secret。

3. 编辑 install-config.yaml 文件，以提供在受限网络中安装所需的额外信息。

   1. 更新 pullSecret 值，使其包含 registry 的身份验证信息：

      pullSecret: '{"auths":{"<mirror_host_name>:5000": {"auth": "<credentials>","email": "you@example.com"}}}'

      Copy to Clipboard Toggle word wrap

      对于 <mirror_host_name>，请指定 您在镜像 registry 证书中指定的 registry 域名 ；对于 <credentials>， 请指定您的镜像 registry 的 base64 编码用户名和密码。

   2. 添加 additionalTrustBundle 参数和值。

      additionalTrustBundle: |
        -----BEGIN CERTIFICATE-----
        ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
        -----END CERTIFICATE-----

      Copy to Clipboard Toggle word wrap

      该值必须是您用于镜像 registry 的证书文件内容。证书文件可以是现有的可信证书颁发机构，也可以是您为镜像 registry 生成的自签名证书。

   3. 在 platform.azure 字段中定义 VNet 的网络和子网，以安装集群：

      networkResourceGroupName: <vnet_resource_group> 

      1

      
      virtualNetwork: <vnet> 

      2

      
      controlPlaneSubnet: <control_plane_subnet> 

      3

      
      computeSubnet: <compute_subnet> 

      4

      Copy to Clipboard Toggle word wrap

      1

      将 <vnet_resource_group> 替换为包含现有虚拟网络 (VNet)的资源组名称。

      2

      将 <vnet> 替换为现有的虚拟网络名称。

      3

      将 <control_plane_subnet> 替换为部署 control plane 机器的现有子网名称。

      4

      将 <compute_subnet> 替换为部署计算机器的现有子网名称。

   4. 添加镜像内容资源，类似于以下 YAML 摘录：

      imageContentSources:
      - mirrors:
        - <mirror_host_name>:5000/<repo_name>/release
        source: quay.io/openshift-release-dev/ocp-release
      - mirrors:
        - <mirror_host_name>:5000/<repo_name>/release
        source: registry.redhat.io/ocp/release

      Copy to Clipboard Toggle word wrap

      对于这些值，请使用您在创建镜像 registry 时记录的 imageContentSources。

   5. 可选：将发布策略设置为 Internal：

      publish: Internal

      Copy to Clipboard Toggle word wrap

      通过设置这个选项，您可以创建一个内部 Ingress Controller 和一个私有负载均衡器。

      重要

      Azure Firewall 无法与 Azure 公共负载均衡器无缝工作。因此，当使用 Azure Firewall 来限制互联网访问时，install-config.yaml 中的 publish 字段应设置为 Internal。

4. 对您需要的 install-config.yaml 文件进行任何其他修改。您可以在 安装配置参数部分找到有关可用参数 的更多信息。

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

   重要

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