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 アドレスの 1 つが 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. Discovery イメージの ISO ファイルが生成され、ターゲットマシンで起動します。
2. ターゲットマシンで ISO ファイルが正常に起動すると、ターゲットマシンのハードウェア情報を報告します。
3. すべてのホストの検出後に、OpenShift Container Platform がインストールされます。
4. OpenShift Container Platform のインストールが完了すると、ハブは klusterlet サービスをターゲットクラスターにインストールします。
5. 要求されたアドオンサービスがターゲットクラスターにインストールされている。

手順

1. マネージドクラスターのステータスを確認します。

   $ oc get managedcluster

   True はマネージドクラスターの準備が整っていることを示します。

2. エージェントのステータスを確認します。

   $ oc get agent -n <cluster_name>

3. describe コマンドを使用して、エージェントの条件に関する詳細な説明を指定します。認識できるステータスには、BackendError、InputError、ValidationsFailing、InstallationFailed、および 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. ミラーレジストリー設定を含む 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

   ミラーレジストリーの作成時に使用されるミラーレジストリーの証明書。

   2

   ミラーレジストリーの設定。

   3

   ミラーレジストリーの 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 の IP アドレスを変更します。

   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 の場合、マネージドクラスターはハブによって管理されます。

   AVAILABLE 列のステータスが Unknown の場合、マネージドクラスターはハブによって管理されていません。その他の情報を取得するには、以下の手順を使用します。

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. クラスターの namespace を削除します。

      $ oc delete namespace <cluster_name>

      これにより、このクラスター用に作成された namespace スコープのカスタムリソースがすべて削除されます。続行する前に、ManagedCluster CR の削除が完了するのを待つ必要があります。

   3. マネージドクラスターのカスタムリソースを再作成します。