クラスター管理

手順

1. AWS の AWS Account Dashboard で Red Hat OpenShift Service にログインし、VPC Dashboard に移動します。
2. Your VPCs をクリックし、Red Hat OpenShift Service on AWS クラスターが含まれる VPC の名前および VPC ID を特定します。
3. VPC Dashboard から、Customer Gateway をクリックします。
4. Create Customer Gateway をクリックし、これに意味のある名前を指定します。
5. ルーティング方法 (Dynamic または Static) を選択します。
6. Dynamic の場合は、表示されるフィールドに BGP ASN を入力します。
7. VPN ゲートウェイエンドポイント IP アドレスに貼り付けます。
8. Create をクリックします。

9. 仮想プライベートゲートウェイが目的の VPC に割り当てられていない場合:

   1. VPC Dashboard から、Virtual Private Gateway をクリックします。
   2. Create Virtual Private Gateway をクリックし、意味のある名前を指定して Create をクリックします。
   3. デフォルトの Amazon デフォルト ASN のままにします。
   4. 新たに作成したゲートウェイを選択し、Attach to VPC をクリックし、これを以前に指定したクラスター VPC に割り当てます。

手順

1. VPC Dashboard から、Site-to-Site VPN Connections をクリックします。

2. Create VPN Connection をクリックします。

   1. これに意味のある名前タグを指定します。
   2. 以前に作成した仮想プライベートゲートウェイを選択します。
   3. Customer Gateway については、Existing を選択します。
   4. 名前でカスタマーゲートウェイデバイスを選択します。
   5. VPN が BGP を使用する場合は Dynamic を選択し、それ以外の場合は Static を選択します。静的 IP CIDR を入力します。複数の CIDR がある場合は、各 CIDR を Another Rule として追加します。
   6. Create をクリックします。
   7. VPN のステータスが Available に変更するまで待機します (約 5 分から 10 分)。

3. 作成したばかりの VPN を選択し、Download Configuration をクリックします。

   1. ドロップダウンリストから、カスタマーゲートウェイデバイスのベンダー、プラットフォーム、およびバージョンを選択し、Download をクリックします。
   2. Generic ベンダー設定は、プレーンテキスト形式で情報を取得する場合にも利用できます。

手順

1. VPC Dashboard から、Route Tables をクリックします。

2. Red Hat OpenShift Service on AWS クラスターが含まれる VPC に関連付けられたプライベートルートテーブルを選択します。

   注記

   クラスターによっては、特定の VPC に複数のルートテーブルが存在する場合があります。明示的に関連付けられた多数のサブネットを持つプライベートのルートテーブルを選択します。

3. Route Propagation タブをクリックします。

4. 表示される表に、以前に作成した仮想プライベートゲートウェイが表示されるはずです。Propagate column の値を確認します。

   1. Propagate (伝播) が No に設定されている場合は、Edit route propagation をクリックし、仮想プライベートゲートウェイの名前の横にある Propagate チェックボックスを確認して Save をクリックします。

手順

1. AWS の AWS Account Dashboard の Red Hat OpenShift Service にログインし、正しいリージョンを選択します。
2. Services メニューから Direct Connect を選択します。
3. 受け入れを待機している 1 つ以上の仮想インターフェイスがあります。いずれかの仮想インターフェイスを選択して Summary を表示します。
4. 仮想インターフェイスタイプ (private または public) を表示します。
5. Amazon side ASN の値を記録します。

手順

1. AWS の AWS Account Dashboard の Red Hat OpenShift Service にログインし、正しいリージョンを選択します。
2. AWS リージョンで、Services メニューから VPC を選択します。
3. VPN Connections から Virtual Private Gateways を選択します。
4. Create Virtual Private Gateway をクリックします。
5. 仮想プライベートゲートウェイに適切な名前を指定します。
6. Custom ASN を選択し、先に収集された Amazon side ASN の値を入力します。
7. 仮想プライベートゲートウェイを作成します。
8. 新規に作成された仮想プライベートゲートウェイをクリックし、Actions タブで Attach to VPC を選択します。
9. リストから Red Hat OpenShift Service on AWS Cluster VPC を選択し、Virtual Private Gateway を VPC に割り当てます。
10. Services メニューで、Direct Connect をクリックします。リストから Direct Connect 仮想インターフェイスのいずれかを選択します。
11. I understand that Direct Connect port charges apply once I click Accept Connection メッセージを確認したら Accept Connection を選択します。
12. 仮想プライベートゲートウェイ接続に対して Accept を選択し、前の手順で作成した仮想プライベートゲートウェイを選択します。
13. Accept を選択して接続を受け入れます。
14. 仮想インターフェイスが複数ある場合は、直前の手順を繰り返します。

