7.6. CLI を使用した Egress ゼロの Red Hat OpenShift Service on AWS クラスターの作成
ROSA CLI (rosa
) を使用してクラスターを作成する場合、デフォルトのオプションを選択してクラスターをすばやく作成できます。
前提条件
- Red Hat OpenShift Service on AWS の AWS 前提条件を満たしている。
- 利用可能な AWS サービスクォータがある。
- AWS コンソールで Red Hat OpenShift Service on AWS を有効にした。
-
インストールホストに最新の ROSA CLI (
rosa
) をインストールして設定した。現在インストールされている ROSA CLI のバージョンを確認するには、rosa version
を実行します。新しいバージョンが利用可能な場合、CLI はこのアップグレードをダウンロードするためのリンクを提供します。 - ROSA CLI を使用して Red Hat アカウントにログインしている。
- OIDC 設定を作成した。
- AWS Elastic Load Balancing (ELB) サービスロールが AWS アカウントに存在することを確認した。
手順
次のいずれかのコマンドを使用して、Red Hat OpenShift Service on AWS クラスターを作成します。
注記Red Hat OpenShift Service on AWS クラスターを作成する場合、デフォルトのマシンの Classless Inter-Domain Routing (CIDR) は
10.0.0.0/16
です。これが VPC サブネットの CIDR 範囲に対応していない場合は、次のコマンドに--machine-cidr <address_block>
を追加します。Red Hat OpenShift Service on AWS のデフォルト CIDR 範囲の詳細は、「CIDR 範囲の定義」を参照してください。環境変数を設定していない場合は、次のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- クラスターの名前を指定します。クラスター名が 15 文字を超える場合、openshiftapps.com でプロビジョニングされたクラスターのサブドメインとして自動生成されたドメイン接頭辞が含まれます。サブドメインをカスタマイズするには、
--domain-prefix
フラグを使用します。ドメイン接頭辞は 15 文字を超えてはならず、一意である必要があり、クラスターの作成後に変更できません。 - 2
- デフォルトでは、クラスター固有の Operator のロール名には、クラスター名とランダムな 4 桁のハッシュが接頭辞として付けられます。オプションで、ロール名の
<cluster_name>-<hash>
を置き換えるカスタム接頭辞を指定できます。接頭辞は、クラスター固有の Operator IAM ロールを作成するときに適用されます。接頭辞の詳細は、カスタム Operator IAM ロール接頭辞について を参照してください。注記関連するアカウント全体のロールを作成したときにカスタム ARN パスを指定した場合、カスタムパスは自動的に検出されます。カスタムパスは、後のステップで作成するときに、クラスター固有の Operator ロールに適用されます。
- 3
- 請求先アカウントがユーザーアカウントと異なる場合は、この引数を追加して、すべての請求を負担する AWS アカウントを指定します。
環境変数を設定する場合、単一の初期マシンプールを持ち、プライベートに利用可能な API および Ingress を使用する Egress ゼロのクラスターを作成するには、次のコマンドを実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
次のコマンドを実行して、クラスターのステータスを確認します。
rosa describe cluster --cluster=<cluster_name>
$ rosa describe cluster --cluster=<cluster_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow クラスターのインストールが進むにつれて、
State
フィールドが次のように変わり、出力に表示されます。-
pending (Preparing account)
-
installing (DNS setup in progress)
-
installing
ready
注記インストールが失敗した場合や、
State
フィールドが 10 分以上ready
に変わらない場合は、インストールのトラブルシューティングのドキュメントで詳細を確認してください。詳細は、インストールのトラブルシューティング を参照してください。Red Hat サポートにサポートを依頼する手順は、Red Hat OpenShift Service on AWS のサポートの利用 を参照してください。
-
Red Hat OpenShift Service on AWS インストールプログラムのログを監視して、クラスターの作成の進行状況を追跡します。ログを確認するには、次のコマンドを実行します。
rosa logs install --cluster=<cluster_name> --watch \
$ rosa logs install --cluster=<cluster_name> --watch \
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- オプション: インストールの進行中に新しいログメッセージを監視するには、
--watch
引数を使用します。