Agent-based Installer を使用したオンプレミスクラスターのインストール

1. install-config.yaml ファイルで fips フィールドの値を True に設定する必要があります。

   サンプル install-config.yaml.file

   apiVersion: v1
   baseDomain: test.example.com
   metadata:
     name: sno-cluster
   fips: True

   Copy to Clipboard Toggle word wrap

2. オプション: ZTP マニフェストを使用している場合、agent-cluster-install.yaml ファイルの Agent-install.openshift.io/install-config-overrides フィールドで fips の値を True に設定する必要があります。

   サンプルの agent-cluster-install.yaml ファイル

   apiVersion: extensions.hive.openshift.io/v1beta1
   kind: AgentClusterInstall
   metadata:
     annotations:
       agent-install.openshift.io/install-config-overrides: '{"fips": True}'
     name: sno-cluster
     namespace: sno-cluster-test

   Copy to Clipboard Toggle word wrap

手順

1. ログイン認証情報を使用して OpenShift Container Platform Web コンソールにログインします。

2. データセンター に移動します。

   

   View larger image

   
3. Run Agent-based Installer locally をクリックします。Install OpenShift Container Platform on Bare Metal locally with Agent ページに移動します。

4. オプション: または、Select an OpenShift Container Platform cluster type to create ページで Bare Metal (x86_64) をクリックすることもできます。Create an OpenShift Container Platform Cluster: Bare Metal ページに移動します。次に、Local Agent-based を選択して Install OpenShift Container Platform on Bare Metal Local with Agent ページに移動します。

   

   View larger image

   
5. オペレーティングシステムとアーキテクチャーを選択します。
6. Download Installer をクリックして、インストールプログラムをダウンロードして展開します。
7. Download pull secret または Copy pull secret をクリックして、プルシークレットをダウンロードまたはコピーできます。
8. Download command-line tools をクリックし、openshift-install バイナリーを PATH 上のディレクトリーに配置します。

9. 以下のコマンドを実行して nmstate の依存関係をインストールします。

   $ sudo dnf install /usr/bin/nmstatectl -y

   Copy to Clipboard Toggle word wrap
10. PATH にあるディレクトリーに openshift-install バイナリーを配置します。

11. 次のコマンドを実行して、インストール設定を保存するディレクトリーを作成します。

    $ mkdir ~/<directory_name>

    Copy to Clipboard Toggle word wrap
    注記

    これは、エージェントベースのインストールで推奨される方法です。ZTP マニフェストの使用はオプションです。

12. install-config.yaml ファイルを作成します。

    $ cat << EOF > ./my-cluster/install-config.yaml
    apiVersion: v1
    baseDomain: test.example.com
    compute:
    - architecture: amd64
      hyperthreading: Enabled
      name: worker
      replicas: 0
    controlPlane:
      architecture: amd64
      hyperthreading: Enabled
      name: master
      replicas: 1
    metadata:
      name: sno-cluster 

    1

    
    networking:
      clusterNetwork:
      - cidr: 10.128.0.0/14
        hostPrefix: 23
      machineNetwork:
      - cidr: 192.168.111.0/16
      networkType: OVNKubernetes 

    2

    
      serviceNetwork:
      - 172.30.0.0/16
    platform:
      none: {}
    pullSecret: '<pull_secret>' 

    3

    
    sshKey: |
      <ssh_pub_key> 

    4

    
      EOF

    Copy to Clipboard Toggle word wrap

    1

    必須。

    2

    インストールするクラスターネットワークプラグイン。サポートされている値は OVNKubernetes と OpenShiftSDN です。デフォルトの値は OVNkubernetes です。

    3

    プルシークレットを入力します。

    4

    ssh 公開鍵を入力します。

    注記

    プラットフォームを vSphere または baremetal に設定すると、クラスターノードの IP アドレスエンドポイントを次の 3 つの方法で設定できます。

    • IPv4
    • IPv6
    • IPv4 と IPv6 の並列 (デュアルスタック)

    デュアルスタックネットワーキングの例

    networking:
      clusterNetwork:
        - cidr: 172.21.0.0/16
          hostPrefix: 23
        - cidr: fd02::/48
          hostPrefix: 64
      machineNetwork:
        - cidr: 192.168.11.0/16
        - cidr: 2001:DB8::/32
      serviceNetwork:
        - 172.22.0.0/16
        - fd03::/112
      networkType: OVNKubernetes
    platform:
      baremetal:
        apiVIPs:
        - 192.168.11.3
        - 2001:DB8::4
        ingressVIPs:
        - 192.168.11.4
        - 2001:DB8::5

    Copy to Clipboard Toggle word wrap

    IPv6 は、ベアメタルプラットフォームでのみサポートされます。

