コネクションドレインを有効にする

コネクションドレインとは、仮想マシン（VM）インスタンスがインスタンスグループから削除されたときや、エンドポイントが範囲内のゾーンにあるネットワークエンドポイントグループ（NEG）から削除されたときに、既存の進行中リクエストを完了するための時間を確保するプロセスです。

このページの情報は、インスタンスグループと、範囲内のゾーンの次のタイプの NEG にのみ適用されます。

コネクションドレインを有効にするには、バックエンドサービスでコネクションドレインタイムアウトを設定します。タイムアウト時間は 0 秒以上、3,600 秒以下に設定してください。

指定されたタイムアウト時間の間、削除された VM またはエンドポイントに対する既存のリクエストに、完了するまでの時間が与えられます。ロードバランサは、削除された VM またはエンドポイントに新しい接続を送信しません。タイムアウト時間に達すると、ロードバランサは削除された VM またはエンドポイントへのすべてのトラフィックの送信を停止します。

次の操作を行うとコネクションドレインが開始されます。

手動でインスタンスグループから VM を削除した場合。
resize()、deleteInstances()、recreateInstances()、または abandonInstances() 呼び出しを実行して、マネージドインスタンスグループからインスタンスを削除した場合。
インスタンスグループがバックエンドサービスから削除された場合。これは、内部パススルーネットワークロードバランサではサポートされていません。
Google Cloud が自動スケーリングの一環としてインスタンスを削除した場合。
Managed Instance Group Updater を使用してマネージドインスタンスグループへの更新を実行した場合。
手動でゾーン NEG からエンドポイントを削除した場合。

指定したタイムアウト時間が経過してからインスタンスが終了するまで、最大で 60 秒かかります。

同じインスタンスグループや NEG を共有する複数のバックエンドサービスでコネクションドレインを有効にした場合は、最大のタイムアウト時間が使用されます。たとえば、同じインスタンスグループまたはゾーン NEG が 2 つのバックエンドサービスのバックエンドであり、一方のバックエンドサービスのコネクションドレインタイムアウトが 100 秒で、もう一方のバックエンドサービスのコネクションドレインタイムアウトが 200 秒であるとします。Google Cloud は有効なコネクションドレインのタイムアウトとして 200 秒を使用しているため、既存の接続は Google Cloud によって終了させられるまで 200 秒間存続できます。バックエンドがマネージドインスタンスグループの場合、インスタンスを削除するオペレーションは少なくとも 200 秒遅れます。

コネクションドレインの仕様の一覧は次のとおりです。

コネクションドレインは、次のロードバランサに属するバックエンドサービスで利用できます。
内部パススルーネットワークロードバランサと外部パススルーネットワークロードバランサの両方が、TCP、UDP（プレビュー）、および TCP 以外のその他のプロトコルのコネクションドレインをサポートしています。
コネクションドレインは、Cloud Service Mesh のデプロイメントに含まれるバックエンドサービスでも使用できます。
コネクションドレインのタイムアウトが設定されており、インスタンスがインスタンスグループから削除されるか、エンドポイントがゾーン NEG から削除された場合、Google Cloud ロードバランサと Cloud Service Mesh は次のように動作します。
- 削除されたインスタンスやエンドポイントに新しい接続は送信されません。
- 削除されたインスタンスまたはエンドポイントへの既存の接続をサポートするアクティブなセッションは、コネクションドレインに構成したタイムアウトが経過するまで維持されます。タイムアウト期間が終了すると、Google Cloud は削除されたインスタンスまたはエンドポイントの既存の接続を終了します。
コネクションドレインのタイムアウトを設定しない場合、またはコネクションドレインのタイムアウトがゼロ（0）に設定されている場合、Google Cloud は削除されたインスタンスまたはエンドポイント上の既存の接続をできるだけ早く終了します。
接続プールを使用している場合、以前に確立した接続を使用する新しいリクエストが、ドレインされている VM でまだ受信され、それらの VM が最終的に削除された際に接続エラーの原因になることがあります。

コネクションドレインを有効にするには、次の手順を完了します。

コンソール

ロードバランサの更新

Google Cloud コンソールの [ロードバランシング] ページに移動します。
[ロードバランシング] に移動
ロードバランサの [編集] をクリックするか、ロードバランサを新たに作成します。
[バックエンドの構成] をクリックします。
バックエンドサービスの最後にある「高度な構成」をクリックします。
[コネクションドレインのタイムアウト] フィールドに、0～3600 の値を入力します。0 を設定すると、コネクションドレインが無効になります。

Cloud Service Mesh を更新する

Google Cloud コンソールの [Cloud Service Mesh] ページに移動します。
Cloud Service Mesh に移動する
サービスの名前をクリックします。
サービスの最後にある「高度な構成」をクリックします。
[コネクションドレインのタイムアウト] フィールドに、0～3600 の値を入力します。0 を設定すると、コネクションドレインが無効になります。
[保存] をクリックします。

gcloud

--connection-draining-timeout フラグを使用して、新規または既存のバックエンドサービスでコネクションドレインを有効にします。次の例は、コネクションドレインのタイムアウト時間を変更する方法を示しています。

既存のグローバルロードバランサまたはクロスリージョンロードバランサの場合:

gcloud compute backend-services update BACKEND_SERVICE \
    --global \
    --connection-draining-timeout=CONNECTION_TIMEOUT_SECS

既存のリージョンロードバランサの場合:

gcloud compute backend-services update BACKEND_SERVICE \
    --region=REGION \
    --connection-draining-timeout=CONNECTION_TIMEOUT_SECS

プレースホルダを有効な値に置き換えます。

BACKEND_SERVICE: 更新するバックエンドサービス。
REGION: 更新するバックエンドサービスのリージョン（該当する場合）
CONNECTION_TIMEOUT_SECS: インスタンスまたはエンドポイントへの既存の接続を終了させるまで待機する秒数（0～3600 秒）。0 を設定すると、コネクションドレインが無効になります。コネクションドレインのタイムアウトは、バックエンドサービスのすべてのバックエンドに適用されます。

gcloud compute backend-services edit コマンドを使用して、既存のバックエンドサービスを更新することもできます。

API

インスタンスやエンドポイントを作成または更新するときに API でコネクションドレインを有効にするには、それぞれの API URI に対してリクエスト本文に connectionDraining フィールドを含めたリクエストを送信します。次の例は、既存のバックエンドサービスを編集してこの属性を設定する方法を示しています。他に必要となる属性については、各ロードバランサのドキュメントをご覧ください。

既存のグローバルロードバランサまたはクロスリージョンロードバランサの場合:

PATCH https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices