必要に応じて、.yaml ファイルのデフォルト値を更新します。

オプション: 必要に応じて、ハブの自己管理を無効にします。デフォルトでは、ハブクラスターは他のクラスターと同様に自動的にインポートされ、管理されます。ハブクラスターでの自己管理をしない場合は、disableHubSelfManagement の設定を false から true に変更します。この設定に、カスタムリソースを定義する .yaml ファイルが含まれていない場合は、直前の手順例のように追加します。以下の例は、ハブの自己管理機能を無効にする場合に使用するデフォルトのテンプレートです。

apiVersion: operator.open-cluster-management.io/v1
kind: MultiClusterHub
metadata:
  name: multiclusterhub
  namespace: <namespace>
spec:
  disableHubSelfManagement: true

namespace はお使いのプロジェクトの namespace 名に置き換えます。

以下のコマンドを実行してシークレットを作成します。

oc create secret generic <secret> -n <namespace> --from-file=.dockerconfigjson=<path-to-pull-secret> --type=kubernetes.io/dockerconfigjson

secret は作成するシークレット名に置き換えます。namespace はプロジェクトの namespace に置き換えます。path-to-pull-secret はダウンロードする OpenShift Container Platform のプルシークレットへのパスに置き換えます。

Operator グループを定義する .yaml ファイルを作成します。ファイルは以下の例のようになります。

apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: <default>
spec:
  targetNamespaces:
  - <namespace>

default はお使いの operator グループ名に置き換えます。namespace はお使いのプロジェクトの namespace に置き換えます。

作成したファイルを適用して Operator グループを定義します。

oc apply -f local/<operator-group>.yaml

operator-group は、作成した operator グループの .yaml ファイル名に置き換えます。

サブスクリプションを定義する .yaml ファイルを作成します。ファイルは以下の例のようになります。

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: acm-operator-subscription
spec:
  sourceNamespace: openshift-marketplace
  source: redhat-operators
  channel: release-2.1
  installPlanApproval: Automatic
  name: advanced-cluster-management

サブスクリプションを適用します。

oc apply -f local/<subscription>.yaml

subscription は、作成したサブスクリプションファイルの名前に置き換えます。

カスタムリソースを定義する .yaml ファイルを作成します。

オプション: 必要に応じて、ハブの自己管理を無効にします。デフォルトでは、ハブクラスターは他のクラスターと同様に自動的にインポートされ、管理されます。ハブクラスターでの自己管理をしない場合は、disableHubSelfManagement の設定を false から true に変更します。プルシークレットを作成しており、disableHubSelfManagement 機能を有効にしている場合には、デフォルトのテンプレートは以下の例のようになります。

apiVersion: operator.open-cluster-management.io/v1
kind: MultiClusterHub
metadata:
  name: multiclusterhub
  namespace: <namespace>
spec:
  imagePullSecret: <secret>
  disableHubSelfManagement: true

namespace はお使いのプロジェクトの namespace 名に置き換えます。

secret は、プルシークレット名に置き換えます。

カスタムリソースを適用します。

oc apply -f local/<custom-resource>.yaml

custom-resource は、カスタムリソースファイル名に置き換えます。

重要: local-cluster namespace は、インポートされた自己管理のハブクラスターに使用します。インストール前に、クラスターに local-cluster namespace を含めることはできません。ハブクラスターに local-cluster namespace が作成されると、local-cluster namespace へのアクセス権があるユーザーには自動的に cluster administrator のアクセス権が付与されます。セキュリティーの理由上、クラスター管理者のアクセス権がないユーザーには、local-cluster namespace へのアクセス権を割り当てないようにしてください。

以下のエラーで、この手順に失敗した場合でも、リソースは作成され、適用されます。

error: unable to recognize "./mch.yaml": no matches for kind "MultiClusterHub" in version "operator.open-cluster-management.io/v1"

リソースが作成されてから数分後にもう一度コマンドを実行します。

additionalTrustBundle の行の後に証明書情報を追加します。追加後の内容は以下の例のようになります。

additionalTrustBundle: |
  -----BEGIN CERTIFICATE-----
  certificate_content
  -----END CERTIFICATE-----
sshKey: >-

以下のコマンドを実行して MultiClusterObservability カスタムリソースを削除します。

oc delete mco observability

リソースを削除すると、Red Hat Advanced Cluster Management ハブクラスターの open-cluster-management-observability namespace の Pod と、全マネージドクラスターの open-cluster-management-addon-observability namespace の Pod が削除されます。

重要: 可観測性サービスの削除によるオブジェクトストレージへの影響はありません。

以下のスクリプトをファイルにコピーします。

#!/bin/bash
ACM_NAMESPACE=<namespace>
oc delete mch --all -n $ACM_NAMESPACE
helm ls --namespace $ACM_NAMESPACE | cut -f 1 | tail -n +2 | xargs -n 1 helm delete --namespace $ACM_NAMESPACE
oc delete apiservice v1beta1.webhook.certmanager.k8s.io v1.admission.cluster.open-cluster-management.io v1.admission.work.open-cluster-management.io
oc delete clusterimageset --all
oc delete configmap -n $ACM_NAMESPACE cert-manager-controller cert-manager-cainjector-leader-election cert-manager-cainjector-leader-election-core
oc delete consolelink acm-console-link
oc delete crd klusterletaddonconfigs.agent.open-cluster-management.io placementbindings.policy.open-cluster-management.io policies.policy.open-cluster-management.io userpreferences.console.open-cluster-management.io searchservices.search.acm.com
oc delete mutatingwebhookconfiguration cert-manager-webhook cert-manager-webhook-v1alpha1
oc delete oauthclient multicloudingress
oc delete rolebinding -n kube-system cert-manager-webhook-webhook-authentication-reader
oc delete scc kui-proxy-scc
oc delete validatingwebhookconfiguration cert-manager-webhook cert-manager-webhook-v1alpha1

スクリプトの namespace は、Red Hat Advanced Cluster Management がインストールされている namespace 名に置き換えます。namespace が消去され、削除されるので、正しい namespace を指定するようにしてください。

スクリプトを実行して、アーティファクトを以前のインストールから削除します。

ヒント: 新しいバージョンを再インストールする予定で、他の情報を保存する場合には、残りの手順を省略し、再インストールしてください。

Delete MultiClusterHub を選択します。

アンインストールプロセスの完了に最長 20 分かかる可能性があります。