19.13. 创建自定义资源以安装单个受管集群

流程

1. 创建 NMStateConfig 自定义资源：

   apiVersion: agent-install.openshift.io/v1beta1
   kind: NMStateConfig
   metadata:
    name: <cluster_name>
    namespace: <cluster_name>
    labels:
      sno-cluster-<cluster-name>: <cluster_name>
   spec:
    config:
      interfaces:
        - name: eth0
          type: ethernet
          state: up
          ipv4:
            enabled: true
            address:
              - ip: <ip_address> 1
                prefix-length: <public_network_prefix> 2
            dhcp: false
      dns-resolver:
        config:
          server:
            - <dns_resolver> 3
      routes:
        config:
          - destination: 0.0.0.0/0
            next-hop-address: <gateway> 4
            next-hop-interface: eth0
            table-id: 254
    interfaces:
      - name: "eth0" 5
        macAddress: <mac_address> 6

   1

   目标裸机主机的静态 IP 地址。

   2

   目标裸机主机的静态 IP 地址子网前缀。

   3

   目标裸机主机的 DNS 服务器。

   4

   目标裸机主机的网关。

   5

   必须与 interfaces 部分中指定的名称匹配。

   6

   接口的 mac 地址。

2. 在创建 BareMetalHost 自定义资源时，请确保其 mac 地址与 NMStateConfig 目标裸机主机中的 mac 地址匹配。

3. 在创建 InfraEnv 自定义资源时，引用 InfraEnv 自定义资源中的 NMStateConfig 自定义资源中的标签：

   apiVersion: agent-install.openshift.io/v1beta1
   kind: InfraEnv
   metadata:
     name: <cluster_name>
     namespace: <cluster_name>
   spec:
     clusterRef:
       name: <cluster_name>
       namespace: <cluster_name>
     sshAuthorizedKey: <public_key>
     agentLabels: 1
       location: "<label-name>"
     pullSecretRef:
       name: assisted-deployment-pull-secret
     nmStateConfigLabelSelector:
       matchLabels:
         sno-cluster-<cluster-name>: <cluster_name> # Match this label

   1

   设置要匹配的标签。代理引导时应用标签。

1. 在目标机器上生成并启动发现镜像 ISO 文件。
2. 当 ISO 文件成功在目标机器上启动时，它会报告目标计算机的硬件信息。
3. 在所有主机被发现后，会安装 OpenShift Container Platform。
4. 当 OpenShift Container Platform 完成安装后，hub 在目标集群上安装 klusterlet 服务。
5. 请求的附加组件服务安装在目标集群中。

流程

1. 检查受管集群的状态：

   $ oc get managedcluster

   True 表示受管集群已就绪。

2. 检查代理状态：

   $ oc get agent -n <cluster_name>

3. 使用 describe 命令，提供代理条件的深入描述。支持的状态包括 BackendError、InputError、ValidationsFailing、InFailed 和 AgentIsConnected。这些状态与 Agent 和 AgentClusterInstall 自定义资源相关。

   $ oc describe agent -n <cluster_name>

4. 检查集群置备状态：

   $ oc get agentclusterinstall -n <cluster_name>

5. 使用 describe 命令提供集群置备状态的深入描述：

   $ oc describe agentclusterinstall -n <cluster_name>

6. 检查受管集群的附加服务的状态：

   $ oc get managedclusteraddon -n <cluster_name>

7. 检索受管集群的 kubeconfig 文件的身份验证信息：

   $ oc get secret -n <cluster_name> <cluster_name>-admin-kubeconfig -o jsonpath={.data.kubeconfig} | base64 -d > <directory>/<cluster_name>-kubeconfig

流程

