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

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

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

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

Operator グループを定義する YAML ファイルを作成します。ファイルは以下の例のようになります。default はお使いの operator グループ名に置き換えます。namespace はお使いのプロジェクトの namespace 名に置き換えます。

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

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

oc apply -f <path-to-file><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.3
  installPlanApproval: Automatic
  name: advanced-cluster-management

infra ノードにインストールする場合は、以下を追加します。

spec:
  config:
    nodeSelector:
      node-role.kubernetes.io/infra: ""
    tolerations:
    - key: node-role.kubernetes.io/infra
      effect: NoSchedule
      operator: Exists

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

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

オプション: 必要に応じて、ハブの自己管理を無効にします。デフォルトでは、Red Hat Advanced Cluster Management ハブクラスターは、自動的にインポートされ、管理されます。この マネージド ハブクラスターの名前は local-cluster です。

Red Hat Advanced Cluster Management ハブクラスターが自己管理しない場合は、disableHubSelfManagement の設定を false から true に変更する必要があります。この設定が、カスタムリソースを定義する YAML ファイルに含まれていない場合は、これを追加する必要があります。ハブクラスターは、このオプションでのみ管理できます。

このオプションを true に設定し、ハブの管理を試みると、予期しない動作が発生します。

プルシークレットを作成しており、disableHubSelfManagement 機能を有効にしている場合には、デフォルトのテンプレートは以下の例のようになります。namespace はお使いのプロジェクトの namespace 名に置き換えます。secret は、プルシークレット名に置き換えます。

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

以下のコマンドを使用して、カスタムリソースを適用します。custom-resource は、カスタムリソースファイル名に置き換えます。

oc apply -f <path-to-path><custom-resource>.yaml

以下のエラーで、この手順に失敗した場合でも、リソースは作成され、適用されます。リソースが作成されてから数分後にもう一度コマンドを実行します。