翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Beanstalk クラスター環境のスケーリング

Beanstalk クラスター環境は、実行するアプリケーションのレプリカの数を変更することでスケールされます。レプリカは、コンテナイメージのコピーを実行している 1 つです。Amazon EKS は、それらのレプリカに必要なノード容量を提供し、それらに合わせてノードを追加または削除するため、インスタンスのフリートではなくアプリケーションのサイズを設定します。

これは、Amazon EC2 インスタンスの Auto Scaling グループをスケールする Beanstalk Standard との主な違いです。aws:autoscaling:* 名前空間は Beanstalk クラスター環境には適用されません。スケーリングは、代わりに aws:elasticbeanstalk:eks:environment:autoscaling名前空間とその子名前空間を介して設定されます。すべてのオプションとその受け入れられる値については、「」を参照してくださいBeanstalk クラスター環境の設定オプション。

レプリカの境界の設定

レプリカ数には、 min-replicaと の 2 つのオプションがありmax-replica、どちらもaws:elasticbeanstalk:eks:environment:autoscaling名前空間にあります。Elastic Beanstalk は、それらの間のレプリカ数を維持します。

固定数のレプリカを実行するには、両方のオプションを同じ値に設定します。よりmax-replica高く設定min-replicaすると、環境が 2 つの間でスケールされます。は最小値1として min-replica を受け入れるため、環境は常に少なくとも 1 つのレプリカを実行します。

$ aws elasticbeanstalk update-environment \
    --environment-name my-cluster-env \
    --option-settings \
        Namespace=aws:elasticbeanstalk:eks:environment:autoscaling,OptionName=min-replica,Value=2 \
        Namespace=aws:elasticbeanstalk:eks:environment:autoscaling,OptionName=max-replica,Value=20

Elastic Beanstalk がスケーリングするタイミングを決定する方法

これらの境界内では、1 つ以上のトリガーがレプリカ数を決定します。Elastic Beanstalk は、 がpolling-interval設定した間隔でトリガーを評価します。トリガーがレポートアクティビティを停止すると、Elastic Beanstalk は環境をスケールダウンする前に がcooldown-period設定した期間待機します。これにより、再び必要になるレプリカが短時間で削除されなくなります。

トリガーをまったく設定しない場合、環境はレプリカの CPU 使用率に基づいてスケールされます。残りのセクションでは、代わりに設定できるトリガーについて説明します。

CPU またはメモリでのスケーリング

レプリカが消費するリソースをスケールオンするには、aws:elasticbeanstalk:eks:environment:autoscaling:trigger名前空間にメトリクスタイプとターゲット値を設定します。Elastic Beanstalk は、設定したターゲットの近くに環境を保持するためのレプリカを追加または削除します。

のメトリクスタイプは、 cpuおよび memoryオプションを通じてレプリカが予約する値の割合としてUtilization値を扱うため、 cpu-valueの は予約された CPU の 75% を75ターゲットにします。のメトリクスタイプは、値をレプリカあたりの絶対量としてAverageValue扱います。

CPU トリガーとメモリトリガーの両方を 1 つの環境で設定できます。

$ aws elasticbeanstalk update-environment \
    --environment-name my-cluster-env \
    --option-settings \
        Namespace=aws:elasticbeanstalk:eks:environment:autoscaling:trigger,OptionName=cpu-metric-type,Value=Utilization \
        Namespace=aws:elasticbeanstalk:eks:environment:autoscaling:trigger,OptionName=cpu-value,Value=75

スケジュールに基づくスケーリング

定期的な時間枠中に選択した数のレプリカを実行するには、 scaler-typeを に設定cronし、 でウィンドウを記述します。これによりscaler-metadata、4 つのフィールドを持つ JSON オブジェクトが取得されます。

ウィンドウの外では、環境は に戻りますmin-replica。次の例では、UTC で平日の勤務時間中に 5 つのレプリカを実行します。

$ cat schedule.json
[
  {
    "Namespace": "aws:elasticbeanstalk:eks:environment:autoscaling:trigger",
    "OptionName": "scaler-type",
    "Value": "cron"
  },
  {
    "Namespace": "aws:elasticbeanstalk:eks:environment:autoscaling:trigger",
    "OptionName": "scaler-metadata",
    "Value": "{\"timezone\":\"UTC\",\"start\":\"0 8 * * 1-5\",\"end\":\"0 18 * * 1-5\",\"desiredReplicas\":\"5\"}"
  }
]
$ aws elasticbeanstalk update-environment \
    --environment-name my-cluster-env \
    --option-settings file://schedule.json

