16.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> 

      1

      
      type: kubernetes.io/dockerconfigjson

      1

      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: host-network-config-secret 

      1

      
       namespace: ibi-ns
      type: Opaque
      stringData:
       nmstate: | 

      2

      
        interfaces:
          - name: ens1f0 

      3

      
            type: ethernet
            state: up
            ipv4:
              enabled: true
              address:
                - ip: 192.168.200.25
                  prefix-length: 24
              dhcp: false 

      4

      
            ipv6:
              enabled: false
        dns-resolver:
          config:
            server:
              - 192.168.15.47 

      5

      
              - 192.168.15.48
        routes:
          config: 

      6

      
            - destination: 0.0.0.0/0
              metric: 150
              next-hop-address: 192.168.200.254
              next-hop-interface: ens1f0
              table-id: 254

      1

      Secret リソースの名前を指定します。

      2

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

      3

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

      4

      nmstate がインターフェイスに静的 IP アドレスを割り当てるようにするには、dhcp: false を指定する必要があります。

      5

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

      6

      この例のデフォルトルートは、ens1f0 インターフェイスを介してネクストホップ IP アドレス 192.168.200.254 に設定されています。

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

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

      ibi-bmh.yaml ファイルの例

      apiVersion: metal3.io/v1alpha1
      kind: BareMetalHost
      metadata:
        name: ibi-bmh 

      1

      
        namespace: ibi-ns
      spec:
        online: false 

      2

      
        bootMACAddress: 00:a5:12:55:62:64 

      3

      
        bmc:
          address: redfish-virtualmedia+http://192.168.111.1:8000/redfish/v1/Systems/8a5babac-94d0-4c20-b282-50dc3a0a32b5 

      4

      
          credentialsName: ibi-bmh-bmc-secret 

      5

      
        preprovisioningNetworkDataName: host-network-config-secret 

      6

      
        automatedCleaningMode: disabled 

      7

      
        externallyProvisioned: true 

      8

      
      ---
      apiVersion: v1
      kind: Secret
      metadata:
        name: ibi-bmh-secret 

      9

      
        namespace: ibi-ns
      type: Opaque
      data:
        username: <user_name> 

      10

      
        password: <password> 

      11

      1

      BareMetalHost リソースの名前を指定します。

      2

      ホストをオンラインにするかどうかを指定します。

      3

      ホストのブート MAC アドレスを指定します。

      4

      BMC アドレスを指定します。仮想メディアネットワークの起動をサポートするベアメタルホストドライバー (redfish-virtualmedia や idrac-virtualmedia など) のみを使用できます。

      5

      ベアメタルホストの Secret リソースの名前を指定します。

      6

      オプション: ホストに静的ネットワーク設定が必要な場合は、その設定を含む Secret リソースの名前を指定します。

      7

      プロビジョニングサービスがディスク検査中にシードイメージなどのすべてのプリインストールアーティファクトを削除しないようにするには、automatedCleaningMode:disabled を指定する必要があります。

      8

      ホストを、設定 ISO ではなくプリインストールされたディスクから起動できるようにするには、externallyProvisioned: true を指定する必要があります。

      9

      Secret リソースの名前を指定します。

      10

      ユーザー名を指定します。

      11

      パスワードを指定します。

   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: ibi-img-version-arch 

      1

      
      spec:
        releaseImage: ibi.example.com:path/to/release/images:version-arch 

      2

      1

      ClusterImageSet リソースの名前を指定します。

      2

      デプロイメントに使用するリリースイメージのアドレスを指定します。シードイメージの生成時に使用したイメージレジストリーとは異なるイメージレジストリーを使用する場合は、そのリリースイメージの 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: ibi-image-install 

      1

      
        namespace: ibi-ns
      spec:
        bareMetalHostRef:
          name: ibi-bmh 

      2

      
          namespace: ibi-ns
        clusterDeploymentRef:
          name: ibi-cluster-deployment 

      3

      
        hostname: ibi-host 

      4

      
        imageSetRef:
          name: ibi-img-version-arch 

      5

      
        machineNetwork: 10.0.0.0/24 

      6

      
        proxy: 

      7

      
          httpProxy: "http://proxy.example.com:8080"
          #httpsProxy: "http://proxy.example.com:8080"
          #noProxy: "no_proxy.example.com"

      1

      ImageClusterInstall リソースの名前を指定します。

      2

      イメージベースのインストールのターゲットとなる BareMetalHost リソースを指定します。

      3

      ターゲットホストのイメージベースのインストールに使用する ClusterDeployment リソースの名前を指定します。

      4

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

      5

      デプロイメントに使用するコンテナーリリースイメージを定義するために使用した ClusterImageSet リソースの名前を指定します。

      6

      外部ネットワークの公開 CIDR (Classless Inter-Domain Routing) を指定します。

      7

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

      重要

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

      • プロキシー設定を備えたシードクラスターからシードイメージを作成します。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: ibi-cluster-deployment 

      1

      
        namespace: ibi-ns 

      2

      
      spec:
        baseDomain: example.com 

      3

      
        clusterInstallRef:
          group: extensions.hive.openshift.io
          kind: ImageClusterInstall
          name: ibi-image-install 

      4

      
          version: v1alpha1
        clusterName: ibi-cluster 

      5

      
        platform:
          none: {}
        pullSecretRef:
          name: ibi-image-pull-secret 

      6

      1

      ClusterDeployment リソースの名前を指定します。

      2

      ClusterDeployment リソースの namespace を指定します。

      3

      クラスターが属するベースドメインを指定します。

      4

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

      5

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

      6

      イメージレジストリーからイメージをプルするために使用するシークレットを指定します。

   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: sno-ibi 

      1

      
      spec:
        hubAcceptsClient: true 

      2

      1

      ManagedCluster リソースの名前を指定します。

      2

      true を指定して、RHACM がクラスターを管理できるようにします。

   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> はファイルを作成するディレクトリーです。

