22.3. 使用 RHACM 和 SiteConfig 资源安装受管集群

• 在空白服务器上安装主机操作系统 (RHCOS)
• 部署 OpenShift Container Platform
• 创建集群策略和站点订阅
• 为服务器操作系统进行必要的网络配置
• 部署配置集 Operator 并执行任何所需的软件相关配置，如性能配置集、PTP 和 SR-IOV

先决条件

• 已安装 OpenShift CLI(oc)。
• 已以具有 cluster-admin 权限的用户身份登录到 hub 集群。
• 配置了 hub 集群来生成所需的安装和策略 CR。

• 您创建了 Git 存储库，用于管理自定义站点配置数据。存储库必须可从 hub 集群访问，且必须将其配置为 ArgoCD 应用程序的源存储库。如需更多信息，请参阅"准备 GitOps ZTP 站点配置存储库"。

  注意

  在创建源存储库时，请确保使用从 ztp-site-generate 容器中提取的 argocd/deployment/argocd-openshift-gitops-patch.json patch-file 来修补 ArgoCD 应用程序。请参阅"使用 ArgoCD 配置 hub 集群"。

• 要准备好置备受管集群，每个裸机主机都需要以下内容：

  网络连接

  您的网络需要 DNS。受管集群主机应该可从 hub 集群访问。确保 hub 集群和受管集群主机之间存在第 3 层连接。

  Baseboard Management Controller (BMC) 详情

  ZTP 使用 BMC 用户名和密码详情来在集群安装过程中连接到 BMC。GitOps ZTP 插件根据站点 Git 仓库中的 SiteConfig CR 管理 hub 集群上的 ManagedCluster CR。您可以手动为每个主机创建单独的 BMCSecret CR。

  流程

  1. 在 hub 集群中创建所需的受管集群 secret。这些资源必须位于名称与集群名称匹配的命名空间中。例如，在 out/argocd/example/siteconfig/example-sno.yaml 中，集群名称和命名空间是 example-sno。

     1. 运行以下命令来导出集群命名空间：

        $ export CLUSTERNS=example-sno

     2. 创建命名空间：

        $ oc create namespace $CLUSTERNS

  2. 为受管集群创建 pull secret 和 BMC Secret CR。pull secret 必须包含安装 OpenShift Container Platform 和其他需要安装的 Operator 所需的所有凭证。如需更多信息，请参阅"创建受管裸机主机 secret"。

     注意

     secret 根据名称从 SiteConfig 自定义资源 (CR) 引用。命名空间必须与 SiteConfig 命名空间匹配。

  3. 在 Git 存储库本地克隆中为集群创建一个 SiteConfig CR：

     1. 从 out/argocd/example/siteconfig/ 文件夹中选择适合您的 CR 示例。文件夹中包含单一节点、三节点和标准集群的示例文件：

        • example-sno.yaml
        • example-3node.yaml
        • example-standard.yaml

     2. 更改示例文件中的集群和主机详情，以匹配您想要的集群类型。例如：

        单节点 OpenShift 集群 SiteConfig CR 示例

        apiVersion: ran.openshift.io/v1
        kind: SiteConfig
        metadata:
          name: "<site_name>"
          namespace: "<site_name>"
        spec:
          baseDomain: "example.com"
          pullSecretRef:
            name: "assisted-deployment-pull-secret" 1
          clusterImageSetNameRef: "openshift-4.11" 2
          sshPublicKey: "ssh-rsa AAAA..." 3
          clusters:
          - clusterName: "<site_name>"
            networkType: "OVNKubernetes"
            clusterLabels: 4
              common: true
              group-du-sno: ""
              sites : "<site_name>"
            clusterNetwork:
              - cidr: 1001:1::/48
                hostPrefix: 64
            machineNetwork:
              - cidr: 1111:2222:3333:4444::/64
            serviceNetwork:
              - 1001:2::/112
            additionalNTPSources:
              - 1111:2222:3333:4444::2
            #crTemplates:
            #  KlusterletAddonConfig: "KlusterletAddonConfigOverride.yaml" 5
            nodes:
              - hostName: "example-node.example.com" 6
                role: "master"
                bmcAddress: idrac-virtualmedia://<out_of_band_ip>/<system_id>/ 7
                bmcCredentialsName:
                  name: "bmh-secret" 8
                bootMACAddress: "AA:BB:CC:DD:EE:11"
                bootMode: "UEFI" 9
                rootDeviceHints:
                  wwn: "0x11111000000asd123"
                cpuset: "0-1,52-53"  10
                nodeNetwork: 11
                  interfaces:
                    - name: eno1
                      macAddress: "AA:BB:CC:DD:EE:11"
                  config:
                    interfaces:
                      - name: eno1
                        type: ethernet
                        state: up
                        ipv4:
                          enabled: false
                        ipv6: 12
                          enabled: true
                          address:
                          - ip: 1111:2222:3333:4444::aaaa:1
                            prefix-length: 64
                    dns-resolver:
                      config:
                        search:
                        - example.com
                        server:
                        - 1111:2222:3333:4444::2
                    routes:
                      config:
                      - destination: ::/0
                        next-hop-interface: eno1
                        next-hop-address: 1111:2222:3333:4444::1
                        table-id: 254

        1

        使用与 SiteConfig CR 相同的命名空间创建 assisted-deployment-pull-secret CR。

        2

        clusterImageSetNameRef 定义 hub 集群中可用的镜像集。要查看 hub 集群上支持的版本列表，请运行 oc get clusterimagesets。

        3

        配置用于访问集群的 SSH 公钥。

        4

        集群标签必须与您定义的 PolicyGenTemplate CR 中的 bindingRules 字段对应。例如，policygentemplates/common-ranGen.yaml 应用到所有带有 common: true 设置的集群，policygentemplates/group-du-sno-ranGen.yaml 应用到所有带有 group-du-sno: "" 设置的所有集群。

        5

        可选。KlusterletAddonConfig 下的 CR specifed 用于覆盖为集群创建的默认 KlusterletAddonConfig。

        6

        对于单节点部署，请定义一个主机。对于三节点部署，请定义三个主机。对于标准部署，使用 role: master 定义三个主机，使用 role: worker 定义两个或更多主机。

        7

        用于访问主机的 BMC 地址。适用于所有集群类型。

        8

        使用主机 BMC 凭证单独创建的 bmh-secret CR 的名称。在创建 bmh-secret CR 时，请使用与置备主机的 SiteConfig CR 相同的命名空间。

        9

        配置主机的引导模式。默认值为 UEFI。使用 UEFISecureBoot 在主机上启用安全引导。

        10

        cpuset 应该与用于工作负载分区的集群 PerformanceProfile CR .spec.cpu.reserved 字段中设置的值匹配。

        11

        指定节点的网络设置。

        12

        配置主机的 IPv6 地址。对于带有静态 IP 地址的单节点 OpenShift 集群，特定于节点的 API 和 Ingress IP 应该相同。

        注意

        有关 BMC 寻址的更多信息，请参阅"添加资源"部分。

     3. 您可以在 out/argocd/extra-manifest 中检查默认的 extra-manifest MachineConfig CR。它在安装时会自动应用到集群。
     4. 可选： 要在置备的集群中置备额外的安装清单，请在 Git 存储库中创建一个目录，如 sno-extra-manifest/，并将自定义清单 CR 添加到这个目录中。如果您的 SiteConfig.yaml 在 extraManifestPath 字段中引用这个目录，则这个引用目录中的所有 CR 都会被附加到默认的额外的清单集合中。
  4. 在 kustomization.yaml 文件中将 SiteConfig CR 添加到 generators 部分中 ，类似于 out/argocd/example/siteconfig/kustomization.yaml 中显示的示例。

  5. 在 Git 存储库中提交 SiteConfig CR 及关联的 kustomization.yaml 更改并推送更改。

     ArgoCD 管道检测到更改并开始受管集群部署。

先决条件

• 已安装 OpenShift CLI(oc)。
• 已以具有 cluster-admin 权限的用户身份登录到 hub 集群。

先决条件

• 已安装 OpenShift CLI(oc)。
• 已以具有 cluster-admin 权限的用户身份登录到 hub 集群。

先决条件

• 已安装 OpenShift CLI(oc)。
• 已以具有 cluster-admin 权限的用户身份登录到 hub 集群。

先决条件

• 已安装 OpenShift CLI(oc)。
• 已以具有 cluster-admin 权限的用户身份登录到 hub 集群。

先决条件

• 已安装 OpenShift CLI(oc)。
• 已以具有 cluster-admin 权限的用户身份登录到 hub 集群。

先决条件

• 已安装 OpenShift CLI(oc)。
• 已以具有 cluster-admin 权限的用户身份登录到 hub 集群。