Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

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

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

ハブクラスターは 他 のハブクラスターの管理はできず、自己管理のみが可能です。ハブクラスターは、自動的にインポートして自己管理できるように設定されています。ハブクラスターは手動でインポートする必要はありません。

ただし、ハブクラスターを削除して、もう一度インポートする場合は、local-cluster:true ラベルを追加する必要があります。

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

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

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

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

9.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 コマンドラインツールが必要である。

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

9.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 をクリックして、このプロセスを繰り返します。

9.1.2.1. YAML パラメーターおよび説明
リンクのコピー

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

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

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

9.1.3. インポートされたクラスターの削除
リンクのコピー

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

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

注記: local-cluster という名前のハブクラスターをデタッチしようとする場合には、デフォルトの disableHubSelfManagement 設定が false である点に注意してください。この設定が原因で、ハブクラスターはデタッチされると、自身を再インポートして管理し、MultiClusterHub コントローラーが調整されます。ハブクラスターがデタッチプロセスを完了して再インポートするのに時間がかかる場合があります。プロセスが終了するのを待たずにハブクラスターを再インポートする場合には、以下のコマンドを実行して multiclusterhub-operator Pod を再起動して、再インポートの時間を短縮できます。 

oc delete po -n open-cluster-management `oc get pod -n open-cluster-management | grep multiclusterhub-operator| cut -d' ' -f1`

「ネットワーク接続時のオンラインインストール」で説明されているように、disableHubSelfManagement の値を true に指定して、自動的にインポートされないように、ハブクラスターの値を変更できます。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る