手順

1. AWS の AWS Account Dashboard の Red Hat OpenShift Service にログインし、正しいリージョンを選択します。
2. AWS の AWS アカウントリージョンの Red Hat OpenShift Service の Services メニューから Direct Connect を選択します。
3. Direct Connect Gateways および Create Direct Connect Gateway を選択します。
4. Direct Connect Gateway に適切な名前を付けます。
5. Amazon side ASN で、以前に収集した Amazon side ASN 値を入力します。
6. Direct Connect Gateway を作成します。
7. Services メニューから Direct Connect を選択します。
8. リストから Direct Connect 仮想インターフェイスのいずれかを選択します。
9. I understand that Direct Connect port charges apply once I click Accept Connection メッセージを確認したら Accept Connection を選択します。
10. Direct Connect Gateway Connection に対して Accept を選択し、直前の手順で作成した Direct Connect Gateway を選択します。
11. Accept をクリックして接続を受け入れます。
12. 仮想インターフェイスが複数ある場合は、直前の手順を繰り返します。

手順

1. AWS の AWS Account Dashboard の Red Hat OpenShift Service にログインし、正しいリージョンを選択します。
2. AWS の AWS アカウントリージョンの Red Hat OpenShift Service の Services メニューから Direct Connect を選択します。
3. リストから Direct Connect 仮想インターフェイスのいずれかを選択します。
4. インターフェイスの状態が Available になったことを確認します。
5. インターフェイス BGP のステータスが Up になったことを確認します。
6. 残りの Direct Connect インターフェイスに対してこの検証を繰り返します。

手順

1. OpenShift Cluster Manager に移動し、クラスターを選択します。
2. Machine pools タブで、Add machine pool をクリックします。
3. マシンプール名 を追加します。

4. ドロップダウンメニューから Compute node instance type を選択します。インスタンスタイプは、マシンプール内の各コンピュートノードの仮想 CPU およびメモリー割り当てを定義します。

   注記

   プールを作成した後に、マシンプールのインスタンスタイプを変更することはできません。

5. オプション: マシンプールの自動スケーリングを設定します。

   1. Enable autoscaling を選択し、デプロイメントのニーズを満たすためにマシンプール内のマシン数を自動的にスケーリングします。

   2. 自動スケーリングの最小および最大のノード数制限を設定します。Cluster Autoscaler は、指定する制限を超えてマシンプールノード数を減らしたり、増やしたりできません。

      • 単一アベイラビリティーゾーンを使用してクラスターをデプロイした場合は、最小および最大のノード数 を設定します。これは、アベイラビリティーゾーンのコンピュートノードの最小および最大の制限を定義します。

      • 複数のアベイラビリティーゾーンを使用してクラスターをデプロイした場合は、Minimum nodes per zone および Maximum nodes per zone を設定します。これは、ゾーンごとの最小および最大のコンピュート制限を定義します。

        注記

        または、マシンプールの作成後にマシンプールの自動スケーリングを設定できます。

6. 自動スケーリングを有効にしていない場合は、コンピュートノードの数を選択します。

   • 単一アベイラビリティーゾーンを使用してクラスターをデプロイした場合は、ドロップダウンメニューから コンピュートノード数 を選択します。これは、ゾーンのマシンプールにプロビジョニングするコンピュートノードの数を定義します。
   • 複数のアベイラビリティーゾーンを使用してクラスターをデプロイした場合は、ドロップダウンメニューから コンピュートノードの数 (ゾーンごと) を選択します。これは、ゾーンごとにマシンプールにプロビジョニングするコンピュートノードの数を定義します。
7. オプション: ルートディスクのサイズ を設定します。

