1.4.3. CLI からのインストール

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

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"

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