第8章 ハブクラスターへのターゲットのマネージドクラスターのインポート

別の Kubernetes クラウドプロバイダーからクラスターをインポートできます。インポートすると、ターゲットクラスターは Red Hat Advanced Cluster Management for Kubernetes ハブクラスターのマネージドクラスターになります。指定されていない場合には、ハブクラスターとターゲットのマネージドクラスターにアクセスできる場所で、インポートタスクを実行します。

注記

ハブクラスターは、他のハブクラスターを管理 できない ので、既存のクラスターをインポートする必要があります。

コンソールまたは CLI からのマネージドクラスターの設定は、以下の手順から選択します。

必要なユーザータイプまたはアクセスレベル: クラスター管理者

8.1. コンソールを使用した既存クラスターのインポート

Red Hat Advanced Cluster Management for Kubernetes をインストールすると、管理するクラスターをインポートする準備が整います。コンソールと CLI の両方からインポートできます。コンソールからインポートするには、以下の手順に従います。この手順では、認証用にターミナルが必要です。

8.1.1. 前提条件

  • Red Hat Advanced Cluster Management for Kubernetes のハブクラスターをデプロイしておく必要がある。ベアメタルクラスターをインポートする場合には、ハブクラスターを Red Hat OpenShift Container Platform バージョン 4.4 以降にインストールする必要があります。
  • 管理するクラスターとインターネット接続が必要である。
  • kubectl をインストールしておく必要がある。kubectlのインストール手順は、 Kubernetes ドキュメント の Install and Set Up kubectl を参照してください。
  • Base64 コマンドラインツールが必要である。

必要なユーザータイプまたはアクセスレベル: クラスター管理者

8.1.2. クラスターのインポート

利用可能なクラウドプロバイダーごとに、Red Hat Advanced Cluster Management for Kubernetes コンソールから既存のクラスターをインポートできます。

注記

ハブクラスターは、他のハブクラスターを管理 できない ので、既存のクラスターをインポートする必要があります。

  1. ナビゲーションメニューで Automate infrastructure にマウスをかざし、Clusters をクリックします。
  2. Add cluster をクリックします。
  3. Import an existing cluster をクリックします。
  4. クラスター名を指定します。デフォルトで、namespace はクラスター名と同じ値に設定されます。ベストプラクティス: namespace の値はそのままにして、編集しないでください。

  5. オプション: クリックして Edit cluster import YAML file を展開し、エンドポイント設定を変更します。

    各パラメーターの詳細は、 表 1 YAML ファイルパラメーターおよび説明 を参照してください。

  6. オプション: インポート後に、Configure advanced parameters をクリックしてラベルを追加し、検索時にこのラベルを使用します。

  7. オプション: MANAGED CLUSTER URLS を設定します。MANAGED CLUSTER URLS を設定すると、oc get managedcluster コマンドを実行時に、この URL がテーブルに表示されます。

    1. までオンになっていない場合には、Web コンソールのスイッチを使用して YAML コンテンツをオンにし、コンテンツを表示できるようにします。

    2. 以下の例のように、import.yaml ファイルの ManagedCluster 仕様に manageClusterClientConfigs のセクションを追加します。 

      apiVersion: cluster.open-cluster-management.io/v1
kind: ManagedCluster
metadata:
  labels:
    cloud: auto-detect
	vendor: auto-detect
	name: cluster-test
  name: cluster-test
spec:
  hubAcceptsClient: true
  managedClusterClientConfigs:
  - url: https://multicloud-console.apps.new-managed.dev.redhat.com
---
apiVersion: agent.open-cluster-management.io/v1
...

      URL の値は、マネージドクラスターの外部アクセス URL アドレスに置き換えます。

  8. Generate Command をクリックし、コマンドを取得して、open-cluster-management-agent-addon をデプロイします。
  9. Import an existing cluster ウィンドウで Copy command アイコンにマウスをかざしてクリックし、インポートコマンドと指定のトークンをコピーします。適切なコピーを取得するには、Copy アイコンをクリックする必要があります。重要: コマンドには、インポートした各クラスターにコピーされるプルシークレット情報が含まれます。インポートしたクラスターにアクセスできるユーザーであれば誰でも、プルシークレット情報を表示できます。https://cloud.redhat.com/ で 2 つ目のプルシークレットを作成するか、サービスアカウントを作成して、個人の認証情報が不正アクセスされないようにします。詳細は、「イメージプルシークレットの使用」または「サービスアカウントの概要および作成」を参照してください。

  10. ターミナルから、マネージドクラスターへの認証を行います。ターゲットのマネージドクラスターの kubectl を設定します。

    kubectl の設定方法は、サポート対象のクラウド を参照してください。

  11. マネージドクラスターに open-cluster-management-agent-addon をデプロイするには、手順 8 で生成してコピーしたコマンドを実行します。
  12. View cluster をクリックして Overview ページのクラスターの概要を表示します。

注記 続けて他のクラスターもインポートできます。Import another をクリックして、このプロセスを繰り返します。

8.1.2.1. YAML パラメーターおよび説明

表 1: YAML ファイルで利用可能なパラメーターおよび説明を以下の表に示します。

パラメーター説明デフォルト値

clusterLabels

クラスターラベルを指定します。ラベルをファイルに追加できます。

なし

clusterLabels.cloud

クラスターのプロバイダーラベル

auto-detect

clusterLabels.vendor

クラスターの Kubernetes ベンダーラベル

auto-detect

clusterLabels.environment

クラスターの環境ラベル

なし

clusterLabels.region

クラスターが設定されているリージョン

なし

applicationManager.enabled

マルチクラスターマネージャーのアプリケーションデプロイメントを有効化して、サブスクリプションコントローラーと deployable コントローラーをデプロイします。

true

searchCollector.enabled

検索コレクションおよびインデックス化を有効にします。

true

policyController.enabled

ガバナンスおよびリスクダッシュボードのポリシー機能を有効にします。

true、updateInterval: 15

certPolicyController.enabled

分散ポリシーに基づいて証明書の有効期限を監視します

true

iamPolicyController

分散ポリシーに基づくアイデンティティー管理を監視します

true

serviceRegistry.enabled

アプリケーションの deployable によりマネージドクラスター全体にデプロイされたサービスを検出するのに使用するサービスレジストリー。

false

serviceRegistry.dnsSuffix

レジストリーの DNS 名のサフィックス。これは、ターゲットクラスターの DNS ドメイン名の末尾に追加されます。

mcm.svc

serviceRegistry.plugins

有効化したプラグインのコンマ区切りの一覧。サポートされるプラグイン: kube-service, kube-ingress および istio

kube-service

version

open-cluster-management-agent-addon のバージョン

2.0

8.1.3. インポートされたクラスターの削除

以下の手順を実行して、インポートされたクラスターと、マネージドクラスターで作成された open-cluster-management-agent-addon を削除します。

  1. Clusters ページの表から、インポートされたクラスターを見つけます。
  2. Options > Detach cluster をクリックしてマネージメントからクラスターを削除します。