17.3. RHACM および SiteConfig リソースを使用したマネージドクラスターのインストール

• ホストオペレーティングシステム (RHCOS) の空のサーバーへのインストール。
• OpenShift Container Platform のデプロイ
• クラスターポリシーおよびサイトサブスクリプションの作成
• サーバーオペレーティングシステムに必要なネットワーク設定を行う
• プロファイル Operator をデプロイし、パフォーマンスプロファイル、PTP、SR-IOV などの必要なソフトウェア関連の設定を実行します。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。
• 必要なインストール CR とポリシー CR を生成するためにハブクラスターを設定している。

• カスタムサイトの設定データを管理する Git リポジトリーを作成している。リポジトリーはハブクラスターからアクセスできる必要があり、ArgoCD アプリケーションのソースリポジトリーとして設定する必要があります。詳細は、「GitOps ZTP サイト設定リポジトリーの準備」を参照してください。

  注記

  ソースリポジトリーを作成するときは、ztp-site-generate コンテナーから抽出した argocd/deployment/argocd-openshift-gitops-patch.json パッチファイルを使用して ArgoCD アプリケーションにパッチを適用してください。「ArgoCD を使用したハブクラスターの設定」を参照してください。

• マネージドクラスターをプロビジョニングする準備を整えるには、各ベアメタルホストごとに次のものが必要です。

  ネットワーク接続

  ネットワークには DNS が必要です。マネージドクラスターホストは、ハブクラスターから到達可能である必要があります。ハブクラスターとマネージドクラスターホストの間にレイヤー 3 接続が存在することを確認します。

  Baseboard Management Controller (BMC) の詳細

  ZTP は、BMC のユーザー名とパスワードの詳細を使用して、クラスターのインストール中に BMC に接続します。GitOps ZTP プラグインは、サイトの Git リポジトリーの SiteConfig CR に基づいて、ハブクラスター上の ManagedCluster CR を管理します。ホストごとに個別の BMCSecret CR を手動で作成します。

  手順

  1. ハブクラスターで必要なマネージドクラスターシークレットを作成します。これらのリソースは、クラスター名と一致する名前を持つネームスペースに存在する必要があります。たとえば、out/argocd/example/siteconfig/example-sno.yaml では、クラスター名と namespace が example-sno になっています。

     1. 次のコマンドを実行して、クラスター namespace をエクスポートします。

        $ export CLUSTERNS=example-sno

     2. namespace を作成します。

        $ oc create namespace $CLUSTERNS

  2. マネージドクラスターのプルシークレットと BMC Secret CR を作成します。プルシークレットには、OpenShift Container Platform のインストールに必要なすべての認証情報と、必要なすべての Operator を含める必要があります。詳細は、「マネージドベアメタルホストシークレットの作成」を参照してください。

     注記

     シークレットは、名前で SiteConfig カスタムリソース (CR) から参照されます。namespace は SiteConfig namespace と一致する必要があります。

  3. Git リポジトリーのローカルクローンに、クラスターの SiteConfig CR を作成します。

     1. out/argocd/example/siteconfig/ フォルダーから CR の適切な例を選択します。フォルダーには、シングルノード、3 ノード、標準クラスターのサンプルファイルが含まれます。

        • example-sno.yaml
        • example-3node.yaml
        • example-standard.yaml

     2. サンプルファイルのクラスターおよびホスト詳細を、必要なクラスタータイプに一致するように変更します。以下に例を示します。

        # example-node1-bmh-secret および assisted-deployment-pull-secret は、同じ namespace example-sno --- apiVersion: ran.openshift.io/v1 kind に作成する必要があります。SiteConfig metadata: name: "example-sno" namespace: "example-sno" spec: baseDomain: "example.com" pullSecretRef: name: "assisted-deployment-pull-secret" clusterImageSetNameRef: "openshift-4.10" sshPublicKey: "ssh-rsa AAAA…​" clusters: - clusterName: "example-sno" NetworkType: "OVNKubernetes" # installConfigOverrides は、siteConfig を介して install-config # パラメーターを渡す一般的な方法です。'capabilities' フィールドは、# の設定可能な openshift 機能を設定します。この 'capabilities' の設定では、# コンポーネントのセットから marketplace コンポーネントを除き、すべてを削除します。# 注記：# - OperatorLifecycleManager は 4.15 以降に必要です # - NodeTuning は 4.12 以降に必要です。4.12 以前の installConfigOverrides: | { "capabilities": { "baselineCapabilitySet": "None" "additionalEnabledCapabilities": [ "NodeTuning", "OperatorLifecycleManager" ] } } # 4.13+ の追加のインストール時マニフェストの一部として crun マニフェストを含めることが強く推奨されます。# crun マニフェストは、source-crs/optional-extra-manifest/ から取得され、git リポジトリーie.sno-extra-manifest に追加できます。# extraManifestPath: sno-extra-manifest clusterLabels: #これらのクラスターラベルの例は、PolicyGenTemplate の例 du-profile: "latest" # の bindingRules に対応します。これらのクラスターラベルの例は、../policygentemplates: # ./policygentemplates/common-ranGen.yaml の PolicyGenTemplate の例の bindingRules に対応します。'common: true' common: true のあるすべてのクラスターに適用されます # ../policygentemplates/group-du-sno-ranGen.yaml は、'group-du-sno: ""' group-du-sno: "" # ../policygentemplates/example-sno-site.yaml を持つすべてのクラスターに適用されます。'sites: "example-sno"' # のあるすべてのクラスターには、通常、クラスター名と一致するか、または含まれている必要があります。これにより、単一クラスターサイトにのみ適用されます。："example-sno" clusterNetwork: - cidr: 1001:1::/48 hostPrefix: 64 machineNetwork: - cidr: 1111:2222:3333:4444::/64 serviceNetwork: - 1001:2::/112 additionalNTPSources: - 1111:2222:3333:4444::2 # ワークロードの分割のためにクラスターを開始します。特定の予約済み/分離 CPUSet 設定は PolicyTemplate # で行われます。完全なガイドは、ワークロードパーティショニング機能 を参照してください。cpuPartitioningMode: AllNodes # オプション：これは、このクラスター用に作成された KlusterletAddonConfig を上書きするために使用できます。crTemplates: # KlusterletAddonConfig: "KlusterletAddonConfigOverride.yaml" nodes: - hostName: "example-node1.example.com" role: "master" # オプション：これは、ホストで必要な BIOS 設定を設定するために使用できます：#biosConfigRef: # filePath: "example-hw.profile" bmcAddress: "idrac-virtualmedia+https://[1111:2222:3333::bbbb:1]/redfish/v1/Systems/System.Embedded.1" bmcCredentialsName: name: "example-node1-bmh-secret" bootMACAddress: "AA:BB:CC:DD:EE:11" # Use UEFISecureBoot セキュアブート bootMode: "UEFI" rootDeviceHints: deviceName: "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0" # disk partition at /var/lib/containers with ignitionConfigOverride.一部の値を更新する必要があります。詳細は、DiskPartitionContainer.md : | { "ignition": { "version": "3.2.0" }, "storage": { "disks": [ { "device": "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0", "partitions": [ { "label": "var-lib-containers", "sizeMiB": 0, "startMiB": 250000 } ], "wipeTable": false } ], "filesystems": [ { "device": "/dev/disk/by-partlabel/var-lib-containers", "format": "xfs", "mountOptions": [ "defaults", "prjquota" ], "path": "/var/lib/containers", "wipeFilesystem": true } ] }, "systemd": { "units": [ { "contents": " Generated by Butane\n[Unit]\nRequires=systemd-fsck@dev-disk-by\\x2dpartlabel-var\\x2dcontainers.service\nAfter=systemd-fsck@dev-disk-by\\x2dpartlabel-var\\x2dlib\\x2dcontainers.service\n\n\n\n\ prjquota\n\n[Install]\nRequiredBy=local-fs.target", "enabled": true, "name": "var-lib-containers.mount" } ] } nodeNetwork: interfaces: - name: eno1 macAddress: "AA:BB:CC:DD:EE:11" config: interfaces: - name: eno1 type: ethernet state: up ipv4: enabled: false ipv6: enabled: true address: # For SNO sites with static IP addresses, ノード固有、# API、および Ingress IP はすべて同じであり、# インターフェイス(ip: 1111:2222:3333:4444::aaaa:1 prefix-length: 64 dns-resolver: config: search: - example.com server: - 1111:2222:3333:4444::2 routes: config)で同一である必要があります。- destination: ::/0 next-hop-interface: eno1 next-hop-address: 1111:2222:3333:4444::1 table-id: 254

        注記

        BMC アドレッシングの詳細は、「関連情報」セクションを参照してください。この例では、読みやすくするために、installConfigOverrides フィールドと ignitionConfigOverride フィールドが展開されています。

     3. out/argocd/extra-manifest で extra-manifest MachineConfig CR のデフォルトセットを検査できます。これは、インストール時にクラスターに自動的に適用されます。
     4. オプション: プロビジョニングされたクラスターに追加のインストール時マニフェストをプロビジョニングするには、Git リポジトリーに sno-extra-manifest/ などのディレクトリーを作成し、このディレクトリーにカスタムマニフェストの CR を追加します。SiteConfig.yaml が extraManifestPath フィールドでこのディレクトリーを参照する場合、この参照ディレクトリーの CR はすべて、デフォルトの追加マニフェスト セットに追加されます。
  4. out/argocd/example/siteconfig/kustomization.yaml に示す例のように、generators セクションの kustomization.yaml ファイルに SiteConfig CR を追加してください。

  5. SiteConfig CR と関連する kustomization.yaml の変更を Git リポジトリーにコミットし、変更をプッシュします。

     ArgoCD パイプラインが変更を検出し、マネージドクラスターのデプロイを開始します。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。

前提条件

• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてハブクラスターにログインしている。