1.9. ホストインベントリーの概要

次のコマンドを実行して、ベアメタルホストのカスタムリソース定義がすでに存在するかどうかを確認します。

oc get crd baremetalhosts.metal3.io

Error from server (NotFound): customresourcedefinitions.apiextensions.k8s.io "baremetalhosts.metal3.io" not found

ベアメタルホストのカスタムリソース定義がない場合は、metal3.io_baremetalhosts.yaml ファイルをダウンロードし、次のコマンドを実行することでコンテンツを適用して、リソースを作成します。

oc apply -f

次のコマンドを実行して、Provisioning リソースがあるかどうかを確認します。

oc get provisioning

インフラストラクチャー Operator と同じ namespace に ConfigMap を作成し、ミラーレジストリーの ca-bundle.crt および registries.conf の値を指定します。ファイルの ConfigMap は次の例のようになります。

apiVersion: v1
kind: ConfigMap
metadata:
  name: <mirror-config>
  namespace: multicluster-engine
  labels:
    app: assisted-service
data:
  ca-bundle.crt: |
    <certificate-content>
  registries.conf: |
    unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
    [[registry]]
       prefix = ""
       location = "registry.redhat.io/multicluster-engine"
       mirror-by-digest-only = true
       [[registry.mirror]]
       location = "mirror.registry.com:5000/multicluster-engine"

注記: リリースイメージはダイジェストを使用して指定されるため、mirror-by-digest-only を true に設定する必要があります。

unqualified-search-registries のリストにあるレジストリーは、PUBLIC_CONTAINER_REGISTRIES 環境変数の認証無視リストに自動的に追加されます。マネージドクラスターのプルシークレットの検証時に、指定されたレジストリーは認証を必要としません。

headers という名前のファイルを作成し、次の例のような内容を追加します。

{
  "Authorization": "Basic xyz"
}

query_params という名前のファイルを作成し、次の例のような内容を追加します。

{
  "api_key": "myexampleapikey",
}

次のコマンドを使用して、マネージドクラスターにログインします。

oc login

AgentServiceConfig リソースに agent-install.openshift.io/service-image-base: el8 アノテーションを追加します。

AgentServiceConfig リソースは、次の YAML のようになります。

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
  annotations:
    agent-install.openshift.io/service-image-base: el8
...

次の情報をホストインベントリー設定に追加します。

次のコマンドを実行して、ハブクラスターにログインします。

oc login

リソースの namespace を作成します。

OpenShift Container Platform プルシークレット を含む Secret カスタムリソースを作成します。

インフラストラクチャー環境を作成します。

以下のコマンドを実行して YAML コンテンツを適用します。

oc apply -f infra-env.yaml

ホストインベントリーが作成されたことを確認するには、次のコマンドでステータスを確認します。

oc describe infraenv myinfraenv -n <your_namespace>

nmstateconfig.yaml という名前のファイルを作成し、以下のテンプレートのようなコンテンツを追加します。必要に応じて値を置き換えます。

apiVersion: agent-install.openshift.io/v1beta1
kind: NMStateConfig
metadata:
  name: mynmstateconfig
  namespace: <your-infraenv-namespace>
  labels:
    some-key: <some-value>
spec:
  config:
    interfaces:
      - name: eth0
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:14
        ipv4:
          enabled: true
          address:
            - ip: 192.168.111.30
              prefix-length: 24
          dhcp: false
      - name: eth1
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:15
        ipv4:
          enabled: true
          address:
            - ip: 192.168.140.30
              prefix-length: 24
          dhcp: false
    dns-resolver:
      config:
        server:
          - 192.168.126.1
    routes:
      config:
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.111.1
          next-hop-interface: eth1
          table-id: 254
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.140.1
          next-hop-interface: eth1
          table-id: 254
  interfaces:
    - name: "eth0"
      macAddress: "02:00:00:80:12:14"
    - name: "eth1"
      macAddress: "02:00:00:80:12:15"

以下のコマンドを実行して YAML コンテンツを適用します。

oc apply -f nmstateconfig.yaml

Add hosts をクリックし、With Discovery ISO を選択します。

ISO ファイルをダウンロードするための URL が表示されます。ブートされたホストがホストインベントリーテーブルに表示されます。ホストが表示されるまでに数分かかる場合があります。

注記: デフォルトでは、提供される ISO は minimal ISO です。最小限の ISO には、ルートファイルシステム RootFS が含まれていません。RootFS は後でダウンロードされます。完全な ISO を表示するには、URL 内の minimal.iso を full.iso に置き換えます。

次のコマンドを実行して、InfraEnv カスタムリソースのダウンロード URL を表示します。

oc get infraenv -n <infra env namespace> <infra env name> -o jsonpath='{.status.isoDownloadURL}'

以下の出力を参照してください。

https://assisted-image-service-assisted-installer.apps.example-acm-hub.com/byapikey/eyJhbGciOiJFUzI1NiIsInC93XVCJ9.eyJpbmZyYV9lbnZfaWQcTA0Y38sWVjYi02MTA0LTQ4NDMtODasdkOGIxYTZkZGM5ZTUifQ.3ydTpHaXJmTasd7uDp2NvGUFRKin3Z9Qct3lvDky1N-5zj3KsRePhAM48aUccBqmucGt3g/4.16/x86_64/minimal.iso

注記: デフォルトでは、提供される ISO は minimal ISO です。最小限の ISO には、ルートファイルシステム RootFS が含まれていません。RootFS は後でダウンロードされます。完全な ISO を表示するには、URL 内の minimal.iso を full.iso に置き換えます。

URL を使用して ISO ファイルをダウンロードし、ISO ファイルを使用してホストを起動します。

次に、各ホストを承認する必要があります。以下の手順を参照してください。

すべての エージェント をリスト表示するには、次のコマンドを実行します。

oc get agent -n <infra env namespace>

次のような出力が得られます。

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
24a92a6f-ea35-4d6f-9579-8f04c0d3591e             false      auto-assign

リストで承認ステータスが false の エージェント を承認します。以下のコマンドを実行します。

oc patch agent -n <infra env namespace> <agent name> -p '{"spec":{"approved":true}}' --type merge

承認ステータスを確認するには、次のコマンドを実行します。

oc get agent -n <infra env namespace>

値が true の、次のような出力が返されます。

NAME                                   CLUSTER   APPROVED   ROLE          STAGE
173e3a84-88e2-4fe1-967f-1a9242503bec             true       auto-assign

次の YAML コンテンツを適用し、必要に応じて値を置き換えて、BMC シークレットを作成します。

apiVersion: v1
kind: Secret
metadata:
  name: <bmc-secret-name>
  namespace: <your_infraenv_namespace> 1
type: Opaque
data:
  username: <username>
  password: <password>

以下の YAML コンテンツを適用し、必要に応じて値を置き換えてベアメタルホストを作成します。

apiVersion: metal3.io/v1alpha1
kind: BareMetalHost
metadata:
  name: <bmh-name>
  namespace: <your_infraenv_namespace> 1
  annotations:
    inspect.metal3.io: disabled
  labels:
    infraenvs.agent-install.openshift.io: <your-infraenv> 2
spec:
  online: true
  automatedCleaningMode: disabled 3
  bootMACAddress: <your-mac-address>  4
  bmc:
    address: <machine-address> 5
    credentialsName: <bmc-secret-name> 6
  rootDeviceHints:
    deviceName: /dev/sda 7