手順

1. 次のコマンドを実行して作業ディレクトリーを作成します。

   $ mkdir ibi-config-iso-workdir 

   1

   1

   ibi-config-iso-workdir は、作業ディレクトリーの名前に置き換えます。

2. インストールマニフェストを作成します。

   1. install-config マニフェストを定義する YAML ファイルを作成します。

      install-config.yaml ファイルの例

      apiVersion: v1
      metadata:
        name: sno-cluster-name
      baseDomain: host.example.com
      compute:
        - architecture: amd64
          hyperthreading: Enabled
          name: worker
          replicas: 0
      controlPlane:
        architecture: amd64
        hyperthreading: Enabled
        name: master
        replicas: 1
      networking:
        machineNetwork:
        - cidr: 192.168.200.0/24
      platform:
        none: {}
      fips: false
      cpuPartitioningMode: "AllNodes"
      pullSecret: '{"auths":{"<your_pull_secret>"}}}'
      sshKey: 'ssh-rsa <your_ssh_pub_key>'

      重要

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

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

3. オプション: 次のコマンドを実行して、作業ディレクトリーに設定テンプレートを作成します。

   $ openshift-install image-based create config-template --dir ibi-config-iso-workdir/

   出力例

   INFO Config-Template created in: ibi-config-iso-workdir

   このコマンドにより、作業ディレクトリーに image-based-config.yaml 設定テンプレートが作成されます。

   #
   # Note: This is a sample ImageBasedConfig file showing
   # which fields are available to aid you in creating your
   # own image-based-config.yaml file.
   #
   apiVersion: v1beta1
   kind: ImageBasedConfig
   metadata:
     name: example-image-based-config
   additionalNTPSources:
     - 0.rhel.pool.ntp.org
     - 1.rhel.pool.ntp.org
   hostname: change-to-hostname
   releaseRegistry: quay.io
   # networkConfig contains the network configuration for the host in NMState format.
   # See https://nmstate.io/examples.html for examples.
   networkConfig:
     interfaces:
       - name: eth0
         type: ethernet
         state: up
         mac-address: 00:00:00:00:00:00
         ipv4:
           enabled: true
           address:
             - ip: 192.168.122.2
               prefix-length: 23
           dhcp: false

4. 設定ファイルを編集します。

   image-based-config.yaml ファイルの例

   #
   # Note: This is a sample ImageBasedConfig file showing
   # which fields are available to aid you in creating your
   # own image-based-config.yaml file.
   #
   apiVersion: v1beta1
   kind: ImageBasedConfig
   metadata:
     name: sno-cluster-name
   additionalNTPSources:
     - 0.rhel.pool.ntp.org
     - 1.rhel.pool.ntp.org
   hostname: host.example.com
   releaseRegistry: quay.io
   # networkConfig contains the network configuration for the host in NMState format.
   # See https://nmstate.io/examples.html for examples.
   networkConfig:
       interfaces:
         - name: ens1f0
           type: ethernet
           state: up
           ipv4:
             enabled: true
             dhcp: false
             auto-dns: false
             address:
               - ip: 192.168.200.25
                 prefix-length: 24
           ipv6:
             enabled: false
       dns-resolver:
         config:
           server:
             - 192.168.15.47
             - 192.168.15.48
       routes:
         config:
         - destination: 0.0.0.0/0
           metric: 150
           next-hop-address: 192.168.200.254
           next-hop-interface: ens1f0

5. 次のコマンドを実行して、作業ディレクトリーに設定 ISO を作成します。

   $ openshift-install image-based create config-image --dir ibi-config-iso-workdir/

   出力例

   INFO Adding NMConnection file <ens1f0.nmconnection>
   INFO Consuming Install Config from target directory
   INFO Consuming Image-based Config ISO configuration from target directory
   INFO Config-Image created in: ibi-config-iso-workdir/auth

   作業ディレクトリーで出力を確認します。

   出力例

   ibi-config-iso-workdir/
   ├── auth
   │   ├── kubeadmin-password
   │   └── kubeconfig
   └── imagebasedconfig.iso

6. 任意の方法を使用して imagebasedconfig.iso をプリインストールされたホストにアタッチします。ホストを再起動して設定プロセスを完了し、クラスターをデプロイします。

1. 次のコマンドを実行して、kubeconfig 環境変数を kubeconfig ファイルにエクスポートします。

   $ export KUBECONFIG=ibi-config-iso-workdir/auth/kubeconfig

2. 次のコマンドを実行して、クラスターが応答していることを確認します。

   $ oc get nodes

   出力例

   NAME                                         STATUS   ROLES                  AGE     VERSION
   node/sno-cluster-name.host.example.com       Ready    control-plane,master   5h15m   v1.31.3