8. オプション: マシンプールのノードラベルおよびテイントを追加します。

   1. Edit node labels and taints メニューをデプロイメントします。
   2. Node labels で、ノードラベルの Key および Value のエントリーを追加します。

   3. Taints で、テイントの Key および Value エントリーを追加します。

      注記

      テイントを含むマシンプールの作成は、クラスターにテイントのないマシンプールが少なくとも 1 つすでに存在する場合にのみ可能です。

   4. テイントごとに、ドロップダウンメニューから Effect を選択します。使用できるオプションには、NoSchedule、PreferNoSchedule、および NoExecute が含まれます。

      注記

      または、マシンプールの作成後にノードラベルおよびテイントを追加できます。

9. オプション: このマシンプール内のノードに使用する追加のカスタムセキュリティーグループを選択します。すでにセキュリティーグループを作成し、このクラスター用に選択した VPC にそのグループを関連付けている必要があります。マシンプールの作成後は、セキュリティーグループを追加または編集することはできません。詳細は、「関連情報」セクションのセキュリティーグループの要件を参照してください。

10. オプション: マシンプールを保証なしの AWS Spot インスタンスとしてデプロイするように設定するには、Amazon EC2 Spot インスタンスを使用します。

    1. Use Amazon EC2 Spot Instances を選択します。

    2. オンデマンドのインスタンス価格を使用するには、Use On-Demand instance price を選択したままにします。または、Set maximum price を選択して、Spot インスタンスの 1 時間ごとの最大価格を定義します。

       Amazon EC2 Spot インスタンスの詳細は、AWS のドキュメント を参照してください。

       重要

       Amazon EC2 Spot インスタンスはいつでも中断する可能性があります。Amazon EC2 Spot インスタンスは、中断に対応できるワークロードにのみ使用します。

       注記

       マシンプールに Use Amazon EC2 Spot Instances を選択すると、マシンプールの作成後にオプションを無効にすることはできません。

11. Add machine pool をクリックしてマシンプールを作成します。

1. クラスターで使用可能なマシンプールをリスト表示します。

   $ rosa list machinepools --cluster=<cluster_name>

   出力例

   ID             AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS                  TAINTS    AVAILABILITY ZONES                    SPOT INSTANCES
   Default        No           3         m5.xlarge                                        us-east-1a, us-east-1b, us-east-1c    N/A
   mymachinepool  Yes          3-6       m5.xlarge      app=db, tier=backend              us-east-1a, us-east-1b, us-east-1c    No

2. クラスター内の特定のマシンプールの詳細情報を表示します。

   $ rosa describe machinepool --cluster=<cluster_name> --machinepool=mymachinepool

   出力例

   ID:                         mymachinepool
   Cluster ID:                 27iimopsg1mge0m81l0sqivkne2qu6dr
   Autoscaling:                Yes
   Replicas:                   3-6
   Instance type:              m5.xlarge
   Labels:                     app=db, tier=backend
   Taints:
   Availability zones:         us-east-1a, us-east-1b, us-east-1c
   Subnets:
   Spot instances:             No
   Disk size:                  300 GiB
   Security Group IDs:

3. マシンプールが出力に含まれ、設定が想定どおりであることを確認します。

クラスター作成の手順

1. ROSA クラスターウィザードから、Cluster settings に移動します。
2. Machine pool の手順に移動します。
3. 目的の Root disk size を選択します。
4. Next を選択してクラスターの作成を続行します。

マシンプール作成の手順

1. OpenShift Cluster Manager に移動し、クラスターを選択します。
2. Machine pool タブ に移動します。
3. Add machine pool をクリックします。
4. 目的の Root disk size を選択します。
5. Add machine pool を選択してマシンプールを作成します。

マシンプール作成の手順

1. 以下のコマンドを実行してクラスターをスケールアップします。

   $ rosa create machinepool --cluster=<cluster_id> \1
                             --disk-size=<disk_size> 2

   1

   既存の OpenShift クラスターの ID または名前を指定します。

   2

   ワーカーノードのディスクサイズを指定します。値は GB、GiB、TB、または TiB 単位で指定できます。<disk_size> は、数値と単位に置き換えます (例: --disk-size=200GiB)。数字と単位は、分離できません。空白は、使用できます。