13. agent-config.yaml ファイルを作成します。

    $ cat > agent-config.yaml << EOF
    apiVersion: v1alpha1
    kind: AgentConfig
    metadata:
      name: sno-cluster
    rendezvousIP: 192.168.111.80 

    1

    
    hosts: 

    2

    
      - hostname: master-0 

    3

    
        interfaces:
          - name: eno1
            macAddress: 00:ef:44:21:e6:a5
        rootDeviceHints: 

    4

    
          deviceName: /dev/sdb
        networkConfig: 

    5

    
          interfaces:
            - name: eno1
              type: ethernet
              state: up
              mac-address: 00:ef:44:21:e6:a5
              ipv4:
                enabled: true
                address:
                  - ip: 192.168.111.80
                    prefix-length: 23
                dhcp: false
          dns-resolver:
            config:
              server:
                - 192.168.111.1
          routes:
            config:
              - destination: 0.0.0.0/0
                next-hop-address: 192.168.111.2
                next-hop-interface: eno1
                table-id: 254
      EOF

    Copy to Clipboard Toggle word wrap

    1

    この IP アドレスは、ブートストラッププロセスを実行するノードや、assisted-service コンポーネントを実行するノードを判別するために使用されます。networkConfig パラメーターで少なくとも 1 つのホストの IP アドレスを指定しない場合は、ランデブー IP アドレスを指定する必要があります。このアドレスが指定されていない場合、指定されたホストの networkConfig から 1 つの IP アドレスが選択されます。

    2

    ホスト設定はオプションです。定義されたホストの数は、install-config.yaml ファイルで定義されたホストの総数 (compute.replicas および controlPlane.replicas パラメーターの値の合計) を超えてはなりません。

    3

    オプションの hostname パラメーターは、動的ホスト設定プロトコル (DHCP) または逆引き DNS ルックアップから取得したホスト名をオーバーライドします。各ホストには、これらの方法のいずれかによって提供される一意のホスト名が必要です。

    4

    rootDeviceHints パラメーターは、Red Hat Enterprise Linux CoreOS (RHCOS) イメージを特定のデバイスにプロビジョニングできるようにします。これは、検出順にデバイスを検査し、検出された値をヒントの値と比較します。ヒントの値と一致する最初に検出されたデバイスが使用されます。

    5

    ホストのネットワークインターフェイスを NMState 形式で設定するには、このオプションパラメーターを設定します。

14. 以下のコマンドを実行して agent イメージを作成します。

    $ openshift-install --dir <install_directory> agent create image

    Copy to Clipboard Toggle word wrap
    注記

    Red Hat Enterprise Linux CoreOS (RHCOS) はプライマリーディスクでのマルチパスをサポートするようになり、ハードウェア障害に対する対障害性が強化され、ホストの可用性を強化できるようになりました。マルチパス化は、デフォルトの /etc/multipath.conf 設定を使用して、agent.iSO イメージでデフォルトで有効になっています。

15. ベアメタルマシンで agent.x86_64.iso イメージを起動します。

16. オプション: ブートストラップホスト (ランデブーホスト) がいつ再起動するかを知るには、次のコマンドを実行します。

    $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete \ 

    1

    
        --log-level=info 

    2

    Copy to Clipboard Toggle word wrap

    1

    <install_directory> には、エージェント ISO が生成されたディレクトリーへのパスを指定します。

    2

    異なるインストールの詳細情報を表示するには、info ではなく、warn、debug、または error を指定します。

    出力例

    ...................................................................
    ...................................................................
    INFO Bootstrap configMap status is complete
    INFO cluster bootstrap is complete

    Copy to Clipboard Toggle word wrap

    Kubernetes API サーバーでこれがコントロールプレーンマシンにブートストラップされていることを示すシグナルが出されるとコマンドは成功します。

