17.4. シングルノード OpenShift クラスターのデプロイ

手順

1. 次のコマンドを実行して、ibi-ns namespace を作成します。

   $ oc create namespace ibi-ns

2. イメージレジストリーの Secret リソースを作成します。

   1. イメージレジストリーの Secret リソースを定義する YAML ファイルを作成します。

      secret-image-registry.yaml ファイルの例:

      apiVersion: v1
      kind: Secret
      metadata:
        name: ibi-image-pull-secret
        namespace: ibi-ns
      stringData:
        .dockerconfigjson: <base64_docker_auth_code>
      type: kubernetes.io/dockerconfigjson

      各項目の説明:

      <base64_docker_auth_code>

      base64 でエンコードされた認証情報の詳細を指定します。イメージプルシークレットの使用に関する詳細は、「関連情報」セクションを参照してください。

   2. 次のコマンドを実行して、イメージレジストリーの Secret リソースを作成します。

      $ oc create -f secret-image-registry.yaml

3. オプション: ホストの静的ネットワークを設定します。

   1. nmstate 形式の静的ネットワーク設定を含む Secret リソースを作成します。

      host-network-config-secret.yaml ファイルの例:

      apiVersion: v1
      kind: Secret
      metadata:
       name: <network_secret_name>
       namespace: ibi-ns
      type: Opaque
      stringData:
       nmstate: |
        interfaces:
          - name: <interface_name>
            type: ethernet
            state: up
            ipv4:
              enabled: true
              address:
                - ip: 192.168.200.25
                  prefix-length: 24
              dhcp: false
            ipv6:
              enabled: false
        dns-resolver:
          config:
            server:
              - <dns_server_1>
              - 192.168.15.48
        routes:
          config:
            - destination: 0.0.0.0/0
              metric: 150
              next-hop-address: 192.168.200.254
              next-hop-interface: <interface_name>
              table-id: 254

      各項目の説明:

      <network_secret_name>

      Secret リソースの名前 (例: host-network-config-secret) を指定します。

      nmstate

      静的ネットワーク設定を nmstate 形式で指定します。

      <interface_name>

      ホスト上のインターフェイス名 (例: ens1f0) を指定します。インターフェイスの名前は、オペレーティングシステムに表示される実際の NIC 名と同じである必要があります。NIC マッチングに MAC アドレスを使用するには、identifier フィールドを mac-address に設定します。

      dhcp: false

      DHCP を無効に指定することで、nmstate はインターフェイスに静的 IP アドレスを割り当てます。

      <dns_server_1>

      システムがドメイン名を解決するために使用する 1 つ以上の DNS サーバーを指定します (例: 192.168.15.47)。

      config

      ens1f0 インターフェイスを経由してネクストホップ IP アドレス 192.168.200.254 へのデフォルトルートを指定します。