1. 创建包含镜像 registry 配置的 ConfigMap：

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: assisted-installer-mirror-config
     namespace: assisted-installer
     labels:
       app: assisted-service
   data:
     ca-bundle.crt: <certificate> 1
     registries.conf: |  2
       unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
   
       [[registry]]
         location = <mirror_registry_url>  3
         insecure = false
         mirror-by-digest-only = true

   1

   创建镜像 registry 时使用的镜像 registry 证书。

   2

   镜像 registry 的配置。

   3

   镜像 registry 的 URL。

   这会更新 AgentServiceConfig 自定义资源中的 mirrorRegistryRef，如下所示：

   输出示例

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
     namespace: assisted-installer
   spec:
     databaseStorage:
       volumeName: <db_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <db_storage_size>
     filesystemStorage:
       volumeName: <fs_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <fs_storage_size>
     mirrorRegistryRef:
       name: 'assisted-installer-mirror-config'
     osImages:
       - openshiftVersion: <ocp_version>
         rootfs: <rootfs_url> 1
         url: <iso_url> 2

   1 2

   必须与 HTTPD 服务器的 URL 匹配。

2. 对于断开连接的安装，您必须部署可通过断开连接的网络访问的 NTP 时钟。您可以配置 chrony 作为服务器，编辑 /etc/chrony.conf 文件，并添加以下允许的 IPv6 范围：

   # Allow NTP client access from local network.
   #allow 192.168.0.0/16
   local stratum 10
   bindcmdaddress ::
   allow 2620:52:0:1310::/64

流程

1. 在 AgentClusterInstall 自定义资源中，修改 IPv6 地址的 clusterNetwork 和 serviceNetwork ：

   apiVersion: extensions.hive.openshift.io/v1beta1
   kind: AgentClusterInstall
   metadata:
     # Only include the annotation if using OVN, otherwise omit the annotation
     annotations:
       agent-install.openshift.io/install-config-overrides: '{"networking":{"networkType":"OVNKubernetes"}}'
     name: <cluster_name>
     namespace: <cluster_name>
   spec:
     clusterDeploymentRef:
       name: <cluster_name>
     imageSetRef:
       name: <cluster_image_set>
     networking:
       clusterNetwork:
       - cidr: "fd01::/48"
         hostPrefix: 64
       machineNetwork:
       - cidr: <machine_network_cidr>
       serviceNetwork:
       - "fd02::/112"
     provisionRequirements:
       controlPlaneAgents: 1
       workerAgents: 0
     sshPublicKey: <public_key>

2. 使用您定义的 IPv6 地址更新 NMStateConfig 自定义资源。

流程

1. 检查受管集群的状态：

   $ oc get managedcluster

   输出示例

   NAME            HUB ACCEPTED   MANAGED CLUSTER URLS   JOINED   AVAILABLE   AGE
   SNO-cluster     true                                   True     True      2d19h

   如果 AVAILABLE 列中的状态为 True，受管集群由 hub 管理。

   如果 AVAILABLE 列中的状态为 Unknown，则受管集群不会由 hub 管理。使用以下步骤继续检查 以了解更多信息。

2. 检查 AgentClusterInstall 安装状态：

   $ oc get clusterdeployment -n <cluster_name>

   输出示例

   NAME        PLATFORM            REGION   CLUSTERTYPE   INSTALLED    INFRAID    VERSION  POWERSTATE AGE
   Sno0026    agent-baremetal                               false                          Initialized
   2d14h

   如果 INSTALLED 列中的状态为 false，则安装会失败。

3. 如果安装失败，请输入以下命令查看 AgentClusterInstall 资源的状态：

   $ oc describe agentclusterinstall -n <cluster_name> <cluster_name>

4. 解决错误并重置集群：

   1. 删除集群的受管集群资源：

      $ oc delete managedcluster <cluster_name>

   2. 删除集群的命名空间：

      $ oc delete namespace <cluster_name>

      这会删除为此集群创建的所有命名空间范围自定义资源。您必须等待 ManagedCluster CR 删除完成，然后才能继续。

   3. 为受管集群重新创建自定义资源。