17. 進捗状況を追跡し、正常なインストールを確認するには、以下のコマンドを実行します。

    $ openshift-install --dir <install_directory> agent wait-for install-complete 

    1

    Copy to Clipboard Toggle word wrap

    1

    <install_directory> directory には、エージェント ISO が生成されたディレクトリーへのパスを指定します。

    出力例

    ...................................................................
    ...................................................................
    INFO Cluster is installed
    INFO Install complete!
    INFO To access the cluster as the system:admin user when using 'oc', run
    INFO     export KUBECONFIG=/home/core/installer/auth/kubeconfig
    INFO Access the OpenShift web-console here: https://console-openshift-console.apps.sno-cluster.test.example.com

    Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行し、出力を収集します。

   $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete --log-level=debug

   Copy to Clipboard Toggle word wrap

   エラーメッセージの例

   ...
   ERROR Bootstrap failed to complete: : bootstrap process timed out: context deadline exceeded

   Copy to Clipboard Toggle word wrap

2. 前のコマンドの出力が失敗を示している場合、またはブートストラップが進まない場合は、ノード 0 で次のコマンドを実行し、出力を収集します。

   $ ssh core@<node-ip> sudo /usr/local/bin/agent-gather -O > <local_tmp_path>/agent-gather.tar.xz

   Copy to Clipboard Toggle word wrap
   注記

   データを収集する必要があるのはノード 0 だけですが、すべてのノードからこのデータを収集すると役立ちます。

3. ブートストラップが完了し、クラスターノードが再起動したら、次のコマンドを実行して出力を収集します。

   $ ./openshift-install --dir <install_directory> agent wait-for install-complete --log-level=debug

   Copy to Clipboard Toggle word wrap

4. 前のコマンドの出力が失敗を示している場合は、次の手順を実行します。

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

      $ export KUBECONFIG=<install_directory>/auth/kubeconfig

      Copy to Clipboard Toggle word wrap

   2. デバッグ用の情報を収集するには、次のコマンドを実行します。

      $ oc adm must-gather

      Copy to Clipboard Toggle word wrap

   3. 次のコマンドを実行して、作業ディレクトリーに作成した must-gather ディレクトリーから圧縮ファイルを作成します。

      $ tar cvaf must-gather.tar.gz <must_gather_directory>

      Copy to Clipboard Toggle word wrap
5. /auth サブディレクトリーを除き、デプロイメント中に使用したインストールディレクトリーを Red Hat カスタマーポータル のサポートケースに添付します。
6. この手順で収集した他のすべてのデータをサポートケースに添付してください。

手順

1. <assets_directory> フォルダーを作成して、有効な install-config.yaml および agent-config.yaml ファイルを含めます。このディレクトリーは、すべてのアセットを格納するために使用されます。

2. OpenShift Container Platform イメージリポジトリー、マルチクラスターエンジン、および LSO をミラーリングするには、以下の設定で ImageSetConfiguration.yaml ファイルを作成します。

   ImageSetConfiguration.yaml の例

     kind: ImageSetConfiguration
     apiVersion: mirror.openshift.io/v1alpha2
     archiveSize: 4 

   1

   
     storageConfig: 

   2

   
       imageURL: <your-local-registry-dns-name>:<your-local-registry-port>/mirror/oc-mirror-metadata 

   3

   
       skipTLS: true
     mirror:
       platform:
         architectures:
           - "amd64"
         channels:
           - name: stable-4.12 

   4

   
             type: ocp
       additionalImages:
         - name: registry.redhat.io/ubi8/ubi:latest
       operators:
         - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.12 

   5

   
           packages: 

   6

   
             - name: multicluster-engine 

   7

   
             - name: local-storage-operator 

   8

   Copy to Clipboard Toggle word wrap

   1

   イメージセット内の各ファイルの最大サイズを GiB 単位で指定します。

   2

   イメージセットのメタデータを受け取るバックエンドの場所を設定します。この場所は、レジストリーまたはローカルディレクトリーにすることができます。Technology Preview OCI 機能を使用していない場合は、storageConfig 値を指定する必要があります。

   3

   ストレージバックエンドのレジストリー URL を設定します。

   4

   インストールするバージョンの OpenShift Container Platform イメージを含むチャネルを設定します。

   5

   インストールする OpenShift Container Platform イメージを含む Operator カタログを設定します。

   6

   イメージセットに含める特定の Operator パッケージとチャネルのみを指定します。カタログ内のすべてのパッケージを取得するには、このフィールドを削除してください。

   7

   マルチクラスターエンジンのパッケージとチャネル。

   8

   LSO パッケージとチャネル。

   注記

   このファイルは、コンテンツをミラーリングするときに oc mirror コマンドで必要になります。

