第1章 アドオンの概要

クラスターの管理 ドキュメントの ManagedClusterSets の作成および管理 トピックに記載されている手順を使用して、ハブクラスターに ManagedClusterSet リソースを作成します。ManagedClusterSet のエントリーは以下のような内容になります。

apiVersion: cluster.open-cluster-management.io/v1beta1
kind: ManagedClusterSet
metadata:
  name: <managed-cluster-set-name>

managed-cluster-set-name は、作成する ManagedClusterSet の名前に置き換えます。

注記: Kubernetes namespace の名前の最大長は 63 文字であるため、<managed-cluster-set-name> の最大長さは 56 文字です。<managed-cluster-set-name> の長さが 56 を超える場合には、<managed-cluster-set-name> は、先頭から 56 文字で省略されます。

ManagedClusterSet が作成されたら、submariner-addon は <managed-cluster-set-name>-broker と呼ばれる namespace を作成し、その namespace に Submariner ブローカーをデプロイします。

次の例のような YAML コンテンツをカスタマイズして適用することにより、<managed-cluster-set-name>-broker namespace のハブクラスターに Broker 設定を作成します。

apiVersion: submariner.io/v1alpha1
kind: Broker
metadata:
     name: submariner-broker
     namespace: <managed-cluster-set-name>-broker
spec:
     globalnetEnabled: false

managed-cluster-set-name は、マネージドクラスターの名前に置き換えます。

ManagedClusterSet で Submariner Globalnet を有効にする場合は、globalnetEnabled の値を true に設定します。

以下のコマンドを入力して、マネージドクラスターを 1 つ ManagedClusterSet に追加します。

oc label managedclusters <managed-cluster-name> "cluster.open-cluster-management.io/clusterset=<managed-cluster-set-name>" --overwrite

managedcluster-name は、ManagedClusterSet に追加するマネージドクラスターの名前に置き換えます。

ManagedClusterSet-name は、マネージドクラスターを追加する ManagedClusterSet の名前に置き換えます。

次の例のような YAML コンテンツをカスタマイズして適用することにより、マネージドクラスターに Submariner をデプロイします。

apiVersion: addon.open-cluster-management.io/v1alpha1
kind: ManagedClusterAddOn
metadata:
     name: submariner
     namespace: <managed-cluster-name>
spec:
     installNamespace: submariner-operator

managedcluster-name は、Submariner で使用するマネージドクラスターの名前に置き換えます。

ManagedClusterAddOn の仕様の installNamespace フィールドは、Submariner をインストールするマネージドクラスター上の namespace に置き換えます。現在、Submariner-operator namespace に Submariner をインストールする必要があります。

ManagedClusterAddOn の作成後に、submariner-addon は Submariner をマネージドクラスターの submariner-operator namespace にデプロイします。この ManagedClusterAddOn のステータスから Submariner のデプロイメントステータスを表示できます。

注記: ManagedClusterAddOn の名前は submariner である必要があります。

マネージドクラスターに Submariner をデプロイしたら、以下のコマンドを入力して、Submariner ManagedClusterAddOn のステータスを確認して Submariner のデプロイメントのステータスを確認できます。

oc -n <managed-cluster-name> get managedclusteraddons submariner -oyaml

cluster-name は、マネージドクラスターの名前に置き換えます。

Submariner ManagedClusterAddOn のステータスの 3 つの条件により、Submariner のデプロイメントステータスが分かります。

以下のコマンドを入力して、ManagedClusterSet のマネージドクラスターに nginx サービスのインスタンスを適用します。

oc -n default create deployment nginx --image=nginxinc/nginx-unprivileged:stable-alpine
oc -n default expose deployment nginx --port=8080

次のコマンドのような subctl ツールを使用してコマンドを入力し、ServiceExport エントリーを作成して、サービスをエクスポートします。

subctl export service --namespace <service-namespace> <service-name>

service-namespace を、サービスが置かれた namespace の名前に置き換えます。この例では、default になります。

service-name を、エクスポートするサービスの名前に置き換えます。この例では、nginx になります。

その他の使用可能なフラグの詳細については、Submariner ドキュメントの export を参照してください。

別のマネージドクラスターから以下のコマンドを実行して、nginx サービスにアクセスできることを確認します。

oc -n default run --generator=run-pod/v1 tmp-shell --rm -i --tty --image quay.io/submariner/nettest -- /bin/bash curl nginx.default.svc.clusterset.local:8080

Submariner を削除する他のクラスターについても、これらの手順を繰り返します。

ヒント: 複数のクラスターを選択して Actions をクリックすると、同じクラスターセット内の複数のクラスターから Submariner アドオンを削除できます。Uninstall Submariner add-ons を選択します。

次のコマンドを入力して、Submariner アドオンを含むクラスターを見つけます。

oc get resource submariner-addon -n open-cluster-management

次の例のようなコマンドを実行して、クラスターから Submariner をアンインストールします。

oc delete resource submariner-addon -n <CLUSTER_NAME>

CLUSTER_NAME は、クラスターの名前に置き換えます。

次のコマンドを実行して、クラスターに残っている Submariner リソースを一覧表示します。

oc get cluster <CLUSTER_NAME> grep submariner

CLUSTER_NAME をクラスターの名前に置き換えます。

次のコマンドを入力して、リストのリソースをすべて削除します。

oc delete resource <RESOURCE_NAME> cluster <CLUSTER_NAME>

RESOURCE_NAME を、削除する Submariner リソースの名前に置き換えます。