2.2. OCM CLI を使用した Workload Identity Federation クラスターの作成
OpenShift Cluster Manager CLI (ocm) を使用すると、interactive モードまたは non-interactive モードで、Workload Identity Federation (WIF) を使用する Google Cloud 上の OpenShift Dedicated クラスターを作成できます。
前提条件
- WIF 設定が作成されている。詳細は、「Workload Identity Federation 設定の作成」を参照してください。
-
OpenShift Cluster Manager の Downloads ページから、OpenShift Cluster Manager CLI (
ocm) の最新バージョンがダウンロードされている。
手順
WIF クラスターは、対話型 モードまたは 非対話型 モードのいずれかを使用して作成できます。
interactive モードでは、クラスターの作成中にクラスター属性がプロンプトとして自動的に表示されます。指定された要件に基づいて、表示されるフィールドにプロンプトの値を入力します。
non-interactive モードでは、コマンド内の特定パラメーターの値を指定します。
選択したモードに応じて、次のコマンドのいずれかを実行して、WIF 設定を使用して Google Cloud 上に OpenShift Dedicated クラスターを作成します。
interactive モードでクラスターを作成するには、次のコマンドを実行します。
$ ocm create cluster --interactive各項目の説明:
--interactive-
クラスターが対話モードで作成されることを指定します。このモードでは、クラスター作成時に必要な設定オプションを入力するよう求められます。このパラメーターを指定しない場合、クラスターはデフォルトで
非対話モードで作成されます。
以下のコマンドを実行して、非対話モードでクラスターを作成します。以下の例は、オプションのパラメーターと必須のパラメーターで設定されており、
非対話モードのコマンドとは異なる場合があります。オプションと記載されていないパラメーターは必須です。これらのパラメーターやその他のパラメーターの詳細を確認するには、ターミナルウィンドウでocm create cluster --help flagコマンドを実行してください。$ ocm create cluster <cluster_name> \ --provider=gcp \ --ccs=true \ --wif-config <wif_name> \ --dns-zone-id <dns_zone_id> \ --region <gcp_region> \ --subscription-type=marketplace-gcp \ --marketplace-gcp-terms=true \ --version <version> \ --multi-az=true \ --enable-autoscaling=true \ --min-replicas=3 \ --max-replicas=6 \ --secure-boot-for-shielded-vms=true --channel <channel_name>各項目の説明:
<cluster_name>-
クラスターの名前を指定します。
<cluster_name>は、クラスターの名前に置き換えます。 --provider=gcp- クラスターのクラウドプロバイダーを指定します。
--ccs=true- このクラスターが Customer Cloud Subscription (CCS) クラスターであることを指定します。
--wif-config <wif_name>-
クラスターに割り当てる WIF 設定の名前を指定します。
<wif_name>は、WIF 設定の名前に置き換えます。 --dns-zone-id <dns_zone_id>-
オプション: クラスターに使用する DNS ゾーン ID を指定します。
<dns_zone_id> を、ご使用の DNS ゾーンの ID に置き換えてください。このパラメーターの詳細は、関連情報 セクションの マネージド DNS ゾーンの作成を 参照してください。 -- リージョン <gcp_region>-
新しいクラスターがデプロイされる Google Cloud リージョンを指定します。
<gcp_region> を目的の Google Cloud リージョンに置き換えてください。 --subscription-type=marketplace-gcp- オプション: クラスターのサブスクリプション課金モデルを指定します。
--marketplace-gcp-terms=true-
OpenShift Dedicated 製品リストに関する Google Cloud Marketplace の利用規約に同意したことを確認します。
subscription-typeパラメーターにmarketplace-gcpという値を指定した場合、このパラメーターは必須です。 --version < バージョン >希望する OpenShift Dedicated のバージョンを指定します。このパラメーターは任意です。ただし、OpenShift Dedicated バージョンが指定されている場合は、そのバージョンが割り当てられた WIF 設定でサポートされている必要があります。割り当てられた WIF 設定でサポートされていないバージョンが指定されている場合、クラスターの作成に失敗します。この場合は、割り当てられている WIF 設定を目的のバージョンに更新するか、目的のバージョンで新しい WIF 設定を作成してください。バージョンを指定しない場合、割り当てられた WIF 設定のデフォルトバージョンでクラスターが作成されます。
WIF 設定でサポートされているバージョンに関する詳細は、Workload Identity Federation 設定の作成を参照してください。
--multi-az=true- クラスターが複数のデータセンターに展開されていることを指定します。このパラメーターは任意です。
--enable-autoscaling=true- コンピュートノードの自動スケーリングを有効にします。このパラメーターは任意です。
--min-replicas=3- コンピュートノードの最小数を指定します。このパラメーターは任意です。
--max-replicas=6- コンピュートノードの最大数を指定します。このパラメーターは任意です。
--secure-boot-for-shielded-vms=true- セキュアブートを有効にすることで、Google Cloud でシールドされた仮想マシンを使用できるようになります。このパラメーターは任意です。
-- チャネル <channel_name>-
クラスターを割り当てるチャネルの名前を指定します。チャネルオプションには
、stable-4.y、fast-4.y、eus-4.yがあります。< チャネル _name> を目的のチャンネル名に置き換えてください。このパラメーターは任意です。
インストール中にクラスターのデプロイメントが失敗すると、インストールプロセス中に作成された特定のリソースが Google Cloud アカウントから自動的に削除されません。Google Cloud アカウントからこれらのリソースを削除するには、障害が発生したクラスターを削除する必要があります。詳細は、Google Cloud 上の OpenShift Dedicated クラスターの削除を参照してください。
検証
クラスターが正常に作成されたことを確認するには、次のコマンドを実行します。
$ ocm get cluster <cluster_name>クラスターが正常に作成された場合、出力にはクラスターの状態が
準備完了と表示されます。