2. AWS コンソールにログインして新規のマシンプールのディスクサイズを確認し、EC2 仮想マシンのルートボリュームサイズを見つけます。

手順

1. OpenShift Cluster Manager から、Cluster List ページに移動し、削除するマシンプールを含むクラスターを選択します。
2. 選択したクラスターで、Machine pools タブを選択します。
3. Machine pools タブで、削除するマシンプールのオプションメニュー をクリックします。

4. Delete をクリックします。

   選択したマシンプールが削除されます。

手順

1. ROSA CLI から次のコマンドを実行します。

   $ rosa delete machinepool -c=<cluster_name> <machine_pool_ID>

   出力例

   ? Are you sure you want to delete machine pool <machine_pool_ID> on cluster <cluster_name>? (y/N)

2. y を入力してマシンプールを削除します。

   選択したマシンプールが削除されます。

手順

1. クラスターのマシンプールをリスト表示します。

   $ rosa list machinepools --cluster=<cluster_name>

   出力例

   ID           AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS    TAINTS    AVAILABILITY ZONES    SPOT INSTANCES
   Default      No           2         m5.xlarge                          us-east-1a            N/A
   db-nodes-mp  No           2         m5.xlarge                          us-east-1a            No

2. マシンプールのノードラベルを追加または更新します。

   • 自動スケーリングを使用しないマシンプールのノードラベルを追加または更新するには、以下のコマンドを実行します。

     $ rosa edit machinepool --cluster=<cluster_name> \
                             --replicas=<replica_count> \1
                             --labels=<key>=<value>,<key>=<value> \2
                             <machine_pool_id>

     1

     自動スケーリングを使用しないマシンプールの場合は、ノードラベルの追加時にレプリカ数を指定する必要があります。--replicas 引数を指定しないと、コマンドが完了する前にレプリカ数の入力を求めるプロンプトが出されます。単一アベイラビリティーゾーンを使用して Red Hat OpenShift Service on AWS (ROSA) をデプロイしている場合、レプリカ数はゾーンのマシンプールにプロビジョニングするコンピュートノードの数を定義します。複数のアベイラビリティーゾーンを使用してクラスターをデプロイしている場合は、すべてのゾーンでマシンプール内のコンピュートノードの合計数を定義し、その数は 3 の倍数である必要があります。

     2

     <key>=<value>,<key>=<value> は、キーと値のペアのコンマ区切りリストに置き換えます (例: --labels=key1=value1,key2=value2)。このリストは、継続的にノードラベルに加えられるすべての変更を上書きします。

     以下の例では、ラベルを db-nodes-mp マシンプールに追加します。

     $ rosa edit machinepool --cluster=mycluster --replicas=2 --labels=app=db,tier=backend db-nodes-mp

     出力例

     I: Updated machine pool 'db-nodes-mp' on cluster 'mycluster'

   • 自動スケーリングを使用するマシンプールのノードラベルを追加または更新するには、以下のコマンドを実行します。

     $ rosa edit machinepool --cluster=<cluster_name> \
                             --min-replicas=<minimum_replica_count> \1
                             --max-replicas=<maximum_replica_count> \2
                             --labels=<key>=<value>,<key>=<value> \3
                             <machine_pool_id>

     1 2

     自動スケーリングを使用するマシンプールの場合は、最小および最大のコンピュートノードレプリカ制限を指定する必要があります。引数を指定しないと、コマンドが完了する前に値の入力が求められます。Cluster Autoscaler は、指定する制限を超えてマシンプールノード数を減らしたり、増やしたりできません。単一アベイラビリティーゾーンを使用して ROSA をデプロイしている場合、--min-replicas 引数および --max-replicas 引数は、ゾーンのマシンプールに自動スケーリング制限を定義します。複数のアベイラビリティーゾーンを使用してクラスターをデプロイしている場合に、すべてのゾーンにおける自動スケーリングの制限を引数で定義し、その数は 3 の倍数である必要があります。

     3

     <key>=<value>,<key>=<value> は、キーと値のペアのコンマ区切りリストに置き換えます (例: --labels=key1=value1,key2=value2)。このリストは、継続的にノードラベルに加えられるすべての変更を上書きします。

     以下の例では、ラベルを db-nodes-mp マシンプールに追加します。

     $ rosa edit machinepool --cluster=mycluster --min-replicas=2 --max-replicas=3 --labels=app=db,tier=backend db-nodes-mp

     出力例

     I: Updated machine pool 'db-nodes-mp' on cluster 'mycluster'