3. 特定の OpenShift Container Platform イメージリポジトリー、マルチクラスターエンジン、および LSO をミラーリングするには、以下のコマンドを実行します。

   $ oc mirror --dest-skip-tls --config ocp-mce-imageset.yaml docker://<your-local-registry-dns-name>:<your-local-registry-port>

   Copy to Clipboard Toggle word wrap

4. install-config.yaml ファイルのレジストリーと証明書を更新します。

   Example imageContentSources.yaml

     imageContentSources:
       - source: "quay.io/openshift-release-dev/ocp-release"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/openshift/release-images"
       - source: "quay.io/openshift-release-dev/ocp-v4.0-art-dev"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/openshift/release"
       - source: "registry.redhat.io/ubi8"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/ubi8"
       - source: "registry.redhat.io/multicluster-engine"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/multicluster-engine"
       - source: "registry.redhat.io/rhel8"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/rhel8"
       - source: "registry.redhat.io/redhat"
         mirrors:
           - "<your-local-registry-dns-name>:<your-local-registry-port>/redhat"

   Copy to Clipboard Toggle word wrap

   さらに、証明書が install-config.yaml の additionalTrustBundle フィールドに存在することを確認してください。

   install-config.yaml の例

   additionalTrustBundle: |
     -----BEGIN CERTIFICATE-----
     zzzzzzzzzzz
     -----END CERTIFICATE-------

   Copy to Clipboard Toggle word wrap

   重要

   oc mirror コマンドは、いくつかの出力を含む oc-mirror-workspace というフォルダーを作成します。これには、OpenShift Container Platform および選択した Operator に必要なすべてのミラーを識別する imageContentSourcePolicy.yaml ファイルが含まれます。

5. 次のコマンドを実行して、クラスターマニフェストを生成します。

   $ openshift-install agent create cluster-manifests

   Copy to Clipboard Toggle word wrap

   このコマンドは、クラスターマニフェストフォルダーを更新して、ミラー設定を含む mirror フォルダーを含めます。

手順

1. <assets_directory> フォルダーに openshift という名前のサブフォルダーを作成します。このサブフォルダーは、デプロイされたクラスターをさらにカスタマイズするためにインストール中に適用される追加のマニフェストを格納するために使用されます。<assets_directory> フォルダーには、install-config.yaml および agent-config.yaml ファイルを含むすべてのアセットが含まれています。

   注記

   インストーラーは、追加のマニフェストを検証しません。

2. マルチクラスターエンジンの場合、以下のマニフェストを作成し、それらを <assets_directory>/openshift フォルダーに保存します。

   例 mce_namespace.yaml

     apiVersion: v1
     kind: Namespace
     metadata:
       labels:
         openshift.io/cluster-monitoring: "true"
       name: multicluster-engine

   Copy to Clipboard Toggle word wrap

   例 mce_operatorgroup.yaml

     apiVersion: operators.coreos.com/v1
     kind: OperatorGroup
     metadata:
       name: multicluster-engine-operatorgroup
       namespace: multicluster-engine
     spec:
       targetNamespaces:
       - multicluster-engine

   Copy to Clipboard Toggle word wrap

   例 mce_subscription.yaml

     apiVersion: operators.coreos.com/v1alpha1
     kind: Subscription
     metadata:
       name: multicluster-engine
       namespace: multicluster-engine
     spec:
       channel: "stable-2.1"
       name: multicluster-engine
       source: redhat-operators
       sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

   注記

   Assisted Installer (AI) を使用して、Red Hat Advanced Cluster Management (RHACM) で分散ユニット (DU) を大規模にインストールできます。これらの分散ユニットは、ハブクラスターで有効にする必要があります。AI サービスには、手動で作成される永続ボリューム (PV) が必要です。

