クラスター管理

手順

1. AWS の AWS Account Dashboard で Red Hat OpenShift Service にログインし、VPC Dashboard に移動します。
2. Virtual Private Cloud の下で Your VPCs をクリックし、Red Hat OpenShift Service on AWS クラスターを含む VPC の名前と VPC ID を特定します。
3. [仮想プライベートネットワーク (VPN)] の下で、お客様ゲートウェイ] をクリックします。
4. お客様ゲートウェイの作成 をクリックし、意味のある名前を付けます。
5. BGP ASN フィールドにお客様ゲートウェイデバイスの ASN を入力します。
6. IP アドレスフィールドに、お客様ゲートウェイデバイスの外部インターフェイスの IP アドレスを入力します。
7. お客様ゲートウェイの作成を クリックします。

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

   1. VPC ダッシュボードから、仮想プライベートゲートウェイ をクリックします。
   2. 仮想プライベートゲートウェイの作成 をクリックし、意味のある名前を付けます。
   3. Amazon のデフォルトの ASN のままにして、[仮想プライベートゲートウェイの作成] をクリックします。
   4. 新しく作成したゲートウェイを選択します。
   5. リストから アクション を選択し、VPC にアタッチを クリックします。
   6. 利用可能な VPC の下で新しく作成されたゲートウェイを選択し、VPC に接続を クリックして、前に特定したクラスター VPC に接続します。

手順

1. VPC ダッシュボードの仮想プライベートネットワーク (VPN) の下にある サイト間 VPN 接続 をクリックします。

2. [VPN 接続の作成] を クリックします。

   1. これに意味のある名前タグを指定します。
   2. 以前に作成した仮想プライベートゲートウェイを選択します。
   3. お客様ゲートウェイの場合は、既存 を選択します。
   4. 名前でお客様ゲートウェイ ID を選択します。
   5. VPN で BGP を使用する場合は [Dynamic] を選択し、それ以外の場合は [Static] を選択して静的 IP CIDR を入力します。複数の CIDR がある場合は、各 CIDR を Another Rule として追加します。
   6. [VPN 接続の作成] を クリックします。
   7. 状態 の下で、VPN ステータスが 保留中 から 利用可能 に変わるまで、約 5 - 10 分待ちます。

3. 作成した VPN を選択し、設定のダウンロードを クリックします。

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

手順

1. VPC ダッシュボードの Virtual Private Cloud で、ルートテーブル をクリックします。

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

   注記

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

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

4. 表示されるテーブルに、以前に作成した仮想プライベートゲートウェイが表示されます。伝播 列の値を確認します。

   1. 伝播 が いいえ に設定されている場合は、ルート伝播の編集 をクリックし、伝播の 有効化 チェックボックスをオンにして、保存 をクリックします。

手順

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)] から、[仮想プライベートゲートウェイ] を選択します。
4. 仮想プライベートゲートウェイの作成 をクリックします。
5. 仮想プライベートゲートウェイに適切な名前を指定します。
6. [カスタム ASNを入力] フィールドで [カスタム ASN] を選択し、以前に収集した Amazon 側 ASN 値を入力します。
7. 仮想プライベートゲートウェイの作成 をクリックします。
8. 新規に作成された仮想プライベートゲートウェイをクリックし、Actions タブで Attach to VPC を選択します。
9. リストから Red Hat OpenShift Service on AWS クラスター VPC を選択し、VPC のアタッチを クリックします。

手順

1. AWS の AWS Account Dashboard の Red Hat OpenShift Service にログインし、正しいリージョンを選択します。
2. AWS の AWS アカウントリージョンの Red Hat OpenShift Service の Services メニューから Direct Connect を選択します。
3. Direct Connect ゲートウェイ を選択し、Direct Connect ゲートウェイを作成します。
4. Direct Connect ゲートウェイに適切な名前を付けます。
5. Amazon side ASN で、以前に収集した Amazon side ASN 値を入力します。
6. Direct Connect ゲートウェイの作成を クリックします。