4. BareMetalHost および Secret リソースを作成します。

   1. BareMetalHost および Secret リソースを定義する YAML ファイルを作成します。

      ibi-bmh.yaml ファイルの例:

      apiVersion: metal3.io/v1alpha1
      kind: BareMetalHost
      metadata:
        name: <baremetalhost_name>
        namespace: ibi-ns
      spec:
        online: <online_status>
        bootMACAddress: <boot_mac_address>
        bmc:
          address: <bmc_address>
          credentialsName: <bmh_secret_name>
        preprovisioningNetworkDataName: <network_secret_name>
        automatedCleaningMode: disabled
        externallyProvisioned: true
      ---
      apiVersion: v1
      kind: Secret
      metadata:
        name: <bmh_secret_name>
        namespace: ibi-ns
      type: Opaque
      data:
        username: <username>
        password: <password>

      各項目の説明:

      <baremetalhost_name>

      BareMetalHost リソースの名前 (例: ibi-bmh) を指定します。

      <online_status>

      ホストをオンラインにするかどうかを指定します (例: false)。

      <boot_mac_address>

      ホストブート MAC アドレス (例: 00:a5:12:55:62:64) を指定します。

      <bmc_address>

      BMC アドレス (例: redfish-virtualmedia+http://192.168.111.1:8000/redfish/v1/Systems/8a5babac-94d0-4c20-b282-50dc3a0a32b5) を指定します。仮想メディアネットワークの起動をサポートするベアメタルホストドライバー (redfish-virtualmedia や idrac-virtualmedia など) のみを使用できます。

      <bmh_secret_name>

      ベアメタルホストの Secret リソースの名前 (例: ibi-bmh-bmc-secret) を指定します。

      <network_secret_name>

      (オプション) ホストの静的ネットワーク設定が含まれる Secret リソースの名前 (例: host-network-config-secret) を指定します。

      automatedCleaningMode: disabled

      プロビジョニングサービスがディスク検査中にシードイメージなどのプリインストールアーティファクトをすべて削除しないように、自動クリーニングを無効に指定します。

      externallyProvisioned: true

      ホストが外部プロビジョニングされ、設定 ISO ではなく、プリインストールされたディスクから起動できることを指定します。

      <username>

      BMC 認証に使用するユーザー名を指定します。

      <password>

      BMC 認証に使用するパスワードを指定します。

   2. 次のコマンドを実行して、BareMetalHost および Secret リソースを作成します。

      $ oc create -f ibi-bmh.yaml

5. ClusterImageSet リソースを作成します。

   1. ClusterImageSet リソースを定義する YAML ファイルを作成します。

      ibi-cluster-image-set.yaml ファイルの例:

      apiVersion: hive.openshift.io/v1
      kind: ClusterImageSet
      metadata:
        name: <clusterimageset_name>
      spec:
        releaseImage: <release_image>

      各項目の説明:

      <clusterimageset_name>

      ClusterImageSet リソースの名前 (例: ibi-img-version-arch) を指定します。

      <release_image>

      デプロイメントに使用するリリースイメージのアドレス (例: ibi.example.com:path/to/release/images:version-arch) を指定します。シードイメージの生成時に使用したイメージレジストリーとは異なるイメージレジストリーを使用する場合は、そのリリースイメージの OpenShift Container Platform バージョンが同じであることを確認してください。

   2. 次のコマンドを実行して ClusterImageSet リソースを作成します。

      $ oc apply -f ibi-cluster-image-set.yaml

6. ImageClusterInstall リソースを作成します。

   1. ImageClusterInstall リソースを定義する YAML ファイルを作成します。

      ibi-image-cluster-install.yaml ファイルの例:

      apiVersion: extensions.hive.openshift.io/v1alpha1
      kind: ImageClusterInstall
      metadata:
        name: <imageclusterinstall_name>
        namespace: ibi-ns
      spec:
        bareMetalHostRef:
          name: <baremetalhost_name>
          namespace: ibi-ns
        clusterDeploymentRef:
          name: <clusterdeployment_name>
        hostname: <cluster_hostname>
        imageSetRef:
          name: <clusterimageset_name>
        machineNetworks:
        - cidr: 10.0.0.0/24
        #- cidr: fd01::/64
        proxy:
          httpProxy: "http://proxy.example.com:8080"
          #httpsProxy: "http://proxy.example.com:8080"
          #noProxy: "no_proxy.example.com"

      各項目の説明:

      <imageclusterinstall_name>

      ImageClusterInstall リソースの名前 (例: ibi-image-install) を指定します。

      <baremetalhost_name>

      イメージベースのインストールで対象となる BareMetalHost リソース (例: ibi-bmh) を指定します。

      <clusterdeployment_name>

      ターゲットホストのイメージベースのインストールに使用する ClusterDeployment リソースの名前 (例: ibi-cluster-deployment) を指定します。

      <cluster_hostname>

      クラスターのホスト名 (例: ibi-host) を指定します。

      <clusterimageset_name>

      デプロイメントに使用するコンテナーリリースイメージを定義するために使用した ClusterImageSet リソースの名前 (例: ibi-img-version-arch) を指定します。

      machineNetworks

      外部ネットワークの公開 Classless Inter-Domain Routing (CIDR) を指定します。デュアルスタックネットワークの場合、リスト形式を使用して IPv4 と IPv6 の両方の CIDR を指定できます。リストの最初の CIDR はプライマリーアドレスファミリーであり、シードクラスターのプライマリーアドレスファミリーと一致する必要があります。

      proxy

      (オプション) クラスターのデプロイメントに使用するプロキシーを指定します。

      重要

      クラスターをデプロイするのにプロキシー設定が必要な場合は、次の手順を実行する必要があります。

      • プロキシー設定を備えたシードクラスターからシードイメージを作成します。2 つのプロキシー設定が同じである必要はありません。
      • インストールマニフェストの machineNetwork フィールドを設定します。

   2. 次のコマンドを実行して、ImageClusterInstall リソースを作成します。

      $ oc create -f ibi-image-cluster-install.yaml

7. ClusterDeployment リソースを作成します。

   1. ClusterDeployment リソースを定義する YAML ファイルを作成します。

      ibi-cluster-deployment.yaml ファイルの例:

      apiVersion: hive.openshift.io/v1
      kind: ClusterDeployment
      metadata:
        name: <clusterdeployment_name>
        namespace: <namespace>
      spec:
        baseDomain: <base_domain>
        clusterInstallRef:
          group: extensions.hive.openshift.io
          kind: ImageClusterInstall
          name: <imageclusterinstall_name>
          version: v1alpha1
        clusterName: <cluster_name>
        platform:
          none: {}
        pullSecretRef:
          name: <pull_secret_name>

      各項目の説明:

      <clusterdeployment_name>

      ClusterDeployment リソースの名前 (例: ibi-cluster-deployment) を指定します。

      <namespace>

      ClusterDeployment リソースの namespace (例: ibi-ns) を指定します。

      <base_domain>

      クラスターが属するベースドメイン (例: example.com) を指定します。

      <imageclusterinstall_name>

      ターゲットホストのイメージベースのインストールに使用するコンテナーイメージを定義した ImageClusterInstall の名前 (例: ibi-image-install) を指定します。

      <cluster_name>

      クラスターの名前 (例: ibi-cluster) を指定します。

      <pull_secret_name>

      イメージレジストリーからイメージをプルするために使用するシークレット (例 ibi-image-pull-secret) を指定します。

   2. 次のコマンドを実行して ClusterDeployment リソースを作成します。

      $ oc apply -f ibi-cluster-deployment.yaml

8. ManagedCluster リソースを作成します。

   1. ManagedCluster リソースを定義する YAML ファイルを作成します。

      ibi-managed.yaml ファイルの例:

      apiVersion: cluster.open-cluster-management.io/v1
      kind: ManagedCluster
      metadata:
        name: <managedcluster_name>
      spec:
        hubAcceptsClient: <hub_accepts_client>

      各項目の説明:

      <managedcluster_name>

      ManagedCluster リソースの名前 (例: sno-ibi) を指定します。

      <hub_accepts_client>

      RHACM がクラスターを管理するかどうかを指定します。管理を有効にするには、true に設定します。

   2. 次のコマンドを実行して、ManagedCluster リソースを作成します。

      $ oc apply -f ibi-managed.yaml

検証

1. 次のコマンドを実行して、ターゲットホストのインストールの進行状況を監視するためにハブクラスター内の ImageClusterInstall のステータスを確認します。

   $ oc get imageclusterinstall

   出力例:

   NAME       REQUIREMENTSMET           COMPLETED                     BAREMETALHOSTREF
   target-0   HostValidationSucceeded   ClusterInstallationSucceeded  ibi-bmh

   警告

   ImageClusterInstall リソースが削除された場合、IBI Operator は BareMetalHost リソースを再度アタッチし、マシンを再起動します。

2. インストールが完了したら、次のコマンドを実行して kubeconfig シークレットを取得し、マネージドクラスターにログインできます。

   $ oc extract secret/<cluster_name>-admin-kubeconfig -n <cluster_namespace>  --to - > <directory>/<cluster_name>-kubeconfig

   各項目の説明:

   <cluster_name>

   クラスターの名前を指定します。

   <cluster_namespace>

   クラスターの namespace を指定します。

   <directory>

   ファイルを作成するディレクトリーを指定します。