検証

1. 新しいラベルを持つマシンプールの詳細情報を表示します。

   $ rosa describe machinepool --cluster=<cluster_name> --machinepool=<machine-pool-name>

   出力例

   ID:                         db-nodes-mp
   Cluster ID:                 <ID_of_cluster>
   Autoscaling:                No
   Replicas:                   2
   Instance type:              m5.xlarge
   Labels:                     app=db, tier=backend
   Taints:
   Availability zones:         us-east-1a
   Subnets:
   Spot instances:             No
   Disk size:                  300 GiB
   Security Group IDs:

2. 出力内のマシンプールにラベルが含まれていることを確認します。

手順

1. OpenShift Cluster Manager に移動し、クラスターを選択します。
2. Machine pools タブで、テイントを追加するマシンプールのオプションメニュー をクリックします。
3. Edit taints を選択します。
4. テイントのKey と Value のエントリーを追加します。
5. ドロップダウンメニューからテイントの Effect を選択します。使用できるオプションには、NoSchedule、PreferNoSchedule、および NoExecute が含まれます。
6. 任意: マシンプールにテイントを追加する場合は、Add taint を選択します。
7. Save をクリックして、テイントをマシンプールに適用します。

検証

1. Machine pools タブで、マシンプールの横にある > を選択して、ビューをデプロイメントします。
2. デプロイメントされたビューの Taints の下にテイントがリストされていることを確認します。

手順

1. 次のコマンドを実行して、クラスター内のマシンプールをリスト表示します。

   $ rosa list machinepools --cluster=<cluster_name>

2. マシンプールのテイントを追加または更新します。

   • 自動スケーリングを使用しないマシンプールのテイントを追加または更新するには、以下のコマンドを実行します。

     $ rosa edit machinepool --cluster=<cluster_name> \
                             --replicas=<replica_count> \1
                             --taints=<key>=<value>:<effect>,<key>=<value>:<effect> \2
                             <machine_pool_id>

     1

     自動スケーリングを使用しないマシンプールの場合は、テイントの追加時にレプリカ数を指定する必要があります。--replicas 引数を指定しないと、コマンドが完了する前にレプリカ数の入力を求めるプロンプトが出されます。単一アベイラビリティーゾーンを使用して Red Hat OpenShift Service on AWS (ROSA) をデプロイしている場合、レプリカ数はゾーンのマシンプールにプロビジョニングするコンピュートノードの数を定義します。複数のアベイラビリティーゾーンを使用してクラスターをデプロイしている場合は、すべてのゾーンでマシンプール内のコンピュートノードの合計数を定義し、その数は 3 の倍数である必要があります。

     2

     <key>=<value>:<effect>,<key>=<value>:<effect> は、各テイントのキー、値、および影響に置き換えます (例: --taints=key1=value1:NoSchedule,key2=value2:NoExecute)。影響として NoSchedule、PreferNoSchedule、および NoExecute が使用できます。このリストは、ノードテイントに加えられた変更を継続的に上書きします。

     以下の例では、テイントを db-nodes-mp マシンプールに追加します。

     $ rosa edit machinepool --cluster=mycluster --replicas 2 --taints=key1=value1:NoSchedule,key2=value2:NoExecute db-nodes-mp

     出力例

     I: Updated machine pool 'db-nodes-mp' on cluster 'mycluster'

   • 自動スケーリングを使用するマシンプールのテイントを追加または更新するには、以下のコマンドを実行します。

     $ rosa edit machinepool --cluster=<cluster_name> \
                             --min-replicas=<minimum_replica_count> \1
                             --max-replicas=<maximum_replica_count> \2
                             --taints=<key>=<value>:<effect>,<key>=<value>:<effect> \3
                             <machine_pool_id>

     1 2

     自動スケーリングを使用するマシンプールの場合は、最小および最大のコンピュートノードレプリカ制限を指定する必要があります。引数を指定しないと、コマンドが完了する前に値の入力が求められます。Cluster Autoscaler は、指定する制限を超えてマシンプールノード数を減らしたり、増やしたりできません。単一アベイラビリティーゾーンを使用して ROSA をデプロイしている場合、--min-replicas 引数および --max-replicas 引数は、ゾーンのマシンプールに自動スケーリング制限を定義します。複数のアベイラビリティーゾーンを使用してクラスターをデプロイしている場合に、すべてのゾーンにおける自動スケーリングの制限を引数で定義し、その数は 3 の倍数である必要があります。

     3

     <key>=<value>:<effect>,<key>=<value>:<effect> は、各テイントのキー、値、および影響に置き換えます (例: --taints=key1=value1:NoSchedule,key2=value2:NoExecute)。利用可能な影響には、NoSchedule、PreferNoSchedule、および NoExecute が含まれます。このリストは、ノードのテイントに継続的に加えられた変更を上書きします。

     以下の例では、テイントを db-nodes-mp マシンプールに追加します。

     $ rosa edit machinepool --cluster=mycluster --min-replicas=2 --max-replicas=3 --taints=key1=value1:NoSchedule,key2=value2:NoExecute db-nodes-mp

     出力例

     I: Updated machine pool 'db-nodes-mp' on cluster 'mycluster'