手順

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. リストから コンピュートノードインスタンスタイプ を選択します。インスタンスタイプは、マシンプール内の各コンピュートノードの仮想 CPU およびメモリー割り当てを定義します。

   注記

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

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

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

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

      注記

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

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 にそのグループを関連付けている必要があります。マシンプールの作成後は、セキュリティーグループを追加または編集することはできません。

   重要

   Red Hat OpenShift Service on AWS クラスターのマシンプールには、最大 10 個の追加セキュリティーグループを使用できます。

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

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

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   出力例

   ID             AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS                  TAINTS    AVAILABILITY ZONE  SUBNET                    VERSION  AUTOREPAIR
   Default        No           1/1       m5. xlarge                                       us-east-2c         subnet-00552ad67728a6ba3  4.14.34  Yes
   mymachinepool  Yes          3/3-6     m5.xlarge      app=db, tier=backend              us-east-2a         subnet-0cb56f5f41880c413  4.14.34  Yes

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   出力例

   ID:                         mymachinepool
   Cluster ID:                 2d6010rjvg17anri30v84vspf7c7kr6v
   Autoscaling:                Yes
   Desired replicas:           3-6
   Current replicas:           3
   Instance type:              m5.xlarge
   Labels:                     app=db, tier=backend
   Taints:
   Availability zone:          us-east-2a
   Subnet:                     subnet-0cb56f5f41880c413
   Version:                    4.14.34
   Autorepair:                 Yes
   Tuning configs:
   Additional security group IDs:
   Node drain grace period:
   Message:

   Copy to Clipboard Toggle word wrap

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

マシンプール作成の手順

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

   $ rosa create machinepool --cluster=<cluster_id> \

   1

   
                             --disk-size=<disk_size> 

   2

   Copy to Clipboard Toggle word wrap

   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 タブで、削除するマシンプールの Options メニュー をクリックします。

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

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

手順

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

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

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap

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

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

手順

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

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   出力例

   ID           AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS    TAINTS    AVAILABILITY ZONE  SUBNET                    VERSION  AUTOREPAIR
   workers      No           2/2       m5.xlarge                          us-east-2a         subnet-0df2ec3377847164f  4.16.6   Yes
   db-nodes-mp  No           2/2       m5.xlarge                          us-east-2a         subnet-0df2ec3377847164f  4.16.6   Yes

   Copy to Clipboard Toggle word wrap

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

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

     $ rosa edit machinepool --cluster=<cluster_name> \
                             --labels=<key>=<value>,<key>=<value> \

     1

     
                             <machine_pool_id>

     Copy to Clipboard Toggle word wrap

     1

     <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

     Copy to Clipboard Toggle word wrap

     出力例

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

     Copy to Clipboard Toggle word wrap

検証

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

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

   Copy to Clipboard Toggle word wrap

   出力例

   ID:                            db-nodes-mp
   Cluster ID:                    <ID_of_cluster>
   Autoscaling:                   No
   Desired replicas:              2
   Current replicas:              2
   Instance type:                 m5.xlarge
   Labels:                        app=db, tier=backend
   Tags:
   Taints:
   Availability zone:             us-east-2a
   Subnet:                        subnet-0df2ec3377847164f
   Disk size:                     300 GiB
   Version:                       4.16.6
   EC2 Metadata Http Tokens:      optional
   Autorepair:                    Yes
   Tuning configs:
   Kubelet configs:
   Additional security group IDs:
   Node drain grace period:
   Management upgrade:
    - Type:                       Replace
    - Max surge:                  1
    - Max unavailable:            0
   Message:

   Copy to Clipboard Toggle word wrap

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

手順

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

検証

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

