Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

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

OpenShift Container Platform Dedicated 環境のみに必要なアクセス: クラスターの管理者のデフォルトの dedicated-admin ロールには OpenShift Container Platform Dedicated 環境での名前空間の作成に必要なパーミッションがありません。cluster-admin パーミッションが必要です。

  1. Operator 要件を満たしたハブクラスター namespace を作成します。以下のコマンドを実行して、namespace はお使いのハブクラスターの namespace 名になります。namespace の値は、OpenShift Container Platform 環境では プロジェクト と呼ばれる場合があります。 

    oc create namespace <namespace>
    Copy to Clipboard Toggle word wrap

  2. プロジェクトの namespace を、作成した namespace に切り替えます。namespace は、手順 1 で作成したハブクラスター namespace 名に置き換えます。 

    oc project <namespace>
    Copy to Clipboard Toggle word wrap

  3. 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 ごとに異なるので、手順 1 で作成した namespace で操作を行うようにしてください。

    1. cloud.redhat.com/openshift/install/pull-secret から Download pull secret を選択して、OpenShift Container Platform のプルシークレットファイルをダウンロードします。OpenShift Container Platform プルシークレットは Red Hat カスタマーポータル ID に関連しており、すべての Kubernetes プロバイダーで同じです。

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

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

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

  4. Operator グループを作成します。namespace ごとに割り当てることのできる Operator グループ は 1 つだけです。

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

      apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: <default>
spec:
  targetNamespaces:
  - <namespace>
      Copy to Clipboard Toggle word wrap

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

      oc apply -f <path-to-file><operator-group>.yaml
      Copy to Clipboard Toggle word wrap

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

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

    1. サブスクリプションを定義する 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
      Copy to Clipboard Toggle word wrap

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

      spec:
  config:
    nodeSelector:
      node-role.kubernetes.io/infra: ""
    tolerations:
    - key: node-role.kubernetes.io/infra
      effect: NoSchedule
      operator: Exists
      Copy to Clipboard Toggle word wrap
    3. 以下のコマンドを実行します。subscription は、作成したサブスクリプションファイル名に置き換えます。 
    oc apply -f <path-to-file><subscription>.yaml
    Copy to Clipboard Toggle word wrap

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

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

      • デフォルトのテンプレートは、以下の例のようになります。namespace はお使いのプロジェクトの namespace 名に置き換えます。プルシークレットを作成していない場合には、これは表示されません。作成済みの場合には、secret は、プルシークレット名に置き換えます。 
      apiVersion: operator.open-cluster-management.io/v1
kind: MultiClusterHub
metadata:
  name: multiclusterhub
  namespace: <namespace>
spec:
  imagePullSecret: <secret>
      Copy to Clipboard Toggle word wrap
    2. オプション： インストーラーが管理する acm-hive-openshift-releases サブスクリプションが有効になっている場合は、disableUpdateClusterImageSets の値を true に設定してサブスクリプションを無効にすることができます。

    3. オプション: 必要に応じて、ハブの自己管理を無効にします。デフォルトでは、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
      Copy to Clipboard Toggle word wrap

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

      oc apply -f <path-to-path><custom-resource>.yaml
      Copy to Clipboard Toggle word wrap

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

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

  7. 以下のコマンドを実行してカスタムリソースを編集します。以下のコマンドを実行して、MultiClusterHub カスタムリソースのステータスが status.phase フィールドに Running と表示されるまで、最長 10 分の時間がかかる可能性があります。 

    oc get mch -o=jsonpath='{.items[0].status.phase}'
    Copy to Clipboard Toggle word wrap

  8. ステータスが Running になってから、ルートの一覧を確認してルートを探し出します。 

    oc get routes
    Copy to Clipboard Toggle word wrap

Red Hat Advanced Cluster Management を再インストールして、Pod が起動しない場合には、この問題の回避手順について「再インストールに失敗する場合のトラブルシューティング」を参照してください。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat