マルチクラスターエンジン
マルチクラスターエンジンオペレーターの使用方法
概要
第1章 要件および推奨事項 リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes Operator のマルチクラスターエンジンをインストールする前に、次のシステム設定要件と設定を確認してください。
重要: 2.5 より前の Red Hat Advanced Cluster Management for Kubernetes がインストールされていないクラスターには、Kubernetes 用のマルチクラスターエンジンをインストールする必要があります。Kubernetes のマルチクラスターエンジンは、同じ管理コンポーネントの一部を提供するため、2.5 より前のバージョンでは Red Hat Advanced Cluster Management for Kubernetes と共存できません。これまで Red Hat をインストールしたことがないクラスターに Kubernetes 用のマルチクラスターエンジンをインストールすることをお勧めします。バージョン 2.5.0 以降で Red Hat Advanced Cluster Management for Kubernetes を使用している場合、Kubernetes 用のマルチクラスターエンジンは既にクラスターにインストールされています。
1.1. Kubernetes クラスターおよびマネージドクラスターのマルチクラスターエンジンでサポートされているオペレーティングシステムとプラットフォーム リンクのコピーリンクがクリップボードにコピーされました!
サポート対象のオペレーティングシステムについては、以下の表を参照してください。
プラットフォーム | Kubernetes クラスターのマルチクラスターエンジンでサポート | マネージドクラスターでサポート |
Red Hat OpenShift Container Platform 3.11.200 および 3.11.x 以降のリリース | ❌ | ◯ |
Red Hat OpenShift Container Platform 4.8.2 以降 | ◯ | ◯ |
Red Hat OpenShift Container Platform on Amazon Web Services | ◯ | ◯ |
Red Hat OpenShift Container Platform on Microsoft Azure | ◯ | ◯ |
Red Hat OpenShift Container Platform on Google Cloud Platform | ◯ | ◯ |
Red Hat OpenShift Kubernetes Engine | ❌ | ◯ |
Google Kubernetes Engine (Google GKE) (Kubernetes 1.17 以降) | ❌ | ◯ |
Amazon Elastic Kubernetes Service (Amazon EKS) (Kubernetes 1.17.6 以降) | ❌ | ◯ |
Microsoft Azure Kubernetes Service (Microsoft AKS) (Kubernetes 1.19.6 以降) | ❌ | ◯ |
1.2. ネットワーク設定 リンクのコピーリンクがクリップボードにコピーされました!
以下のセクションで接続を許可するようにネットワークを設定します。
1.2.1. Kubernetes Operator クラスターネットワーク要件用のマルチクラスターエンジン リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes クラスターネットワーク要件のマルチクラスターエンジンについては、次の表を参照してください。
方向 | 接続 | ポート (指定されている場合) |
---|---|---|
送信 | クラウドプロバイダーの API | |
Outbound | プロビジョニングしたマネージドクラスターの Kubernetes API サーバー | 6443 |
送信および受信 |
マネージドクラスターの | 443 |
受信 | マネージドクラスターからの Kubernetes クラスター用のマルチクラスターエンジンの Kubernetes API サーバー | 6443 |
受信 | GitHub から Kubernetes クラスターのマルチクラスターエンジンへのコミット後のフック。この設定は、特定のアプリケーション管理機能を使用する場合にのみ必要です。 | 6443 |
1.2.2. マネージドクラスターネットワークの要件 リンクのコピーリンクがクリップボードにコピーされました!
マネージドクラスターネットワークの要件については、以下の表を参照してください。
方向 | 接続 | ポート (指定されている場合) |
---|---|---|
送信および受信 | Kubernetes クラスター用のマルチクラスターエンジンの Kubernetes API サーバー | 6443 |
1.2.3. ホステッドコントロールプレーンのネットワーク要件 (テクノロジープレビュー) リンクのコピーリンクがクリップボードにコピーされました!
ホステッドコントロールプレーンを使用する場合、HypershiftDeployment
リソースには、次の表に示すエンドポイントへの接続が必要です。
方向 | 接続 | ポート (指定されている場合) |
---|---|---|
Outbound | OpenShift Container Platform コントロールプレーンおよびワーカーノード | |
Outbound | Amazon Web Services のホストされたクラスターのみ: AWS API および S3 API へのアウトバウンド接続 | |
Outbound | Microsoft Azure クラウドサービスのホストされたクラスターのみ: Azure API へのアウトバウンド接続 | |
Outbound | coreOS の ISO イメージと OpenShift Container Platform Pod のイメージレジストリーを格納する OpenShift Container Platform イメージリポジトリー |
第2章 スタートガイド リンクのコピーリンクがクリップボードにコピーされました!
2.1. はじめに リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes Operator のマルチクラスターエンジンをインストールする前に、要件および推奨事項 でシステム設定の要件と設定を確認してください。クラスターにサポート対象の OpenShift Container Platform がインストールされ、稼働している場合には、ネットワーク接続時のオンラインインストール に進んでください。
2.2. クラスターの作成と管理 リンクのコピーリンクがクリップボードにコピーされました!
インストールすると、クラスターを作成、インポート、および管理する準備が整います。Kubernetes クラスター用のマルチクラスターエンジンから、管理する他の OpenShift Container Platform クラスターを作成できます。
- 作成可能なマネージドクラスターの種類については、クラスターの作成 を参照してください。
- 手動でインポートするクラスターがある場合は、クラスターのインポート を参照して、マネージドクラスターのインポート方法を確認してください。
- クラスターを管理する必要がなくなったときに マネージドクラスターのデタッチ を表示できます。
2.3. ManifestWork の例 リンクのコピーリンクがクリップボードにコピーされました!
プロセスと例は ManifestWork を使用したワークロードのデプロイ で確認できます。
第3章 ネットワーク接続時のオンラインインストール リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes オペレーター用のマルチクラスターエンジンは、Operator Lifecycle Manager とともにインストールされます。このマネージャーは、Kubernetes エンジン用のマルチクラスターエンジンを含むコンポーネントのインストール、アップグレード、および削除を管理します。
必要なアクセス権限: クラスターの管理者
重要:
- 2.5 より前の Red Hat Advanced Cluster Management for Kubernetes がインストールされていないクラスターに Kubernetes 用のマルチクラスターエンジンをインストールする必要があります。Kubernetes のマルチクラスターエンジンは、同じ管理コンポーネントの一部を提供するため、2.5 より前のバージョンでは Red Hat Advanced Cluster Management for Kubernetes と共存できません。これまで Red Hat をインストールしたことがないクラスターに Kubernetes 用のマルチクラスターエンジンをインストールすることをお勧めします。バージョン 2.5.0 以降で Red Hat Advanced Cluster Management for Kubernetes を使用している場合、Kubernetes 用のマルチクラスターエンジンは既にクラスターにインストールされています。
-
OpenShift Container Platform 専用環境の場合は、
cluster-admin
権限が必要です。デフォルトで、dedicated-admin
ロールには OpenShift Container Platform Dedicated 環境で namespace を作成するために必要なパーミッションがありません。 - デフォルトでは、エンジンコンポーネントは追加設定なしで OpenShift Container Platform クラスターのワーカーノードにインストールされます。OpenShift Container Platform OperatorHub Web コンソールインターフェイスを使用するか、OpenShift Container Platform CLI を使用してエンジンをワーカーノードにインストールできます。
- OpenShift Container Platform クラスターをインフラストラクチャーノードで設定している場合は、追加のリソースパラメーターを使用して、OpenShift Container Platform CLI を使用してエンジンをそれらのインフラストラクチャーノードにインストールできます。すべてのエンジンコンポーネントがインフラストラクチャーノードをサポートしているわけではないため、インフラストラクチャーノードに Kubernetes 用のマルチクラスターエンジンをインストールする場合でも、一部のワーカーノードが必要です。詳細は、インフラストラクチャーノードの Kubernetes エンジン用にマルチクラスターエンジンのインストール セクションを参照してください。
OpenShift Container Platform または Kubernetes のマルチクラスターエンジンによって作成されていない Kubernetes クラスターをインポートする場合は、イメージプルシークレットを設定する必要があります。イメージプルシークレットおよびその他の高度な設定方法については、このドキュメントの 詳細設定 セクションのオプションを参照してください。
3.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes 用のマルチクラスターエンジンをインストールする前に、次の要件を確認してください。
- RedHat OpenShift Container Platform クラスターは、OpenShift Container Platform コンソールから OperatorHub カタログにある Kubernetes Operator のマルチクラスターエンジンにアクセスできるようにしている。
- catalog.redhat.com へのアクセスがある。
お使いの環境に OpenShift Container Platform バージョン 4.8 以降をデプロイし、OpenShift Container Platform CLI でログインしている。以下の OpenShift Container Platform のインストールドキュメントを参照してください。
-
OpenShift Container Platform のコマンドラインインターフェイス (CLI) は、
oc
コマンドを実行できるように設定している。Red Hat OpenShift CLI のインストールおよび設定の詳細は、CLI の使用方法 を参照してください。 - namespace の作成が可能な OpenShift Container Platform の権限を設定している。
- operator の依存関係にアクセスするには、インターネット接続が必要。
OpenShift Container Platform Dedicated 環境にインストールするには、以下を参照してください。
- OpenShift Container Platform Dedicated 環境が設定され、実行している。
-
エンジンのインストール先の OpenShift Container Platform Deplicated 環境での
cluster-admin
がある。
3.2. OpenShift Container Platform インストールの確認 リンクのコピーリンクがクリップボードにコピーされました!
レジストリー、ストレージサービスなど、サポート対象の OpenShift Container Platform バージョンがインストールされ、機能する状態である必要があります。OpenShift Container Platform のインストールの詳細は、OpenShift Container Platform のドキュメントを参照してください。
- Kubernetes エンジンオペレーター用のマルチクラスターエンジンが OpenShift Container Platform クラスターにまだインストールされていないことを確認します。Kubernetes オペレーター用のマルチクラスターエンジンでは、OpenShift Container Platform クラスターごとに 1 つのインストールのみが許可されます。インストールがない場合は、次の手順に進みます。
OpenShift Container Platform クラスターが正しく設定されていることを確認するには、以下のコマンドを使用して OpenShift Container Platform Web コンソールにアクセスします。
kubectl -n openshift-console get route
kubectl -n openshift-console get route
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下の出力例を参照してください。
openshift-console console console-openshift-console.apps.new-coral.purple-chesterfield.com console https reencrypt/Redirect None
openshift-console console console-openshift-console.apps.new-coral.purple-chesterfield.com console https reencrypt/Redirect None
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
ブラウザーで URL を開き、結果を確認します。コンソール URL の表示が
console-openshift-console.router.default.svc.cluster.local
の場合は、Red Hat OpenShift Container Platform のインストール時にopenshift_master_default_subdomain
を設定します。https://console-openshift-console.apps.new-coral.purple-chesterfield.com
の例を参照してください。
Kubernetes 用のマルチクラスターエンジンのインストールに進むことができます。
3.3. OperatorHub Web コンソールインターフェイスからのインストール リンクのコピーリンクがクリップボードにコピーされました!
ベストプラクティス: OpenShift Container Platform ナビゲーションの Administrator ビューから、OpenShift Container Platform で提供される OperatorHub Web コンソールインターフェイスをインストールします。
- Operators > OperatorHub を選択して利用可能な operator のリストにアクセスし、multicluster engine for Kubernetes operator を選択します。
-
Install
をクリックします。 Operator Installation ページで、インストールのオプションを選択します。
Namespace:
- Kubernetes エンジンのマルチクラスターエンジンは、独自の namespace またはプロジェクトにインストールする必要があります。
-
デフォルトでは、OperatorHub コンソールのインストールプロセスにより、
multicluster-engine
という名前の namespace が作成されます。ベストプラクティス:multicluster-engine
namespace が使用可能な場合は、引き続き使用します。 -
multicluster-engine
という名前の namespace がすでに存在する場合は、別の namespace を選択してください。
- チャネル: インストールするリリースに対応するチャネルを選択します。チャネルを選択すると、指定のリリースがインストールされ、そのリリース内の今後のエラータ更新が取得されます。
承認ストラテジー: 承認ストラテジーでは、サブスクライブ先のチャネルまたはリリースに更新を適用するのに必要な人の間のやり取りを特定します。
- そのリリース内の更新が自動的に適用されるようにするには、デフォルトで選択されている Automatic を選択します。
- Manual を選択して、更新が利用可能になると通知を受け取ります。更新がいつ適用されるかについて懸念がある場合は、これがベストプラクティスになる可能性があります。
注記: 次のマイナーリリースにアップグレードするには、OperatorHub ページに戻り、最新リリースの新規チャネルを選択する必要があります。
- Install を選択して変更を適用し、Operator を作成します。
MultiClusterEngine カスタムリソースを作成するには、次のプロセスを参照してください。
- OpenShift Container Platform コンソールナビゲーションで、Installed Operators > multicluster engine for Kubernetes を選択します。
- MultiCluster Engine タブを選択します。
- Create MultiClusterEngine を選択します。
YAML ファイルのデフォルト値を更新します。このドキュメントの MultiClusterEngine advanced configuration のオプションを参照してください。
- 次の例は、エディターにコピーできるデフォルトのテンプレートを示しています。
apiVersion: multicluster.openshift.io/v1 kind: MultiClusterEngine metadata: name: multiclusterengine spec: {}
apiVersion: multicluster.openshift.io/v1 kind: MultiClusterEngine metadata: name: multiclusterengine spec: {}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Create を選択して、カスタムリソースを初期化します。Kubernetes エンジンのマルチクラスターエンジンがビルドされて起動するまで、最大 10 分かかる場合があります。
MultiClusterEngine リソースが作成されると、リソースのステータスが MultiCluster Engine タブで
Available
になります。
3.4. OpenShift Container Platform CLI からのインストール リンクのコピーリンクがクリップボードにコピーされました!
Operator 要件が含まれている Kubernetes エンジン namespace 用のマルチクラスターエンジンを作成します。次のコマンドを実行します。ここで、
namespace
は、Kubernetes エンジン namespace のマルチクラスターエンジンの名前です。namespace
の値は、OpenShift Container Platform 環境では プロジェクト と呼ばれる場合があります。oc create namespace <namespace>
oc create namespace <namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow プロジェクトの namespace を、作成した namespace に切り替えます。
namespace
は、手順 1 で作成した Kubernetes エンジン用のマルチクラスターエンジンの namespace の名前に置き換えてください。oc project <namespace>
oc project <namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OperatorGroup
リソースを設定するために YAML ファイルを作成します。namespace ごとに割り当てることができる Operator グループ は 1 つだけです。default
はお使いの operator グループ名に置き換えます。namespace
はお使いのプロジェクトの namespace 名に置き換えます。以下の例を参照してください。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して
OperatorGroup
リソースを作成します。operator-group
は、作成した operator グループの YAML ファイル名に置き換えます。oc apply -f <path-to-file>/<operator-group>.yaml
oc apply -f <path-to-file>/<operator-group>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Container Platform サブスクリプションを設定するための YAML ファイルを作成します。ファイルは以下の例のようになります。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: インフラストラクチャーノードに Kubernetes エンジン用のマルチクラスターエンジンをインストールする場合は、Operator Lifecycle Manager サブスクリプションの追加設定 セクションを参照してください。
以下のコマンドを実行して OpenShift Container Platform サブスクリプションを作成します。
subscription
は、作成したサブスクリプションファイル名に置き換えます。oc apply -f <path-to-file>/<subscription>.yaml
oc apply -f <path-to-file>/<subscription>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow YAML ファイルを作成して、
MultiClusterEngine
カスタムリソースを設定します。デフォルトのテンプレートは、以下の例のようになります。apiVersion: multicluster.openshift.io/v1 kind: MultiClusterEngine metadata: name: multiclusterengine spec: {}
apiVersion: multicluster.openshift.io/v1 kind: MultiClusterEngine metadata: name: multiclusterengine spec: {}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: インフラストラクチャーノードに Kubernetes エンジン用のマルチクラスターエンジンをインストールする方法については、MultiClusterEngine カスタムリソースの追加設定 セクションを参照してください。
次のコマンドを実行して、
MultiClusterEngine
カスタムリソースを作成します。custom-resource
は、カスタムリソースファイル名に置き換えます。oc apply -f <path-to-file>/<custom-resource>.yaml
oc apply -f <path-to-file>/<custom-resource>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のエラーで、この手順に失敗した場合でも、リソースは作成され、適用されます。リソースが作成されてから数分後にもう一度コマンドを実行します。
error: unable to recognize "./mce.yaml": no matches for kind "MultiClusterEngine" in version "operator.multicluster-engine.io/v1"
error: unable to recognize "./mce.yaml": no matches for kind "MultiClusterEngine" in version "operator.multicluster-engine.io/v1"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行してカスタムリソースを編集します。次のコマンドを実行した後、
MultiClusterEngine
カスタムリソースステータスがstatus.phase
フィールドにAvailable
として表示されるまでに最大 10 分かかる場合があります。oc get mce -o=jsonpath='{.items[0].status.phase}'
oc get mce -o=jsonpath='{.items[0].status.phase}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Kubernetes operator 用のマルチクラスターエンジンを再インストールしても Pod が起動しない場合は、この問題を回避する手順について、再インストールに失敗する場合のトラブルシューティング を参照してください。
注記:
-
ClusterRoleBinding
を使用するServiceAccount
は、クラスター管理者特権を Kubernetes のマルチクラスターエンジンと、Kubernetes のマルチクラスターエンジンをインストールする namespace にアクセスできるすべてのユーザー認証情報に自動的に付与します。
3.5. インフラストラクチャーノードへのインストール リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform クラスターを、承認された管理コンポーネントを実行するためのインフラストラクチャーノードを組み込むように設定できます。インフラストラクチャーノードでコンポーネントを実行すると、それらの管理コンポーネントを実行しているノードの OpenShift Container Platform サブスクリプションクォータの割り当てる必要がなくなります。
OpenShift Container Platform クラスターにインフラストラクチャーノードを追加した後に、OpenShift Container Platform CLI からのインストール 手順に従い、以下の設定を Operator Lifecycle Manager サブスクリプションおよび MultiClusterEngine
カスタムリソースに追加します。
3.5.1. インフラストラクチャーノードを OpenShift Container Platform クラスターに追加する リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform ドキュメントの インフラストラクチャーマシンセットの作成 で説明されている手順に従います。インフラストラクチャーノードは、Kubernetes の taint
および label
で設定され、管理以外のワークロードがそれらで稼働し続けます。
Kubernetes のマルチクラスターエンジンによって提供されるインフラストラクチャーノードの有効化と互換性を持たせるには、インフラストラクチャーノードに次の taint
と label
が適用されていることを確認してください。
3.5.2. Operator Lifecycle Manager サブスクリプションの追加設定 リンクのコピーリンクがクリップボードにコピーされました!
Operator Lifecycle Manager サブスクリプションを適用する前に、以下の追加設定を追加します。
3.5.3. MultiClusterEngine カスタムリソースの追加設定 リンクのコピーリンクがクリップボードにコピーされました!
MultiClusterEngine
カスタムリソースを適用する前に、以下の設定を追加します。
spec: nodeSelector: node-role.kubernetes.io/infra: ""
spec:
nodeSelector:
node-role.kubernetes.io/infra: ""
第4章 ネットワーク切断状態でのインストール リンクのコピーリンクがクリップボードにコピーされました!
インターネットに接続されていない Red Hat OpenShift Container Platform クラスターにマルチクラスターエンジン Operator をインストールする必要がある場合があります。ネットワーク接続のないエンジンにインストールする手順でも一部、オンラインインストールと同じ手順が必要になります。
重要: 2.5 より前の Red Hat Advanced Cluster Management for Kubernetes がインストールされていないクラスターには、Kubernetes 用のマルチクラスターエンジンをインストールする必要があります。Kubernetes のマルチクラスターエンジンは、同じ管理コンポーネントの一部を提供するため、2.5 より前のバージョンでは Red Hat Advanced Cluster Management for Kubernetes と共存できません。これまで Red Hat をインストールしたことがないクラスターに Kubernetes 用のマルチクラスターエンジンをインストールすることをお勧めします。バージョン 2.5.0 以降で Red Hat Advanced Cluster Management for Kubernetes を使用している場合、Kubernetes 用のマルチクラスターエンジンは既にクラスターにインストールされています。
インストール時にネットワークから直接パッケージにアクセスするのではなく、パッケージをダウンロードしておき、インストール時にアクセスできるようにする必要があります。
4.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
マルチクラスターエンジン Operator をインストールする前に、次の要件を満たしている必要があります。
- お使いの環境に Red Hat OpenShift Container Platform バージョン 4.8 以降をインストールし、コマンドラインインターフェイス (CLI) でログインしている。
catalog.redhat.com へのアクセスがある。
注記: ベアメタルクラスターを管理する場合は、Red Hat OpenShift Container Platform バージョン 4.8 以降が必要です。
OpenShift Container Platform version 4.10、OpenShift Container Platform version 4.8 を参照してください。
-
Red Hat OpenShift Container Platform の CLI バージョンは 4.8 以降を使用し、
oc
コマンドを実行できるように設定している。Red Hat OpenShift CLI のインストールおよび設定の詳細は、CLI の使用方法 を参照してください。 - namespace の作成が可能な Red Hat OpenShift Container Platform の権限を設定している。
- Operator の依存関係をダウンロードするために、インターネット接続のあるワークステーションが必要。
4.2. OpenShift Container Platform インストールの確認 リンクのコピーリンクがクリップボードにコピーされました!
- レジストリー、ストレージサービスなど、サポート対象の OpenShift Container Platform バージョンがクラスターにインストールされ、機能する状態である必要があります。OpenShift Container Platform バージョン 4.8 の詳細は、OpenShift Container Platform documentation を参照してください。
接続されている場合には、OpenShift Container Platform クラスターが正しく設定されていることを確認できます。OpenShift Container Platform Web コンソールにアクセスします。
kubectl -n openshift-console get route
コマンドを実行して、OpenShift Container Platform の Web コンソールにアクセスします。以下の出力例を参照してください。openshift-console console console-openshift-console.apps.new-coral.purple-chesterfield.com console https reencrypt/Redirect None
openshift-console console console-openshift-console.apps.new-coral.purple-chesterfield.com console https reencrypt/Redirect None
Copy to Clipboard Copied! Toggle word wrap Toggle overflow この例のコンソール URL は
https:// console-openshift-console.apps.new-coral.purple-chesterfield.com
です。ブラウザーで URL を開き、結果を確認します。コンソール URL の表示が
console-openshift-console.router.default.svc.cluster.local
の場合は、Red Hat OpenShift Container Platform のインストール時にopenshift_master_default_subdomain
を設定します。
4.3. 非接続環境でのインストール リンクのコピーリンクがクリップボードにコピーされました!
重要: 必要なイメージをミラーリングレジストリーにダウンロードし、非接続環境で Operator をインストールする必要があります。ダウンロードがないと、デプロイメント時に ImagePullBackOff
エラーが表示される可能性があります。
次の手順に従って、切断された環境に Kubernetes Operator 用のマルチクラスターエンジンをインストールします。
ミラーレジストリーを作成します。ミラーレジストリーがない場合は、Red Hat OpenShift Container Platform ドキュメントの 非接続インストールのイメージのミラーリング の手順を実行してミラーレジストリーを作成してください。
ミラーレジストリーがすでにある場合は、既存のレジストリーを設定して使用できます。
注記: ベアメタルの場合のみ、
install-config.yaml
ファイルに、接続なしのレジストリーの証明書情報を指定する必要があります。保護された切断されたレジストリー内のイメージにアクセスするには、Kubernetes Operator のマルチクラスターエンジンがレジストリーにアクセスできるように、証明書情報を提供する必要があります。- レジストリーから証明書情報をコピーします。
-
エディターで
install-config.yaml
ファイルを開きます。 -
additionalTrustBundle: |
のエントリーを検索します。 additionalTrustBundle
の行の後に証明書情報を追加します。追加後の内容は以下の例のようになります。additionalTrustBundle: | -----BEGIN CERTIFICATE----- certificate_content -----END CERTIFICATE----- sshKey: >-
additionalTrustBundle: | -----BEGIN CERTIFICATE----- certificate_content -----END CERTIFICATE----- sshKey: >-
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
重要: 以下のガバナンスポリシーが必要な場合は、非接続イメージレジストリーの追加ミラーが必要です。
-
Container Security Operator ポリシー: イメージはソース
registry.redhat.io/quay
にあります。 -
Compliance Operator ポリシー: イメージはソース
registry.redhat.io/compliance
にあります。 Gatekeeper Operator ポリシー: イメージはソース
registry.redhat.io/rhacm2
にあります。3 つのすべての Operator については、以下のミラー一覧を参照してください。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
Container Security Operator ポリシー: イメージはソース
-
install-config.yaml
ファイルを保存します。 rhacm-policy.yaml
という名前のImageContentSourcePolicy
を含めて yaml ファイルを作成します。注記: 実行中のクラスターでこれを変更すると、すべてのノードのローリング再起動が実行されます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを入力して ImageContentSourcePolicy ファイルを適用します。
oc apply -f mce-policy.yaml
oc apply -f mce-policy.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ネットワーク接続されていない Operator Lifecycle Manager の Red Hat Operator と コミュニティーの Operator を有効にします。
Kubernetes Operator 用のマルチクラスターエンジンは、Operator Lifecycle Manager Red Hat カタログに含まれています。
- Red Hat Operator カタログの非接続 Operator Lifecycle Manager を設定します。Red Hat OpenShift Container Platform ドキュメントの ネットワークが制限された環境での Operator Lifecycle Manager の使用 の手順を実行します。
- 切断された Operator Lifecycle Manager にイメージが作成されたので、引き続き、Operator Lifecycle Manager カタログから Kubernetes 用の Kubernetes オペレーター用のマルチクラスターエンジンをインストールします。
必要な手順については、ネットワーク接続時のオンラインインストール の手順を参照してください。
第5章 コンソールの概要 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform コンソールプラグインは OpenShift Container Platform 4.10 Web コンソールで利用可能であり、統合することができます。この機能を使用するには、コンソールプラグインを有効にしておく必要があります。マルチクラスターエンジンの Operator は、Infrastructure および Credentials のナビゲーション項目から特定のコンソール機能を表示します。Red Hat Advanced Cluster Management をインストールすると、より多くのコンソール機能が表示されます。
注記:プラグインが有効になっている OpenShift Container Platform 4.10 の場合は、ドロップダウンメニューから All Clusters を選択することにより、クラスタースイッチャーから OpenShift Container Platform コンソール内で Red Hat Advanced Cluster Management にアクセスできます。
- プラグインを無効にするには、OpenShift Container Platform コンソールの Administrator パースペクティブにいることを確認してください。
- ナビゲーションで Administration を探し、Cluster Settings をクリックし、続いて Configuration タブをクリックします。
-
Configuration resources のリストから、
operator.openshift.io
API グループが含まれる Console リソースをクリックします。この API グループには、Web コンソールのクラスター全体の設定が含まれています。 -
Console plug-ins タブをクリックします。
mce
プラグインが一覧表示されます。注記: Red Hat Advanced Cluster Management がインストールされている場合は、acm
としても表示されます。 - テーブルからプラグインのステータスを変更します。しばらくすると、コンソールを更新するように求められます。
第6章 詳細設定 リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes Operator のマルチクラスターエンジンは、必要なすべてのコンポーネントをデプロイする Operator を使用してインストールされます。Kubernetes Operator のマルチクラスターエンジンは、インストール中またはインストール後に、MultiClusterEngine
カスタムリソースに次の属性の 1 つ以上を追加することでさらに設定できます。
6.1. カスタムイメージプルシークレット リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Container Platform または Kubernetes Operator 用のマルチクラスターエンジンによって作成されていない Kubernetes クラスターをインポートする場合は、OpenShift Container Platform プルシークレット情報を含むシークレットを生成して、ディストリビューションレジストリーから資格のあるコンテンツにアクセスします。
OpenShift Container Platform クラスターのシークレット要件は、OpenShift Container Platform および multicluster engine for Kubernetes により自動で解決されるため、他のタイプの Kubernetes クラスターをインポートして管理しない場合には、このシークレットを作成する必要はありません。
重要: これらのシークレットは namespace に依存するため、エンジンに使用する namespace にいることを確認してください。
- cloud.redhat.com/openshift/install/pull-secret から Download pull secret を選択して、OpenShift Container Platform のプルシークレットファイルをダウンロードします。OpenShift Container Platform プルシークレットは Red Hat カスタマーポータル ID に関連しており、すべての Kubernetes プロバイダーで同じです。
以下のコマンドを実行してシークレットを作成します。
oc create secret generic <secret> -n <namespace> --from-file=.dockerconfigjson=<path-to-pull-secret> --type=kubernetes.io/dockerconfigjson
oc create secret generic <secret> -n <namespace> --from-file=.dockerconfigjson=<path-to-pull-secret> --type=kubernetes.io/dockerconfigjson
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
secret
は作成するシークレット名に置き換えます。 -
シークレットは namespace 固有であるため、
namespace
はプロジェクトの namespace に置き換えます。 -
path-to-pull-secret
はダウンロードした OpenShift Container Platform のプルシークレットへのパスに置き換えます。
-
以下の例では、カスタムプルシークレットを使用する場合に使用する spec.imagePullSecret
テンプレートを表示しています。secret
は、プルシークレット名に置き換えます。
6.2. ターゲット namespace リンクのコピーリンクがクリップボードにコピーされました!
MultiClusterEngine
カスタムリソースで場所を指定することにより、指定された namespace にオペランドをインストールできます。この namespace は、MultiClusterEngine
カスタムリソースの適用時に作成されます。
重要: ターゲット namespace が指定されていない場合、Operator は multicluster-engine
namespace にインストールし、MultiClusterEngine
カスタムリソース仕様で設定します。
次の例は、ターゲット namespace を指定するために使用できる spec.targetNamespace
テンプレートを示しています。target
を宛先 namespace の名前に置き換えます。注記: target
namespace を default
namespace にすることはできません。
6.3. availabilityConfig リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Advanced Cluster Management ハブクラスターには、High
と Basic
の 2 つのアイラビリティーがあります。デフォルトでは、ハブクラスターには High
の可用性があります。これにより、ハブクラスターコンポーネントに replicaCount
2
が提供されます。これにより、フェイルオーバー時のサポートが向上しますが、Basic
可用性よりも多くのリソースを消費します。これにより、コンポーネントには replicaCount
1
が提供されます。
以下の例は、Basic
の可用性のある spec.availabilityConfig
テンプレートを示しています。
6.4. nodeSelector リンクのコピーリンクがクリップボードにコピーされました!
MultiClusterEngine
でノードセレクターのセットを定義して、クラスター上の特定のノードにインストールできます。以下の例は、node-role.kubernetes.io/infra
ラベルの付いたノードに Red Hat Advanced Cluster Management Pod を割り当てる spec.nodeSelector
を示しています。
spec: nodeSelector: node-role.kubernetes.io/infra: ""
spec:
nodeSelector:
node-role.kubernetes.io/infra: ""
6.5. tolerations リンクのコピーリンクがクリップボードにコピーされました!
許容範囲のリストを定義して、MultiClusterEngine
がクラスターで定義された特定の taint を許容できるようにすることができます。以下の例は、node-role.kubernetes.io/infra
Taint に一致する spec.tolerations
を示しています。
spec: tolerations: - key: node-role.kubernetes.io/infra effect: NoSchedule operator: Exists
spec:
tolerations:
- key: node-role.kubernetes.io/infra
effect: NoSchedule
operator: Exists
以前の infra-node Toleration は、設定に Toleration を指定せずにデフォルトで Pod に設定されます。設定で許容値をカスタマイズすると、このデフォルトの動作が置き換えられます。
6.6. ManagedServiceAccount アドオン (テクノロジープレビュー) リンクのコピーリンクがクリップボードにコピーされました!
デフォルトでは、Managed-ServiceAccount
アドオンは無効になっています。このコンポーネントを有効にすると、マネージドクラスターでサービスアカウントを作成または削除できます。このアドオンを有効にしてインストールするには、spec.overrides
の MultiClusterEngine
仕様に以下を含めます。
Managed-ServiceAccount
アドオンは、MultiClusterEngine
の作成後に、コマンドラインでリソースを編集し、managedserviceaccount-preview
コンポーネントを enabled: true
に設定することで有効にできます。または、次のコマンドを実行して、<multiclusterengine-name> を MultiClusterEngine
リソースの名前に置き換えることもできます。
oc patch MultiClusterEngine <multiclusterengine-name> --type=json -p='[{"op": "add", "path": "/spec/overrides/components/-","value":{"name":"managedserviceaccount-preview","enabled":true}}]'
oc patch MultiClusterEngine <multiclusterengine-name> --type=json -p='[{"op": "add", "path": "/spec/overrides/components/-","value":{"name":"managedserviceaccount-preview","enabled":true}}]'
有効にするには、ManagedServiceAccount アドオンの有効化 を参照してください。
6.7. hypershift アドオン (テクノロジープレビュー) リンクのコピーリンクがクリップボードにコピーされました!
デフォルトでは、Hypershift
アドオンは無効になっています。このアドオンを有効にしてインストールするには、spec.overrides
の MultiClusterEngine
値に以下を含めます。
Hypershift
アドオンは、MultiClusterEngine
の作成後に、コマンドラインでリソースを編集し、hypershift-preview
コンポーネントを enabled: true
に設定することで有効にできます。または、次のコマンドを実行して、<multiclusterengine-name> を MultiClusterEngine
リソースの名前に置き換えることもできます。
oc patch MultiClusterEngine <multiclusterengine-name> --type=json -p='[{"op": "add", "path": "/spec/overrides/components/-","value":{"name":"hypershift-preview","enabled":true}}]'
oc patch MultiClusterEngine <multiclusterengine-name> --type=json -p='[{"op": "add", "path": "/spec/overrides/components/-","value":{"name":"hypershift-preview","enabled":true}}]'
第7章 ManagedServiceAccount アドオンの有効化 (テクノロジープレビュー) リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes Operator 用のマルチクラスターエンジンをインストールすると、ManagedServiceAccount
アドオンはデフォルトで無効になります。このコンポーネントを有効にすると、マネージドクラスターでサービスアカウントを作成または削除できます。
必要なアクセス権限: 編集
ManagedServiceAccount
カスタムリソースがハブクラスターの <managed_cluster>
namespace に作成されると、ServiceAccount
がマネージドクラスターに作成されます。
TokenRequest
は、マネージドクラスターの ServiceAccount
を使用して、マネージドクラスターの Kubernetes API サーバーに対して行われます。トークンは、ハブクラスターの <target_managed_cluster>
namespace の Secret
に保存されます。
注記 トークンは期限切れになり、ローテーションされる可能性があります。トークンリクエストの詳細については、TokenRequest を参照してください。
7.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- お使いの環境に Red Hat OpenShift Container Platform バージョン 4.9 以降をインストールし、コマンドラインインターフェイス (CLI) でログインしている。
- Kubernetes Operator 用のマルチクラスターエンジンがインストールされている。
7.2. ManagedServiceAccount の有効化 リンクのコピーリンクがクリップボードにコピーされました!
ハブクラスターとマネージドクラスターの Managed-ServiceAccount
アドオンを有効にするには、次の手順を実行します。
-
ハブクラスターで
ManagedServiceAccount
アドオンを有効にします。詳細は、詳細設定 を参照してください。 ManagedServiceAccount
アドオンをデプロイし、それをターゲットのマネージドクラスターに適用します。次の YAML ファイルを作成し、target_managed_cluster
をManaged-ServiceAccount
アドオンを適用するマネージドクラスターの名前に置き換えます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、ファイルを適用します。
oc apply -f -
oc apply -f -
Copy to Clipboard Copied! Toggle word wrap Toggle overflow これで、マネージドクラスターの
Managed-ServiceAccount
プラグインが有効になりました。ManagedServiceAccount
を設定するには、次の手順を参照してください。次の YAML ソースを使用して
ManagedServiceAccount
カスタムリソースを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
managed_serviceaccount_name
をManagedServiceAccount
の名前に置き換えます。 -
target_managed_cluster
を、ManagedServiceAccount
を適用するマネージドクラスターの名前に置き換えます。
-
確認するには、
ManagedServiceAccount
オブジェクトのステータスでtokenSecretRef
属性を表示して、シークレット名と namespace を見つけます。アカウントとクラスター名を使用して次のコマンドを実行します。oc get managedserviceaccount <managed_serviceaccount_name> -n <target_managed_cluster> -o yaml
oc get managedserviceaccount <managed_serviceaccount_name> -n <target_managed_cluster> -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow マネージドクラスターで作成された
ServiceAccount
に接続されている取得されたトークンを含むSecret
を表示します。以下のコマンドを実行します。oc get secret <managed_serviceaccount_name> -n <target_managed_cluster> -o yaml
oc get secret <managed_serviceaccount_name> -n <target_managed_cluster> -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
第8章 クラスターの作成 リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes のマルチクラスターエンジンは、内部 Hive コンポーネントを使用して Red Hat OpenShift Container Platform クラスターを作成します。クラスターの作成方法については、以下の情報を参照してください。
8.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
クラスターを作成する前に、clusterImageSets リポジトリーのクローンを作成し、ハブクラスターに適用する必要があります。以下の手順を参照してください。
次のコマンドを実行してクローンを作成します。
git clone https://github.com/stolostron/acm-hive-openshift-releases.git cd acm-hive-openshift-releases git checkout origin/release-2.5
git clone https://github.com/stolostron/acm-hive-openshift-releases.git cd acm-hive-openshift-releases git checkout origin/release-2.5
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、ハブクラスターに適用します。
find clusterImageSets/fast -type d -exec oc apply -f {} \; 2> /dev/null
find clusterImageSets/fast -type d -exec oc apply -f {} \; 2> /dev/null
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
クラスターを作成するときに、Red Hat OpenShift Container Platform リリースイメージを選択します。
8.2. ClusterDeployment を使用してクラスターを作成する リンクのコピーリンクがクリップボードにコピーされました!
ClusterDeployment
は、Hive カスタムリソースです。個々のクラスターを作成する方法については、次のドキュメントを参照してください。
Using Hive のドキュメントに従って、ClusterDeployment
カスタムリソースを作成します。
8.3. ClusterPool を使用してクラスターを作成 リンクのコピーリンクがクリップボードにコピーされました!
ClusterPool
は、複数のクラスターを作成するために使用される Hive カスタムリソースでもあります。ClusterPool
API を使用してクラスターを作成します。
Cluster Pools のドキュメントに従って、クラスターをプロビジョニングします。
第9章 クラスターのインポート リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes Operator 用のマルチクラスターエンジンをインストールすると、クラスターをインポートして管理できるようになります。Red Hat OpenShift Container Platform CLI を使用すると、インポートするクラスターの kubeconfig
ファイルを使用してクラスターをインポートできます。または、インポートするクラスターでインポートコマンドを手動で実行することもできます。どちらの手順も文書化されています。
CLI からインポートするには、次の手順を参照してください。
9.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- Linux (x86_64、s390x、ppc64le) または macOS が使用可能である。
- Kubernetes Operator 用のマルチクラスターエンジンをインストールし、MultiClusterEngine カスタムリソースを Kubernetes クラスターにインストールしている。
- 管理予定の別のクラスターとインターネット接続が必要。
oc
コマンドを実行するために、OpenShift Container Platform の CLI バージョン 4.8 以降が必要。Red Hat OpenShift CLI (oc
) のインストールおよび設定の詳細は、CLI の使用方法 を参照してください。注記: CLI ツールのインストールファイルを OpenShift Container Platform コンソールからダウンロードします。
-
OpenShift Container Platform によって作成されていないクラスターをインポートする場合は、
multiclusterengine.spec.imagePullSecret
を定義している。このシークレットは、Kubernetes Operator 用のマルチクラスターエンジンがインストールされたときに作成された可能性があります。このシークレットを定義する方法の詳細については、カスタムイメージプルシークレット を参照してください。
9.2. インポートの準備 リンクのコピーリンクがクリップボードにコピーされました!
engine cluster にログインします。エンジンクラスター は、Kubernetes Operator 用のマルチクラスターエンジンとカスタムリソースを含むクラスターです。以下のコマンドを実行します。
oc login
oc login
Copy to Clipboard Copied! Toggle word wrap Toggle overflow エンジンクラスターで次のコマンドを実行して、プロジェクトを作成します。
注記:
CLUSTER_NAME
で定義したクラスター名は、.yaml
ファイルおよびコマンドでクラスターの namespace としても使用します。oc new-project ${CLUSTER_NAME}
oc new-project ${CLUSTER_NAME}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して namespace を作成します。
oc label namespace ${CLUSTER_NAME} cluster.open-cluster-management.io/managedCluster=${CLUSTER_NAME}
oc label namespace ${CLUSTER_NAME} cluster.open-cluster-management.io/managedCluster=${CLUSTER_NAME}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下の YAML 例のように、
ManagedCluster
の例を編集します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow オプション: このリリースでは、ハブクラスターを自動的にインポートして、
local-cluster
と呼ばれるマネージドクラスターにすることは できません。マネージドクラスターを手動でlocal-cluster
にできるようにするには、metadata.labels.local-cluster: "true"
を追加します。次の YAML の例を参照して、名前がlocal-cluster
であることを確認してください。local-cluster
が名前でない場合、インポートは失敗するか、予期しない結果が発生します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
ファイルは
managed-cluster.yaml
として保存します。 以下のコマンドを使用して、YAML ファイルを適用します。
oc apply -f managed-cluster.yaml
oc apply -f managed-cluster.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.3. 自動インポートシークレットを使用したインポート リンクのコピーリンクがクリップボードにコピーされました!
エンジンクラスターにログインしたまま、次の手順に進みます。
-
インポートするクラスターの
kubeconfig
ファイル、またはインポートするクラスターの kube API サーバーとトークンを取得します。kubeconfig
ファイルまたは kube API サーバーおよびトークンの場所を特定する方法については、Kubernetes クラスターのドキュメントを参照してください。 kubeconfig
またはサーバー/トークンのペアを使用して、次のテンプレートに類似したコンテンツを含む YAML ファイルを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - ファイルを auto-import-secret.yaml として保存します。
インポートするクラスターの
kubeconfig
ファイルを使用して、${CLUSTER_NAME}
namespace にインポートシークレットを生成します。kubeconfig
およびCLUSTER_NAME
へのパスを指定して次のコマンドを実行します。oc apply -f auto-import-secret.yaml
oc apply -f auto-import-secret.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記: 自動インポートシークレットは 1 回使用され、インポートプロセスの完了時に削除されます。
インポートしたクラスターのステータス (
JOINED
およびAVAILABLE
) を確認します。Kubernetes クラスターのマルチクラスターエンジンから次のコマンドを実行します。oc get managedcluster ${CLUSTER_NAME}
oc get managedcluster ${CLUSTER_NAME}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow インポートする別のクラスターで次の手順に進みます。
インポートするクラスターにログインします。以下のコマンドを実行します。
oc login
oc login
Copy to Clipboard Copied! Toggle word wrap Toggle overflow インポートするクラスターの Pod ステータスを検証します。以下のコマンドを実行します。
oc get pod -n open-cluster-management-agent
oc get pod -n open-cluster-management-agent
Copy to Clipboard Copied! Toggle word wrap Toggle overflow アドオンは、インポートするクラスターが使用
AVAILABLE
になった後にインストールされます。クラスター上のアドオンの Pod ステータスを検証します。以下のコマンドを実行します。oc get pod -n open-cluster-management-agent-addon
oc get pod -n open-cluster-management-agent-addon
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
クラスターがインポートされました。
9.4. 手動コマンドでインポート リンクのコピーリンクがクリップボードにコピーされました!
重要: import コマンドには、インポートした各クラスターにコピーされるプルシークレット情報が含まれます。インポートしたクラスターにアクセスできるユーザーであれば誰でも、プルシークレット情報を表示することもできます。
エンジンクラスターのインポートコントローラーによって生成された
klusterlet-crd.yaml
を取得します。以下のコマンドを実行します。oc get secret ${CLUSTER_NAME}-import -n ${CLUSTER_NAME} -o jsonpath={.data.crds\\.yaml} | base64 --decode > klusterlet-crd.yaml
oc get secret ${CLUSTER_NAME}-import -n ${CLUSTER_NAME} -o jsonpath={.data.crds\\.yaml} | base64 --decode > klusterlet-crd.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow エンジンクラスターのインポートコントローラーによって生成された
import.yaml
を取得します。以下のコマンドを実行します。oc get secret ${CLUSTER_NAME}-import -n ${CLUSTER_NAME} -o jsonpath={.data.import\\.yaml} | base64 --decode > import.yaml
oc get secret ${CLUSTER_NAME}-import -n ${CLUSTER_NAME} -o jsonpath={.data.import\\.yaml} | base64 --decode > import.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow インポートする別のクラスターで次の手順に進みます。
インポートするクラスターにログインします。
oc login
oc login
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 前の手順で生成した
klusterlet-crd.yaml
を適用します。以下のコマンドを実行します。oc apply -f klusterlet-crd.yaml
oc apply -f klusterlet-crd.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以前に生成した
import.yaml
ファイルを適用します。以下のコマンドを実行します。oc apply -f import.yaml
oc apply -f import.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow インポートするクラスターの Pod ステータスを検証します。以下のコマンドを実行します。
oc get pod -n open-cluster-management-agent
oc get pod -n open-cluster-management-agent
Copy to Clipboard Copied! Toggle word wrap Toggle overflow インポートしているクラスターの
JOINED
およびAVAILABLE
のステータスを検証します。エンジンクラスターから、次のコマンドを実行します。oc get managedcluster ${CLUSTER_NAME}
oc get managedcluster ${CLUSTER_NAME}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow アドオンは、インポートするクラスターの
AVAILABLE
の後にインストールされます。インポートするクラスター上のアドオンの Pod ステータスを検証します。以下のコマンドを実行します。
oc get pod -n open-cluster-management-agent-addon
oc get pod -n open-cluster-management-agent-addon
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
これでクラスターがインポートされ、エンジンクラスターからそのクラスターを管理できます。
9.5. マネージドクラスターのデタッチ リンクのコピーリンクがクリップボードにコピーされました!
マネージドクラスターは、正常にインポートされたクラスターです。マネージドクラスターをエンジンクラスターからデタッチするには、次のコマンドを実行します。
oc delete managedcluster ${CLUSTER_NAME}
oc delete managedcluster ${CLUSTER_NAME}
これで、クラスターが切り離されました。
第10章 ManifestWork を使用したワークロードの展開 リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes クラスターのマルチクラスターエンジンからマネージドクラスターにワークロードをデプロイできます。例:Kubernetes クラスターのマルチクラスターエンジンからマネージドクラスターに基本的なデプロイを作成するには、ManifestWork
を使用した次のサンプルを参照してください。
Kubernetes クラスターのマルチクラスターエンジンにログインします。
oc login
oc login
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次の例のように、YAML ファイルを作成して
ManifestWork
リソースを設定します。CLUSTER_NAME
を クラスターのインポート ドキュメントでインポートしたマネージドクラスターの名前に置き換えます。サンプルの YAML は、ファイルを適用すると、マネージドクラスターのdefault
の namespace にデプロイされます。Copy to Clipboard Copied! Toggle word wrap Toggle overflow YAML ファイルを適用します。以下のコマンドを実行します。
oc apply -f manifestwork.yaml
oc apply -f manifestwork.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、Kubernetes クラスターのマルチクラスターエンジンから
ManifestWork
のステータスを確認します。oc get manifestwork -n ${CLUSTER_NAME} hello-work -o yaml
oc get manifestwork -n ${CLUSTER_NAME} hello-work -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow マネージドクラスターにログインして、結果を表示します。以下のコマンドを使用します。
oc login
oc login
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Kubernetes クラスター用のマルチクラスターエンジンで作成したデプロイを表示します。
oc get deploy -n default
$ oc get deploy -n default NAME READY UP-TO-DATE AVAILABLE AGE hello 1/1 1 1 37s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを使用して、作成された Pod を表示することもできます。
oc get pod
$ oc get pod NAME READY STATUS RESTARTS AGE hello-65f58985ff-4rm57 1/1 Running 0 42s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 作成された Pod のログを表示すると、次のようなメッセージが表示されます。
oc logs hello-65f58985ff-4rm57
$ oc logs hello-65f58985ff-4rm57 Hello, Kubernetes!
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
第11章 API リンクのコピーリンクがクリップボードにコピーされました!
クラスターライフサイクル管理のために、Kubernetes Operator のマルチクラスターエンジンの API にアクセスできます。ユーザーに必要なアクセス権: ロールが割り当てられているアクションのみを実行できます。詳細は、以下の各リソースに関する API のドキュメントを参照してください。
11.1. Clusters API リンクのコピーリンクがクリップボードにコピーされました!
11.1.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes のマルチクラスターエンジンのクラスターリソースを対象としています。クラスターリソースには、create、query、delete、update の 4 つの要求を使用できます。
11.1.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.1.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io: クラスターを作成して管理します。
11.1.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.1.2.1. 全クラスターのクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1/managedclusters
GET /cluster.open-cluster-management.io/v1/managedclusters
11.1.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
クラスターに対してクエリーを実行して詳細を確認します。
11.1.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
11.1.2.1.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.1.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
cluster/yaml
11.1.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.1.2.2. クラスターの作成 リンクのコピーリンクがクリップボードにコピーされました!
POST /cluster.open-cluster-management.io/v1/managedclusters
POST /cluster.open-cluster-management.io/v1/managedclusters
11.1.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
クラスターの作成
11.1.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
ボディー |
body | 作成するクラスターを記述するパラメーター |
11.1.2.2.3. 応答 リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.1.2.2.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
cluster/yaml
11.1.2.2.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.1.2.2.6. HTTP 要求の例 リンクのコピーリンクがクリップボードにコピーされました!
11.1.2.2.6.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.1.2.3. 単一クラスターのクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}
GET /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}
11.1.2.3.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
1 つのクラスターに対してクエリーを実行して詳細を確認します。
11.1.2.3.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
cluster_name | 問い合わせるクラスターの名前。 | 文字列 |
11.1.2.3.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.1.2.3.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.1.2.4. クラスターの削除 リンクのコピーリンクがクリップボードにコピーされました!
DELETE /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}
DELETE /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}
11.1.2.4.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一クラスターを削除します。
11.1.2.4.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
cluster_name | 削除するクラスターの名前。 | 文字列 |
11.1.2.4.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.1.2.4.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.1.3. 定義 リンクのコピーリンクがクリップボードにコピーされました!
11.1.3.1. クラスター リンクのコピーリンクがクリップボードにコピーされました!
名前 | スキーマ |
---|---|
apiVersion | string |
kind | string |
metadata | object |
spec |
spec
名前 | スキーマ |
---|---|
hubAcceptsClient | bool |
managedClusterClientConfigs | < managedClusterClientConfigs > array |
leaseDurationSeconds | 整数 (int32) |
managedClusterClientConfigs
名前 | 説明 | スキーマ |
---|---|---|
URL | string | |
CABundle |
パターン: | 文字列 (バイト) |
11.2. Clustersets API (v1alpha1) リンクのコピーリンクがクリップボードにコピーされました!
11.2.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes のマルチクラスターエンジンの Clusterset リソースを対象としています。Clusterset リソースには、create、query、delete、update の 4 つの要求を使用できます。
11.2.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.2.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io: Clustersets を作成して管理します。
11.2.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.2.2.1. 全 clusterset のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1beta1/managedclustersets
GET /cluster.open-cluster-management.io/v1beta1/managedclustersets
11.2.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
Clustersets に対してクエリーを実行して詳細を確認します。
11.2.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
11.2.2.1.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.2.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
clusterset/yaml
11.2.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.2.2.2. clusterset の作成 リンクのコピーリンクがクリップボードにコピーされました!
POST /cluster.open-cluster-management.io/v1beta1/managedclustersets
POST /cluster.open-cluster-management.io/v1beta1/managedclustersets
11.2.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
Clusterset を作成します。
11.2.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
ボディー |
body | 作成する clusterset を記述するパラメーター |
11.2.2.2.3. 応答 リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.2.2.2.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
clusterset/yaml
11.2.2.2.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.2.2.2.6. HTTP 要求の例 リンクのコピーリンクがクリップボードにコピーされました!
11.2.2.2.6.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.2.2.3. 単一 clusterset のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1beta1/managedclustersets/{clusterset_name}
GET /cluster.open-cluster-management.io/v1beta1/managedclustersets/{clusterset_name}
11.2.2.3.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一の clusterset に対してクエリーを実行して詳細を確認します。
11.2.2.3.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
clusterset_name | 問い合わせる clusterset の名前。 | 文字列 |
11.2.2.3.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.2.2.3.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.2.2.4. clusterset の削除 リンクのコピーリンクがクリップボードにコピーされました!
DELETE /cluster.open-cluster-management.io/v1beta1/managedclustersets/{clusterset_name}
DELETE /cluster.open-cluster-management.io/v1beta1/managedclustersets/{clusterset_name}
11.2.2.4.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一 clusterset を削除します。
11.2.2.4.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
clusterset_name | 削除する clusterset の名前。 | 文字列 |
11.2.2.4.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.2.2.4.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.2.3. 定義 リンクのコピーリンクがクリップボードにコピーされました!
11.2.3.1. Clusterset リンクのコピーリンクがクリップボードにコピーされました!
名前 | スキーマ |
---|---|
apiVersion | string |
kind | string |
metadata | object |
11.3. Clusterview API (v1alpha1) リンクのコピーリンクがクリップボードにコピーされました!
11.3.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes のマルチクラスターエンジンの clusterview
リソースを対象としています。clusterview
リソースには、アクセス可能なマネージドクラスターおよびマネージドクラスターセットの一覧を表示できる CLI コマンドが含まれます。使用できる要求は、list、get、および watch の 3 つです。
11.3.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.3.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
- clusterview.open-cluster-management.io: お使いの ID がアクセスできるマネージドクラスターの一覧を表示します。
11.3.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.3.2.1. マネージドクラスターの取得 リンクのコピーリンクがクリップボードにコピーされました!
GET /managedclusters.clusterview.open-cluster-management.io
GET /managedclusters.clusterview.open-cluster-management.io
11.3.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
アクセス可能なマネージドクラスターの一覧を表示します。
11.3.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
11.3.2.1.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.3.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
managedcluster/yaml
11.3.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- clusterview.open-cluster-management.io
11.3.2.2. マネージドクラスターの一覧表示 リンクのコピーリンクがクリップボードにコピーされました!
LIST /managedclusters.clusterview.open-cluster-management.io
LIST /managedclusters.clusterview.open-cluster-management.io
11.3.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
アクセス可能なマネージドクラスターの一覧を表示します。
11.3.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
ボディー |
body | マネージドクラスターを一覧表示するユーザー ID の名前 | 文字列 |
11.3.2.2.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.3.2.2.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
managedcluster/yaml
11.3.2.2.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- clusterview.open-cluster-management.io
11.3.2.2.6. HTTP 要求の例 リンクのコピーリンクがクリップボードにコピーされました!
11.3.2.2.6.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.3.2.3. マネージドクラスターセットの監視 リンクのコピーリンクがクリップボードにコピーされました!
WATCH /managedclusters.clusterview.open-cluster-management.io
WATCH /managedclusters.clusterview.open-cluster-management.io
11.3.2.3.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
アクセス可能なマネージドクラスターを確認します。
11.3.2.3.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
clusterview_name | 監視するユーザー ID の名前 | 文字列 |
11.3.2.3.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.3.2.4. マネージドクラスターセットの一覧表示 リンクのコピーリンクがクリップボードにコピーされました!
GET /managedclustersets.clusterview.open-cluster-management.io
GET /managedclustersets.clusterview.open-cluster-management.io
11.3.2.4.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
アクセス可能なマネージドクラスターを一覧表示します。
11.3.2.4.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
clusterview_name | 監視するユーザー ID の名前 | 文字列 |
11.3.2.4.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.3.2.5. マネージドクラスターセットの一覧表示 リンクのコピーリンクがクリップボードにコピーされました!
LIST /managedclustersets.clusterview.open-cluster-management.io
LIST /managedclustersets.clusterview.open-cluster-management.io
11.3.2.5.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
アクセス可能なマネージドクラスターを一覧表示します。
11.3.2.5.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
clusterview_name | 監視するユーザー ID の名前 | 文字列 |
11.3.2.5.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.3.2.6. マネージドクラスターセットの監視 リンクのコピーリンクがクリップボードにコピーされました!
WATCH /managedclustersets.clusterview.open-cluster-management.io
WATCH /managedclustersets.clusterview.open-cluster-management.io
11.3.2.6.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
アクセス可能なマネージドクラスターを確認します。
11.3.2.6.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
clusterview_name | 監視するユーザー ID の名前 | 文字列 |
11.3.2.6.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.4. Clustersetbindings API (v1alpha1) リンクのコピーリンクがクリップボードにコピーされました!
11.4.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes のマルチクラスターエンジンの clustersetbinding リソースを対象としています。clustersetbinding リソースには、create、query、delete、update の 4 つの要求を使用できます。
11.4.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.4.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io: clustersetbinding を作成して管理します。
11.4.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.4.2.1. 全 clustersetbinding のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/managedclustersetbindings
GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/managedclustersetbindings
11.4.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
clustersetbinding に対してクエリーを実行して詳細を確認します。
11.4.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
namespace | 使用する namespace (例: default) | 文字列 |
11.4.2.1.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.4.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
clustersetbinding/yaml
11.4.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.4.2.2. clustersetbinding の作成 リンクのコピーリンクがクリップボードにコピーされました!
POST /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/managedclustersetbindings
POST /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/managedclustersetbindings
11.4.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
clustersetbinding を作成します。
11.4.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
namespace | 使用する namespace (例: default) | 文字列 |
ボディー |
body | 作成する clustersetbinding を記述するパラメーター |
11.4.2.2.3. 応答 リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.4.2.2.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
clustersetbinding/yaml
11.4.2.2.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.4.2.2.6. HTTP 要求の例 リンクのコピーリンクがクリップボードにコピーされました!
11.4.2.2.6.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.4.2.3. 単一 clustersetbinding のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/managedclustersetbindings/{clustersetbinding_name}
GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/managedclustersetbindings/{clustersetbinding_name}
11.4.2.3.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一の clustersetbinding に対してクエリーを実行して詳細を確認します。
11.4.2.3.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
namespace | 使用する namespace (例: default) | 文字列 |
パス |
clustersetbinding_name | 問い合わせる clustersetbinding の名前 | 文字列 |
11.4.2.3.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.4.2.3.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.4.2.4. clustersetbinding の削除 リンクのコピーリンクがクリップボードにコピーされました!
DELETE /cluster.open-cluster-management.io/v1beta1/managedclustersetbindings/{clustersetbinding_name}
DELETE /cluster.open-cluster-management.io/v1beta1/managedclustersetbindings/{clustersetbinding_name}
11.4.2.4.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一 clustersetbinding を削除します。
11.4.2.4.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
namespace | 使用する namespace (例: default) | 文字列 |
パス |
clustersetbinding_name | 削除する clustersetbinding の名前 | 文字列 |
11.4.2.4.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.4.2.4.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.4.3. 定義 リンクのコピーリンクがクリップボードにコピーされました!
11.4.3.1. Clustersetbinding リンクのコピーリンクがクリップボードにコピーされました!
名前 | スキーマ |
---|---|
apiVersion | string |
kind | string |
metadata | object |
spec |
spec
名前 | スキーマ |
---|---|
clusterSet | string |
11.5. API リンクのコピーリンクがクリップボードにコピーされました!
11.5.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes のマルチクラスターエンジン用の MultiClusterEngine リソースを対象としています。MultiClusterEngine
リソースには、create、query、delete、update の 4 つのリクエストがあります。
11.5.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.5.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
- multiclusterengines.multicluster.openshift.io : MultiClusterEngine を作成および管理します。
11.5.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.5.2.1. MultiClusterEngine を作成する リンクのコピーリンクがクリップボードにコピーされました!
POST /apis/multicluster.openshift.io/v1alpha1/multiclusterengines
POST /apis/multicluster.openshift.io/v1alpha1/multiclusterengines
11.5.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
MultiClusterEngine を作成します。
11.5.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
ボディー |
body | 作成する MultiClusterEngine を説明するパラメーター。 | MultiClusterEngine |
11.5.2.1.3. 応答 リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.5.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
MultiClusterEngines/yaml
11.5.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- multiclusterengines.multicluster.openshift.io
11.5.2.1.5.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.5.2.2. すべての MultiClusterEngine をクエリーする リンクのコピーリンクがクリップボードにコピーされました!
GET /apis/multicluster.openshift.io/v1alpha1/multiclusterengines
GET /apis/multicluster.openshift.io/v1alpha1/multiclusterengines
11.5.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
詳細については、マルチクラスターエンジンに問い合わせてください。
11.5.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
11.5.2.2.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.5.2.2.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
operator/yaml
11.5.2.2.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- multiclusterengines.multicluster.openshift.io
11.5.2.3. MultiClusterEngine Operator の削除 リンクのコピーリンクがクリップボードにコピーされました!
DELETE /apis/multicluster.openshift.io/v1alpha1/multiclusterengines/{name}
DELETE /apis/multicluster.openshift.io/v1alpha1/multiclusterengines/{name}
11.5.2.3.1. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
name | 削除するマルチクラスターエンジンの名前。 | 文字列 |
11.5.2.3.2. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.5.2.3.3. タグ リンクのコピーリンクがクリップボードにコピーされました!
- multiclusterengines.multicluster.openshift.io
11.5.3. 定義 リンクのコピーリンクがクリップボードにコピーされました!
11.5.3.1. MultiClusterEngine リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | スキーマ |
---|---|---|
apiVersion | MultiClusterEngines のバージョン管理されたスキーマ。 | string |
kind | REST リソースを表す文字列の値 | string |
metadata | リソースを定義するルールを記述します。 | object |
spec | MultiClusterEngineSpec は、MultiClusterEngine の望ましい状態を定義します。 | 仕様の一覧 を参照してください。 |
11.5.3.2. 仕様の一覧 リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | スキーマ |
---|---|---|
nodeSelector | nodeselectors を設定します。 | map[string]string |
imagePullSecret | MultiClusterEngine オペランドおよびエンドポイントイメージにアクセスするためのプルシークレットをオーバーライドします。 | string |
tolerations | 許容範囲により、すべてのコンポーネントがあらゆる Taint を許容します。 | []corev1.Toleration |
targetNamespace | MCE リソースが配置される場所。 | 文字列 |
11.6. Placements API (v1alpha1) リンクのコピーリンクがクリップボードにコピーされました!
11.6.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes のマルチクラスターエンジンの配置リソースに関するものです。Placement リソースには、create、query、delete、update の 4 つの要求を使用できます。
11.6.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.6.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io: Placement を作成して管理します。
11.6.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.6.2.1. 全 Placement のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements
11.6.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
Placement に対してクエリーを実行して詳細を確認します。
11.6.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
11.6.2.1.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.6.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
placement/yaml
11.6.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.6.2.2. Placement の作成 リンクのコピーリンクがクリップボードにコピーされました!
POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements
POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements
11.6.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
Placement を作成します。
11.6.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
ボディー |
body | 作成する placement を記述するパラメーター |
11.6.2.2.3. 応答 リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.6.2.2.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
placement/yaml
11.6.2.2.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.6.2.2.6. HTTP 要求の例 リンクのコピーリンクがクリップボードにコピーされました!
11.6.2.2.6.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.6.2.3. 単一の Placement のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}
11.6.2.3.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
1 つの Placement に対してクエリーを実行して詳細を確認します。
11.6.2.3.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
placement_name | 問い合わせる Placement の名前 | 文字列 |
11.6.2.3.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.6.2.3.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.6.2.4. Placement の削除 リンクのコピーリンクがクリップボードにコピーされました!
DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}
DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}
11.6.2.4.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一の Placement を削除します。
11.6.2.4.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
placement_name | 削除する Placement の名前 | 文字列 |
11.6.2.4.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.6.2.4.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.6.3. 定義 リンクのコピーリンクがクリップボードにコピーされました!
11.6.3.1. Placement リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | スキーマ |
---|---|---|
apiVersion | Placement のバージョンスキーマ | string |
kind | REST リソースを表す文字列の値 | string |
metadata | Placement のメタデータ | object |
spec | Placement の仕様 |
spec
名前 | 説明 | スキーマ |
---|---|---|
ClusterSets | ManagedClusters を選択する ManagedClusterSets のサブセット。空白の場合には、Placement namespace にバインドされる ManagedClusterSets から ManagedClusters が選択されます。それ以外の場合は、ManagedClusters がこのサブセットの交差部分から選択され、ManagedClusterSets は Placement namespace にバインドされます。 | string array |
numberOfClusters | 選択する ManagedClusters の必要数 | 整数 (int32) |
predicates | ManagedClusters を選択するクラスター述語のサブセット。条件ロジックは OR です。 | clusterPredicate アレイ |
clusterPredicate
名前 | 説明 | スキーマ |
---|---|---|
requiredClusterSelector | ラベルおよびクラスター要求のある ManagedClusters を選択するクラスターセレクター |
clusterSelector
名前 | 説明 | スキーマ |
---|---|---|
labelSelector | ラベル別の ManagedClusters のセレクター | object |
claimSelector | 要求別の ManagedClusters のセレクター |
clusterClaimSelector
名前 | 説明 | スキーマ |
---|---|---|
matchExpressions | クラスター要求のセレクター要件のサブセット。条件ロジックは AND です。 | < オブジェクト > 配列 |
11.7. PlacementDecisions API (v1alpha1) リンクのコピーリンクがクリップボードにコピーされました!
11.7.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes のマルチクラスターエンジンの PlacementDecision リソースを対象としています。PlacementDecision リソースには、create、query、delete、update の 4 つの要求を使用できます。
11.7.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.7.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io: PlacementDecision を作成して管理します。
11.7.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.7.2.1. 全 PlacementDecision のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions
11.7.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
PlacementDecisions に対してクエリーを実行して詳細を確認します。
11.7.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
11.7.2.1.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.7.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
placementdecision/yaml
11.7.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.7.2.2. PlacementDecision の作成 リンクのコピーリンクがクリップボードにコピーされました!
POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions
POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions
11.7.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
PlacementDecisions を作成します。
11.7.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
ボディー |
body | 作成する PlacementDecision を記述するパラメーター |
11.7.2.2.3. 応答 リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.7.2.2.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
placementdecision/yaml
11.7.2.2.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.7.2.2.6. HTTP 要求の例 リンクのコピーリンクがクリップボードにコピーされました!
11.7.2.2.6.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.7.2.3. 単一の PlacementDecision のクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions/{placementdecision_name}
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions/{placementdecision_name}
11.7.2.3.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
1 つの PlacementDecisions に対してクエリーを実行して詳細を確認します。
11.7.2.3.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
placementdecision_name | 問い合わせる PlacementDecision の名前 | 文字列 |
11.7.2.3.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.7.2.3.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.7.2.4. PlacementDecision の削除 リンクのコピーリンクがクリップボードにコピーされました!
DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions/{placementdecision_name}
DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions/{placementdecision_name}
11.7.2.4.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一の PlacementDecision を削除します。
11.7.2.4.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
placementdecision_name | 削除する PlacementDecision の名前 | 文字列 |
11.7.2.4.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.7.2.4.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.7.3. 定義 リンクのコピーリンクがクリップボードにコピーされました!
11.7.3.1. PlacementDecision リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | スキーマ |
---|---|---|
apiVersion | PlacementDecision のバージョンスキーマ | string |
kind | REST リソースを表す文字列の値 | string |
metadata | PlacementDecision のメタデータ | オブジェクト |
11.8. マネージドサービスアカウント (テクノロジープレビュー) リンクのコピーリンクがクリップボードにコピーされました!
11.8.1. 概要 リンクのコピーリンクがクリップボードにコピーされました!
このドキュメントは、Kubernetes Operator のマルチクラスターエンジンの ManagedServiceAccount
リソースを対象としています。ManagedServiceAccount
リソースには、create、query、delete、update の 4 つのリクエストがあります。
11.8.1.1. URI スキーム リンクのコピーリンクがクリップボードにコピーされました!
ベースパス: /kubernetes/apis
スキーム: HTTPS
11.8.1.2. タグ リンクのコピーリンクがクリップボードにコピーされました!
-
managedserviceaccounts.multicluster.openshift.io`
:ManagedServiceAccounts
を作成および管理します
11.8.2. パス リンクのコピーリンクがクリップボードにコピーされました!
11.8.2.1. ManagedServiceAccount を作成する リンクのコピーリンクがクリップボードにコピーされました!
POST /apis/multicluster.openshift.io/v1alpha1/ManagedServiceAccounts
POST /apis/multicluster.openshift.io/v1alpha1/ManagedServiceAccounts
11.8.2.1.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
ManagedServiceAccount
を作成します。
11.8.2.1.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
ボディー |
body | 作成する ManagedServiceAccount を説明するパラメーター。 | ManagedServiceAccount |
11.8.2.1.3. 応答 リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.8.2.1.4. 消費 リンクのコピーリンクがクリップボードにコピーされました!
-
managedserviceaccount/yaml
11.8.2.1.5. タグ リンクのコピーリンクがクリップボードにコピーされました!
- managedserviceaccount.multicluster.openshift.io
11.8.2.1.5.1. 要求のボディー リンクのコピーリンクがクリップボードにコピーされました!
11.8.2.2. 単一の ManagedServiceAccount をクエリーする リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedserviceaccounts/{managedserviceaccount_name}
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedserviceaccounts/{managedserviceaccount_name}
11.8.2.2.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
詳細については、単一の ManagedServiceAccount
を照会してください。
11.8.2.2.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
managedserviceaccount_name |
照会する | 文字列 |
11.8.2.2.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.8.2.2.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.8.2.3. ManagedServiceAccount を削除する リンクのコピーリンクがクリップボードにコピーされました!
DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedserviceaccounts/{managedserviceaccount_name}
DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedserviceaccounts/{managedserviceaccount_name}
11.8.2.3.1. 説明 リンクのコピーリンクがクリップボードにコピーされました!
単一の ManagedServiceAccount
を削除します。
11.8.2.3.2. パラメーター リンクのコピーリンクがクリップボードにコピーされました!
型 | 名前 | 説明 | スキーマ |
---|---|---|---|
ヘッダー |
COOKIE | Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。 | 文字列 |
パス |
managedserviceaccount_name |
削除する | 文字列 |
11.8.2.3.3. レスポンス リンクのコピーリンクがクリップボードにコピーされました!
HTTP コード | 説明 | スキーマ |
---|---|---|
200 | 成功 | コンテンツなし |
403 | アクセス禁止 | コンテンツなし |
404 | リソースが見つからない | コンテンツなし |
500 | 内部サービスエラー | コンテンツなし |
503 | サービスが利用できない | コンテンツなし |
11.8.2.3.4. タグ リンクのコピーリンクがクリップボードにコピーされました!
- cluster.open-cluster-management.io
11.8.3. 定義 リンクのコピーリンクがクリップボードにコピーされました!
11.8.3.1. ManagedServiceAccount リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | スキーマ |
---|---|---|
apiVersion |
| string |
kind | REST リソースを表す文字列の値 | string |
metadata |
| object |
spec |
|
第12章 アンインストール リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes のマルチクラスターエンジンをアンインストールすると、プロセスの 2 つの異なるレベルが表示されます。custom resource removal と complete operator uninstall です。アンインストールプロセスの完了に最長 5 分かかる可能性があります。
-
カスタムリソースの削除は、最も基本的なアンインストールの種類で、
MultiClusterEngine
インスタンスのカスタムリソースを削除しますが、他の必要なコンポーネントが残されたままになります。このレベルのアンインストールは、同じ設定とコンポーネントを使用して再インストールする予定の場合に役立ちます。 - 2 番目のレベルは、より完全なアンインストールで、カスタムリソース定義などのコンポーネントを除き、ほとんどの Operator コンポーネントを削除します。この手順を続行すると、カスタムリソースの削除で削除されていないコンポーネントおよびサブスクリプションがすべて削除されます。アンインストールが済むと、カスタムリソースの前に Operator を再インストールする必要があります。
12.1. 前提条件: 有効化されたサービスのデタッチ リンクのコピーリンクがクリップボードにコピーされました!
Kubernetes エンジンのマルチクラスターエンジンをアンインストールする前に、そのエンジンによって管理されているすべてのクラスターをデタッチする必要があります。エラーを回避するには、エンジンによって管理されているすべてのクラスターをデタッチしてから、アンインストールを再試行してください。
マネージドクラスターがアタッチされている場合は、以下のメッセージが表示される可能性があります。
Cannot delete MultiClusterEngine resource because ManagedCluster resource(s) exist
Cannot delete MultiClusterEngine resource because ManagedCluster resource(s) exist
Copy to Clipboard Copied! Toggle word wrap Toggle overflow クラスターのデタッチの詳細は、クラスターの作成 でお使いのプロバイダーの情報を選択して、マネージメントからのクラスターの削除 セクションを参照してください。
12.2. コマンドを使用したリソースの削除 リンクのコピーリンクがクリップボードにコピーされました!
-
まだの場合には、
oc
コマンドが実行できるように、OpenShift Container Platform CLI が設定されていることを確認してください。oc
コマンドの設定方法は、Red Hat OpenShift Container Platform ドキュメントの OpenShift CLI の使用方法 を参照してください。 以下のコマンドを入力してプロジェクトの namespace に移動します。namespace はお使いのプロジェクトの namespace 名に置き換えます。
oc project <namespace>
oc project <namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを入力して、
MultiClusterEngine
カスタムリソースを削除します。oc delete multiclusterengine --all
oc delete multiclusterengine --all
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを入力して進捗を表示できます。
oc get multiclusterengine -o yaml
oc get multiclusterengine -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
以下のコマンドを入力し、インストールされている namespace の multicluster-engine
ClusterServiceVersion
を削除します。
ここに表示されている CSV バージョンは異なる場合があります。
12.3. コンソールを使用したコンポーネントの削除 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Container Platform コンソールを使用してアンインストールする場合に、operator を削除します。コンソールを使用してアンインストールを行うには、以下の手順を実行します。
- OpenShift Container Platform コンソールナビゲーションで、Operators > Installed Operators > multicluster engine for Kubernetes を選択します。
MultiClusterEngine
カスタムリソースを削除します。- Multiclusterengine のタブを選択します。
- MultiClusterEngine カスタムリソースの Options メニューを選択します。
- Delete MultiClusterEngine を選択します。
次のセクションの手順に従って、クリーンアップスクリプトを実行します。
ヒント: Kubernetes バージョンで同じマルチクラスターエンジンを再インストールする場合は、この手順の残りの手順をスキップして、カスタムリソースを再インストールできます。
- Installed Operators に移動します。
- Options メニューから Uninstall operator を選択して、_ multicluster engine for Kubernetes_ Operator を削除してください。
12.4. トラブルシューティングアンインストール リンクのコピーリンクがクリップボードにコピーされました!
マルチクラスターエンジンのカスタムリソースが削除されていない場合は、クリーンアップスクリプトを実行して、残っている可能性のあるアーティファクトをすべて削除します。
以下のスクリプトをファイルにコピーします。
#!/bin/bash oc delete apiservice v1.admission.cluster.open-cluster-management.io v1.admission.work.open-cluster-management.io oc delete validatingwebhookconfiguration multiclusterengines.multicluster.openshift.io oc delete mce --all
#!/bin/bash oc delete apiservice v1.admission.cluster.open-cluster-management.io v1.admission.work.open-cluster-management.io oc delete validatingwebhookconfiguration multiclusterengines.multicluster.openshift.io oc delete mce --all
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
第13章 must-gather コマンドを実行したトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
トラブルシューティングを開始するには、問題のデバッグを行う must-gather
コマンドを実行する場合のトラブルシューティングシナリオについて確認し、このコマンドの使用を開始する手順を参照してください。
必要なアクセス権限: クラスターの管理者
13.1. Must-gather のシナリオ リンクのコピーリンクがクリップボードにコピーされました!
シナリオ 1: 文書化されたトラブルシューティング セクションを使用して、問題の解決策がまとめられているかどうかを確認します。本ガイドは、製品の主な機能別に設定されています。
このシナリオでは、解決策が本書にまとめられているかどうかを、本ガイドで確認します。
-
シナリオ 2: 問題の解決策の手順が文書にまとめられていない場合は、
must-gather
コマンドを実行し、その出力を使用して問題をデバッグします。 -
シナリオ 3:
must-gather
コマンドの出力を使用して問題をデバッグできない場合は、出力を Red Hat サポートに共有します。
13.2. Must-gather の手順 リンクのコピーリンクがクリップボードにコピーされました!
must-gather
コマンドの使用を開始するには、以下の手順を参照してください。
-
must-gather
コマンドについて確認し、Red Hat OpenShift Container Platform の クラスターに関するデータの収集 に必要な前提条件をインストールします。 クラスターにログインします。通常のユースケースでは、engine クラスターにログインして、
must-gather
を実行する必要があります。注記: マネージドクラスターを確認する場合は、
cluster-scoped-resources
ディレクトリーにあるgather-managed.log
ファイルを検索します。<your-directory>/cluster-scoped-resources/gather-managed.log>
<your-directory>/cluster-scoped-resources/gather-managed.log>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow JOINED および AVAILABLE 列に
True
が設定されていないマネージドクラスターがないかを確認します。must-gather
コマンドは、ステータスがTrue
として関連付けられていないクラスター上で、実行できます。データとディレクトリーの収集に使用される Kubernetes イメージのマルチクラスターエンジンを追加します。以下のコマンドを実行して、出力用にイメージとディレクトリーを挿入します。
oc adm must-gather --image=registry.redhat.io/multicluster-engine/must-gather-rhel8:v2.0.0 --dest-dir=<directory>
oc adm must-gather --image=registry.redhat.io/multicluster-engine/must-gather-rhel8:v2.0.0 --dest-dir=<directory>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 指定したディレクトリーに移動し、以下のレベルに整理されている出力を確認します。
-
ピアレベル 2 つ:
cluster-scoped-resources
とnamespace
のリソース - それぞれに対するサブレベル: クラスタースコープおよび namespace スコープの両方のリソースに対するカスタムリソース定義の API グループ。
-
それぞれに対する次のレベル:
kind
でソートされた YAML ファイル
-
ピアレベル 2 つ:
13.3. 非接続環境での must-gather リンクのコピーリンクがクリップボードにコピーされました!
非接続環境で must-gather
コマンドを実行するには、次の手順を実行します。
- 非接続環境では、Red Hat Operator のカタログイメージをミラーレジストリーにミラーリングします。詳細は、ネットワーク切断状態でのインストール を参照してください。
- 次のコマンドを実行して、ミラーレジストリーからイメージを参照するログを抽出します。
REGISTRY=registry.example.com:5000 IMAGE=$REGISTRY/multicluster-engine/must-gather-rhel8@sha256:ff9f37eb400dc1f7d07a9b6f2da9064992934b69847d17f59e385783c071b9d8 oc adm must-gather --image=$IMAGE --dest-dir=./data
REGISTRY=registry.example.com:5000
IMAGE=$REGISTRY/multicluster-engine/must-gather-rhel8@sha256:ff9f37eb400dc1f7d07a9b6f2da9064992934b69847d17f59e385783c071b9d8
oc adm must-gather --image=$IMAGE --dest-dir=./data
ここ で製品チームのバグを開くことができます。