手順

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

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   出力例

   ID           AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS    TAINTS    AVAILABILITY ZONE  SUBNET                    VERSION  AUTOREPAIR
   workers      No           2/2       m5.xlarge                          us-east-2a         subnet-0df2ec3377847164f  4.16.6   Yes
   db-nodes-mp  No           2/2       m5.xlarge                          us-east-2a         subnet-0df2ec3377847164f  4.16.6   Yes

   Copy to Clipboard Toggle word wrap

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

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

     $ rosa edit machinepool --cluster=<cluster_name> \
                             --taints=<key>=<value>:<effect>,<key>=<value>:<effect> \

     1

     
                             <machine_pool_id>

     Copy to Clipboard Toggle word wrap

     1

     <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

     Copy to Clipboard Toggle word wrap

     出力例

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

     Copy to Clipboard Toggle word wrap

検証

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

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

   Copy to Clipboard Toggle word wrap

   出力例

   ID:                            db-nodes-mp
   Cluster ID:                    <ID_of_cluster>
   Autoscaling:                   No
   Desired replicas:              2
   Current replicas:              2
   Instance type:                 m5.xlarge
   Labels:
   Tags:
   Taints:                        key1=value1:NoSchedule, key2=value2:NoExecute
   Availability zone:             us-east-2a
   ...

   Copy to Clipboard Toggle word wrap

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

手順

1. OpenShift Cluster Manager に移動し、クラスターを選択します。
2. Machine pools タブで、自動修復を設定するマシンプールのオプションメニュー をクリックします。
3. メニューから Edit を選択します。
4. 表示される Edit Machine Pool ダイアログボックスから、AutoRepair オプションを見つけます。
5. AutoRepair の横にあるボックスを選択または選択解除して、有効または無効にします。
6. Save をクリックして、変更をマシンプールに適用します。

検証

1. Machine pools タブで、マシンプールの横にある > を選択して、ビューをデプロイメントします。
2. 展開ビューで、マシンプールの AutoRepair 設定が正しいことを確認します。

手順

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

   $ rosa list machinepools --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

   出力例

   ID           AUTOSCALING  REPLICAS  INSTANCE TYPE  LABELS    TAINTS    AVAILABILITY ZONE  SUBNET                    VERSION  AUTOREPAIR
   workers      No           2/2       m5.xlarge                          us-east-2a         subnet-0df2ec3377847164f  4.16.6   Yes
   db-nodes-mp  No           2/2       m5.xlarge                          us-east-2a         subnet-0df2ec3377847164f  4.16.6   Yes

   Copy to Clipboard Toggle word wrap

2. マシンプールで AutoRepair を有効または無効にします。

   • マシンプールの AutoRepair を無効にするには、次のコマンドを実行します。

     $ rosa edit machinepool --cluster=mycluster --machinepool=<machinepool_name>  --autorepair=false

     Copy to Clipboard Toggle word wrap

   • マシンプールの AutoRepair を有効にするには、次のコマンドを実行します。

     $ rosa edit machinepool --cluster=mycluster --machinepool=<machinepool_name>  --autorepair=true

     Copy to Clipboard Toggle word wrap

     出力例

     I: Updated machine pool 'machinepool_name' on cluster 'mycluster'

     Copy to Clipboard Toggle word wrap

検証

1. マシンプールの詳細情報を表示します。

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

   Copy to Clipboard Toggle word wrap

   出力例

   ID:                            machinepool_name
   Cluster ID:                    <ID_of_cluster>
   Autoscaling:                   No
   Desired replicas:              2
   Current replicas:              2
   Instance type:                 m5.xlarge
   Labels:
   Tags:
   Taints:
   Availability zone:             us-east-2a
   ...
   Autorepair:                    Yes
   Tuning configs:
   Kubelet configs:
   Additional security group IDs:
   Node drain grace period:
   Management upgrade:
    - Type:                               Replace
    - Max surge:                          1
    - Max unavailable:                    0

   Copy to Clipboard Toggle word wrap

2. 出力で、マシンプールの AutoRepair 設定が正しいことを確認します。

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

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

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

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

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

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

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

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

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

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

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

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