3. AI サービスの場合、以下のマニフェストを作成し、それらを <assets_directory>/openshift フォルダーに保存します。

   Example lso_namespace.yaml

     apiVersion: v1
     kind: Namespace
     metadata:
       annotations:
         openshift.io/cluster-monitoring: "true"
       name: openshift-local-storage

   Copy to Clipboard Toggle word wrap

   Example lso_operatorgroup.yaml

     apiVersion: operators.coreos.com/v1
     kind: OperatorGroup
     metadata:
       name: local-operator-group
       namespace: openshift-local-storage
     spec:
       targetNamespaces:
         - openshift-local-storage

   Copy to Clipboard Toggle word wrap

   Example lso_subscription.yaml

     apiVersion: operators.coreos.com/v1alpha1
     kind: Subscription
     metadata:
       name: local-storage-operator
       namespace: openshift-local-storage
     spec:
       installPlanApproval: Automatic
       name: local-storage-operator
       source: redhat-operators
       sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

   注記

   すべてのマニフェストを作成した後、ファイルシステムは次のように表示される必要があります。

   例: ファイルシステム

   <assets_directory>
       ├─ install-config.yaml
       ├─ agent-config.yaml
       └─ /openshift
           ├─ mce_namespace.yaml
           ├─ mce_operatorgroup.yaml
           ├─ mce_subscription.yaml
           ├─ lso_namespace.yaml
           ├─ lso_operatorgroup.yaml
           └─ lso_subscription.yaml

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、エージェント ISO イメージを作成します。

   $ openshift-install agent create image --dir <assets_directory>

   Copy to Clipboard Toggle word wrap
5. イメージの準備ができたら、ターゲットマシンを起動し、インストールが完了するまで待ちます。

6. インストールを監視するには、次のコマンドを実行します。

   $ openshift-install agent wait-for install-complete --dir <assets_directory>

   Copy to Clipboard Toggle word wrap
   注記

   完全に機能するハブクラスターを設定するには、次のマニフェストを作成し、コマンド $ oc apply -f <manifest-name> を実行して手動で適用する必要があります。マニフェストの作成順序は重要であり、必要に応じて待機状態が表示されます。

7. AI サービスに必要な PV については、次のマニフェストを作成します。

     apiVersion: local.storage.openshift.io/v1
     kind: LocalVolume
     metadata:
      name: assisted-service
      namespace: openshift-local-storage
     spec:
      logLevel: Normal
      managementState: Managed
      storageClassDevices:
        - devicePaths:
            - /dev/vda
            - /dev/vdb
          storageClassName: assisted-service
          volumeMode: Filesystem

   Copy to Clipboard Toggle word wrap

8. 後続のマニフェストを適用する前に、次のコマンドを使用して PV が使用可能になるまで待機します。

   $ oc wait localvolume -n openshift-local-storage assisted-service --for condition=Available --timeout 10m

   Copy to Clipboard Toggle word wrap
   注記

   The `devicePath` is an example and may vary depending on the actual hardware configuration used.

   Copy to Clipboard Toggle word wrap

9. マルチクラスターエンジンインスタンスのマニフェストを作成します。

   Example MultiClusterEngine.yaml

     apiVersion: multicluster.openshift.io/v1
     kind: MultiClusterEngine
     metadata:
       name: multiclusterengine
     spec: {}

   Copy to Clipboard Toggle word wrap

10. マニフェストを作成して AI サービスを有効にします。

    例 agentserviceconfig.yaml

      apiVersion: agent-install.openshift.io/v1beta1
      kind: AgentServiceConfig
      metadata:
        name: agent
        namespace: assisted-installer
      spec:
       databaseStorage:
        storageClassName: assisted-service
        accessModes:
        - ReadWriteOnce
        resources:
         requests:
          storage: 10Gi
       filesystemStorage:
        storageClassName: assisted-service
        accessModes:
        - ReadWriteOnce
        resources:
         requests:
          storage: 10Gi

    Copy to Clipboard Toggle word wrap

11. 後続のスポーククラスターをデプロイするためのマニフェストを作成します。

    例 clusterimageset.yaml

      apiVersion: hive.openshift.io/v1
      kind: ClusterImageSet
      metadata:
        name: "4.12"
      spec:
        releaseImage: quay.io/openshift-release-dev/ocp-release:4.12.0-x86_64

    Copy to Clipboard Toggle word wrap

12. マニフェストを作成して、エージェントがインストールされたクラスター (マルチクラスターエンジンと Assisted Service をホストするクラスター) をハブクラスターとしてインポートします。

    例 autoimport.yaml

      apiVersion: cluster.open-cluster-management.io/v1
      kind: ManagedCluster
      metadata:
       labels:
         local-cluster: "true"
         cloud: auto-detect
         vendor: auto-detect
       name: local-cluster
      spec:
       hubAcceptsClient: true

    Copy to Clipboard Toggle word wrap

13. マネージドクラスターが作成されるまで待ちます。

    $ oc wait -n multicluster-engine managedclusters local-cluster --for condition=ManagedClusterJoined=True --timeout 10m

    Copy to Clipboard Toggle word wrap