環境は 1 つのスケジュールに従います。異なる週末スケジュールなど、複数のウィンドウでレプリカ数を変更するには、「」で説明されているように、スケジュールを別のトリガーと組み合わせてくださいトリガーの組み合わせ。

独自のエンドポイントからのメトリクスのスケーリング

キューの深さや処理中のジョブの数など、独自のサービスが報告する値をスケールアップするには、 scaler-typeを に設定しますmetrics-api。Elastic Beanstalk は、指定した HTTP エンドポイントを読み取り、そこで見つかった数値に基づいてスケーリングします。でエンドポイントを記述しますscaler-metadata。

Elastic Beanstalk は、報告された値を で除算targetValueし、切り上げてレプリカ数を取得し、その数をレプリカの境界内に保持します。targetValue が の場合100、報告された の値は 5 つのレプリカを要求500します。

トリガーは独自の環境にポイントできます。環境の URL は起動後にのみ認識されるため、作成時ではなくurl更新時に を設定します。

次の例では、アプリケーションが報告する深さに基づいてスケールし、報告された作業の 100 ユニットごとに 1 つのレプリカを使用します。

$ cat trigger.json
[
  {
    "Namespace": "aws:elasticbeanstalk:eks:environment:autoscaling:trigger",
    "OptionName": "scaler-type",
    "Value": "metrics-api"
  },
  {
    "Namespace": "aws:elasticbeanstalk:eks:environment:autoscaling:trigger",
    "OptionName": "scaler-metadata",
    "Value": "{\"url\":\"https://my-service.example.com/queue-depth\",\"valueLocation\":\"data.result.0.value\",\"targetValue\":\"100\"}"
  }
]
$ aws elasticbeanstalk update-environment \
    --environment-name my-cluster-env \
    --option-settings file://trigger.json

エンドポイントへの認証

エンドポイントに認証情報が必要な場合は、それらを AWS Secrets Manager シークレットに保存し、シークレットの ARN scaler-auth-secretに設定します。scaler-type が の場合にのみ設定できますmetrics-api。エンドポイントが想定するスキームscaler-auth-modeに設定します。シークレットの値は、そのスキームに依存するキーを持つ JSON オブジェクトです。

環境application-roleのオプションも設定します。Elastic Beanstalk は、 application-roleが設定されている場合にのみ存在する環境の Pod Identity を介して認証情報をレプリカにマウントします。これがないと、マウントは失敗し、レプリカは起動しません。スケジュールトリガーはそれを必要としません。また、認証情報を必要としないメトリクスエンドポイントも必要としません。

環境のアプリケーションロールはシークレットを読み取るため、シークレットの ARN secretsmanager:DescribeSecretで secretsmanager:GetSecretValueと の両方を付与します。Elastic Beanstalk は、スケジュールに従って認証情報を更新し、更新によってシークレットの最新バージョンがチェックされるため、付与された環境は正常にGetSecretValueのみ開始され、それ以降の更新ごとに失敗します。Beanstalk クラスター環境が使用するロールについては、「」を参照してくださいBeanstalk クラスターのアクセス許可。

このシークレットは、アプリケーションにシークレットを提供する secretsオプションとは別のものです。の値を変更すると、レプリカの起動時に認証情報がマウントされるため、環境のレプリカがscaler-auth-secret置き換えられます。

トリガーの組み合わせ

環境は、スケジュールまたはエンドポイントメトリクスのいずれかのイベント駆動型トリガーを 1 つ受け取ります。これは、 scaler-typeと が 1 つのトリガーをscaler-metadata記述するためです。CPU とメモリのトリガーをそのトリガーと一緒に持ち込むことができます。

2 つの動作を組み合わせる前に知る価値があります。

スケジュールと CPU トリガーをペアリングすることは一般的な組み合わせです。スケジュールはビジー時間中に予想されるレプリカ数を保持し、CPU トリガーは残りの時間利用可能のままです。

環境スケールの監視

Elastic Beanstalk コンソールの環境のモニタリングページには、アプリケーションのレプリカ数グラフが表示されます。このグラフは、環境が時間の経過とともに実行されているレプリカを報告します。CPU (コア) グラフとメモリ (バイト) グラフと比較すると、トリガーがターゲットを保持しているかどうかがわかります。Beanstalk クラスター環境が報告するヘルスとメトリクスについては、「」を参照してくださいBeanstalk クラスター環境のモニタリング。

Elastic Beanstalk はスケーリング設定を変更すると環境イベントを記録するため、環境のイベントストリームにはスケーリング変更が有効になった日時が表示されます。