2.3. CLI を使用した Red Hat OpenShift Service on AWS クラスターの作成

手順

1. 次のいずれかのコマンドを使用して、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 範囲の定義」を参照してください。

   • 環境変数を設定していない場合は、以下のコマンドを実行します。

     $ rosa create cluster --cluster-name=<cluster_name> \ 

     1

     
         --mode=auto --hosted-cp [--private] \ 

     2

     
         --operator-roles-prefix <operator-role-prefix> \ 

     3

     
         --external-id <external-id> \ 

     4

     
         --oidc-config-id <id-of-oidc-configuration> \
         --subnet-ids=<public-subnet-id>,<private-subnet-id>

     Copy to Clipboard Toggle word wrap

     1

     クラスターの名前を指定します。クラスター名が 15 文字を超える場合、openshiftapps.com でプロビジョニングされたクラスターのサブドメインとして自動生成されたドメイン接頭辞が含まれます。サブドメインをカスタマイズするには、--domain-prefix フラグを使用します。ドメイン接頭辞は 15 文字を超えてはならず、一意である必要があり、クラスターの作成後に変更できません。

     2

     オプション: --private 引数は、プライベートの Red Hat OpenShift Service on AWS クラスターを作成するために使用します。この引数を使用する場合は、--subnet-ids にプライベートサブネット ID のみを使用するようにしてください。

     3

     デフォルトでは、クラスター固有の Operator のロール名には、クラスター名とランダムな 4 桁のハッシュが接頭辞として付けられます。オプションで、ロール名の <cluster_name>-<hash> を置き換えるカスタム接頭辞を指定できます。接頭辞は、クラスター固有の Operator IAM ロールを作成するときに適用されます。接頭辞の詳細は、カスタム Operator IAM ロール接頭辞について を参照してください。

     注記

     関連するアカウント全体のロールを作成したときにカスタム ARN パスを指定した場合、カスタムパスは自動的に検出されます。カスタムパスは、後のステップで作成するときに、クラスター固有の Operator ロールに適用されます。

     4

     オプション: 別のアカウントでロールを引き受けるときに必要になる可能性のある一意の識別子。

   • 環境変数を設定する場合、単一の初期マシンプールを備え、パブリックまたはプライベートに利用可能な API および Ingress を使用するクラスターを作成するには、次のコマンドを実行します。

     $ rosa create cluster --private --cluster-name=<cluster_name> \
         --mode=auto --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \
         --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS

     Copy to Clipboard Toggle word wrap

   • 環境変数を設定する場合、単一の初期マシンプール、パブリックに利用可能な API、およびパブリックに利用可能な Ingress を備えたクラスターを作成するには、次のコマンドを実行します。

     $ rosa create cluster --cluster-name=<cluster_name> --mode=auto \
         --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \
         --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS

     Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、クラスターのステータスを確認します。

   $ rosa describe cluster --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   以下の State フィールドの変更は、クラスターインストールの進捗として出力に表示されます。

   • pending (Preparing account)
   • installing (DNS setup in progress)
   • installing

   • ready

     注記

     インストールが失敗した場合や、State フィールドが 10 分以上 ready に変わらない場合は、インストールのトラブルシューティングのドキュメントで詳細を確認してください。詳細は、インストールのトラブルシューティング を参照してください。Red Hat サポートにサポートを依頼する手順は、Red Hat OpenShift Service on AWS のサポートの利用 を参照してください。

3. Red Hat OpenShift Service on AWS インストールプログラムのログを監視して、クラスター作成の進行状況を追跡します。ログを確認するには、次のコマンドを実行します。

   $ rosa logs install --cluster=<cluster_name> --watch \ 

   1

   Copy to Clipboard Toggle word wrap

   1

   オプション: インストールの進行中に新しいログメッセージを監視するには、--watch 引数を使用します。