アドオン

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

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

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

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

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

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

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

次の例のような YAML コンテンツをカスタマイズして適用します。

apiVersion: submarineraddon.open-cluster-management.io/v1alpha1
kind: SubmarinerConfig
metadata:
    name: submariner
    namespace: <managed-cluster-namespace>
spec:{}

apiVersion: submarineraddon.open-cluster-management.io/v1alpha1
kind: SubmarinerConfig
metadata:
    name: submariner
    namespace: <managed-cluster-namespace>
spec:{}

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

注記: 以下の例のように、SubmarinerConfig の名前は submariner である必要があります。

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

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

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

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

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>

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

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 -n <managed-cluster-namespace> delete managedclusteraddon submariner

oc -n <managed-cluster-namespace> delete managedclusteraddon submariner

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

次のコマンドを実行して、クラスターのクラウドリソースを削除します。

oc -n <managed-cluster-namespace> delete submarinerconfig submariner

oc -n <managed-cluster-namespace> delete submarinerconfig submariner

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

次のコマンドを実行して、クラスターセットを削除し、ブローカーの詳細を削除します。

oc delete managedclusterset <managedclusterset>

oc delete managedclusterset <managedclusterset>

managedclusterset をマネージドクラスターセットの名前に置き換えます。

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

oc get cluster <CLUSTER_NAME> grep submariner

oc get cluster <CLUSTER_NAME> grep submariner

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

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

oc delete resource <RESOURCE_NAME> cluster <CLUSTER_NAME>

oc delete resource <RESOURCE_NAME> cluster <CLUSTER_NAME>

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

ハブクラスターで、次の例のようなコンテンツを含む volsync-mcao.yaml という YAML ファイルを作成します。

apiVersion: addon.open-cluster-management.io/v1alpha1
kind: ManagedClusterAddOn
metadata:
  name: volsync
  namespace: <managed-cluster-1-namespace>
spec: {}

apiVersion: addon.open-cluster-management.io/v1alpha1
kind: ManagedClusterAddOn
metadata:
  name: volsync
  namespace: <managed-cluster-1-namespace>
spec: {}

managed-cluster-1-namespace を、マネージドクラスターの 1 つの namespace に置き換えます。この namespace は、マネージドクラスターの名前と同じです。

注: 名前は volsync である必要があります。

次の例のようなコマンドを入力して、ファイルを設定に適用します。

oc apply -f volsync-mcao.yaml

oc apply -f volsync-mcao.yaml

他のマネージドクラスターに対して手順を繰り返します。

ManagedClusterAddOn リソースは、対応する各マネージドクラスターの namespace 内のハブクラスターに自動的に作成される必要があります。

宛先クラスターを設定します。

複製するソース永続ボリュームクレームを特定します。

注記: ソース永続ボリューム要求は CSI ストレージクラスにある必要があります。

ReplicationSource アイテムを作成します。

次の例のように、新しいデータを含む新しい永続ボリュームクレームを作成します。

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: <pvc-name>
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 3Gi

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: <pvc-name>
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 3Gi

pvc-name は、新しい永続ボリュームクレームの名前に置き換えます。

次の例のような ReplicationDestination カスタムリソースを作成して、データの復元先を指定します。

apiVersion: volsync.backube/v1alpha1
kind: ReplicationDestination
metadata:
  name: <destination>
spec:
  trigger:
    manual: restore-once
  restic:
    repository: <restic-repo>
    destinationPVC: <pvc-name>
    copyMethod: Direct

apiVersion: volsync.backube/v1alpha1
kind: ReplicationDestination
metadata:
  name: <destination>
spec:
  trigger:
    manual: restore-once
  restic:
    repository: <restic-repo>
    destinationPVC: <pvc-name>
    copyMethod: Direct

destination は、宛先 CR の名前に置き換えます。

restic-repo は、ソースが保存されているリポジトリーへのパスに置き換えます。

pvc-name は、データを復元する新しい永続ボリュームクレームの名前に置き換えます。これには、新しいボリューム要求をプロビジョニングするのではなく、既存の永続ボリューム要求を使用してください。