1.3.4. OperatorHub からのインストール

ベストプラクティス: OpenShift Container Platform で提供される OperatorHub を使用してインストールします。

注記: OpenShift Container Platform Dedicated 環境のみの場合、cluster-admin パーミッションで OpenShift Container Platform Dedicated 環境にログインします。

  1. OpenShift Container Platform ナビゲーションの Administrator ビューで、Operators > OperatorHub を選択して、利用可能な Operator のリストにアクセスします。
  2. Red Hat Advanced Cluster Management for Kubernetes Operator を見つけて、選択します。

  3. Operator サブスクリプション ページで、インストールのオプションを選択します。

    • Namespace:

      • ハブクラスターは、独自の namespace またはプロジェクトにインストールする必要があります。
      • デフォルトでは、OperatorHub コンソールのインストールプロセスで open-cluster-management という namespace が作成されます。ベストプラクティス: 利用可能な場合は open-cluster-management namespace を使用してください。
      • open-cluster-management という名前の namespace がすでにある場合は、別の namespace を選択します。
    • チャネル: インストールするリリースに対応するチャネルを選択します。チャネルを選択すると、指定のリリースがインストールされ、そのリリース内の今後のエラータ更新が取得されます。

    • 承認ストラテジー: 承認ストラテジーでは、サブスクライブ先のチャネルまたはリリースに更新を適用するのに必要な人の間のやり取りを特定します。

      • Automatic を選択して、そのリリース内の更新が自動的に適用されるようにします。
      • Manual を選択して、更新が利用可能になると通知を受け取ります。更新がいつ適用されるかについて懸念がある場合は、これがベストプラクティスになる可能性があります。

      注記: 次のマイナーリリースにアップグレードするには、OperatorHub ページに戻り、最新リリースの新規チャネルを選択する必要があります。

  4. Install を選択して変更を適用し、Operator を作成します。

  5. OpenShift Container Platform または Red Hat Advanced Cluster Management で作成されていない Kubernetes クラスターをインポートする予定の場合には、OpenShift Container Platform プルシークレットを含むシークレットを作成して、ディストリビューションレジストリーから資格のあるコンテンツにアクセスします。OpenShift Container Platform クラスターのシークレット要件は、OpenShift Container Platform および Red Hat Advanced Cluster Management により自動で解決されるので、他のタイプの Kubernetes クラスターをインポートして管理しない場合には、このシークレットを作成する必要はありません。

    重要: これらのシークレットは namespace 固有であるため、Red Hat Advanced Cluster Management をインストールした namespace にシークレットを作成してください。

    1. cloud.redhat.com/openshift/install/pull-secret から Copy pull secret を選択して、OpenShift Container Platform のプルシークレットをコピーします。この手順の後半で、このプルシークレットのコンテンツが必要です。OpenShift Container Platform プルシークレットは Red Hat カスタマーポータル ID に関連しており、すべての Kubernetes プロバイダーで同じです。
    2. OpenShift Container Platform コンソールナビゲーションで、Workloads > Secrets を選択します。
    3. Create > Image Pull Secret を選択します。
    4. シークレットの名前を入力します。
    5. 認証タイプとして Upload Configuration File を選択します。
    6. Configuration file フィールドに cloud.redhat.com からコピーしたプルシークレットを貼り付けます。
    7. Create を選択してシークレットを作成します。

  6. MultiClusterHub のカスタムリソースを作成します。

    1. OpenShift Container Platform コンソールのナビゲーションで Installed Operators > Advanced Cluster Management for Kubernetes を選択します。
    2. MultiClusterHub タブを選択します。
    3. Create MultiClusterHub を選択します。

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

      • 以下の例は、イメージプルシークレットを作成していない場合のデフォルトのテンプレートです。namespace がお使いのプロジェクトの namespace であることを確認します。 

        apiVersion: operator.open-cluster-management.io/v1
kind: MultiClusterHub
metadata:
  name: multiclusterhub
  namespace: <namespace>
      • 以下の例は、イメージプルシークレットを作成している場合のデフォルトのテンプレートです。secret は作成したプルシークレット名に置き換えます。namespace がお使いのプロジェクトの namespace であることを確認します。 
      apiVersion: operator.open-cluster-management.io/v1
kind: MultiClusterHub
metadata:
  name: multiclusterhub
  namespace: <namespace>
spec:
  imagePullSecret: <secret>

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

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

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

    以下の例は、ハブの自己管理機能を無効にする場合に使用するデフォルトのテンプレートです。namespace はお使いのプロジェクトの namespace 名に置き換えます。 

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

  8. Create を選択して、カスタムリソースを初期化します。ハブクラスターのビルドと起動に、最長で 10 分程度かかる場合があります。

    ハブクラスターの作成後、Operator のステータスは、Installed Operators ページで Running になります。

  9. ハブクラスターのコンソールにアクセスします。

    1. OpenShift Container Platform コンソールナビゲーションで Networking > Routes を選択します。
    2. リストでハブクラスターの URL を確認して、その URL に移動してコンソールにアクセスします。