検証

1. 新しいテイントを含むマシンプールの詳細情報を表示します。

   $ rosa describe machinepool --cluster=<cluster_name> --machinepool=<machinepool_name>

   出力例

   ID:                         db-nodes-mp
   Cluster ID:                 <ID_of_cluster>
   Autoscaling:                No
   Replicas:                   2
   Instance type:              m5.xlarge
   Labels:
   Taints:                     key1=value1:NoSchedule, key2=value2:NoExecute
   Availability zones:         us-east-1a
   Subnets:
   Spot instances:             No
   Disk size:                  300 GiB
   Security Group IDs:

2. 出力にマシンプールのテイントが含まれていることを確認します。

1. 予想されるコンテナーのメモリー使用の判別

   必要時に予想される平均およびピーク時のコンテナーのメモリー使用を判別します (例: 別の負荷テストを実行)。コンテナーで並行して実行されている可能性のあるすべてのプロセスを必ず考慮に入れるようにしてください。 たとえば、メインのアプリケーションは付属スクリプトを生成しているかどうかを確認します。

2. リスク選好 (risk appetite) の判別

   エビクションのリスク選好を判別します。リスク選好のレベルが低い場合、コンテナーは予想されるピーク時の使用量と安全マージンのパーセンテージに応じてメモリーを要求します。リスク選好が高くなる場合、予想される平均の使用量に応じてメモリーを要求することがより適切な場合があります。

3. コンテナーのメモリー要求の設定

   上記に基づいてコンテナーのメモリー要求を設定します。要求がアプリケーションのメモリー使用をより正確に表示することが望ましいと言えます。要求が高すぎる場合には、クラスターおよびクォータの使用が非効率となります。要求が低すぎる場合、アプリケーションのエビクションの可能性が高くなります。

4. コンテナーのメモリー制限の設定 (必要な場合)

   必要時にコンテナーのメモリー制限を設定します。制限を設定すると、コンテナーのすべてのプロセスのメモリー使用量の合計が制限を超える場合にコンテナーのプロセスがすぐに強制終了されるため、いくつかの利点をもたらします。まずは予期しないメモリー使用の超過を早期に明確にする ("fail fast" (早く失敗する)) ことができ、次にプロセスをすぐに中止できます。

   一部の Red Hat OpenShift Service on AWS クラスターでは制限値を設定する必要があります。 制限に基づいて要求を上書きする場合があります。 また、一部のアプリケーションイメージは、要求値よりも検出が簡単なことから設定される制限値に依存します。

   メモリー制限が設定される場合、これは予想されるピーク時のコンテナーのメモリー使用量と安全マージンのパーセンテージよりも低い値に設定することはできません。

5. アプリケーションが調整されていることの確認

   適切な場合は、設定される要求および制限値に関連してアプリケーションが調整されていることを確認します。この手順は、JVM などのメモリーをプールするアプリケーションにおいてとくに当てはまります。残りの部分では、これを説明します。