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

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

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

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

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

バックエンド（インスタンスグループまたはゾーン NEG）をロードバランサのバックエンドサービスから切断する場合、コネクションドレインは適用されません。

コネクションドレインの仕組み

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

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

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

コネクションドレインは、次のロードバランサに属するバックエンドサービスで利用できます。
内部パススルーネットワークロードバランサと外部パススルーネットワークロードバランサの両方が、TCP、UDP、および TCP 以外のその他のプロトコルのコネクションドレインをサポートしています。
コネクションドレインは、Cloud Service Mesh のデプロイメントに含まれるバックエンドサービスでも使用できます。
コネクションドレインのタイムアウトが設定されており、インスタンスがインスタンスグループから削除されるか、エンドポイントがゾーン NEG から削除された場合、Google Cloud ロードバランサと Cloud Service Mesh は次のように動作します。
- 削除されたインスタンスやエンドポイントに新しい接続は送信されません。
- アプリケーションロードバランサ: 指定されたタイムアウト時間の間、削除対象としてマークされた VM またはエンドポイントに対する既存のリクエストに、完了するまでの時間が与えられます。ロードバランサは、この VM またはエンドポイントに新しい接続を送信しません。タイムアウト時間に達すると、ロードバランサは削除された VM またはエンドポイントへのすべてのトラフィックの送信を停止します。
- プロキシネットワークロードバランサ: 指定されたタイムアウト時間の間、削除対象としてマークされた VM またはエンドポイントに対する既存の TCP 接続は、構成されたコネクションドレイン期間中、引き続き機能します。ロードバランサは、この VM またはエンドポイントに新しい接続を送信しません。タイムアウト時間に達すると、削除された VM またはエンドポイントへの既存の TCP 接続はアクティブな状態が維持され、プロキシはデフォルトのアイドルタイムアウトである 10 分以内に既存の TCP 接続をすべて閉じます。
- パススルーネットワークロードバランサ: コネクションドレインのタイムアウトの指定された期間、既存の接続に属するパケットは、削除対象としてマークされた VM またはエンドポイントに転送されます。タイムアウト時間に達すると、削除された VM またはエンドポイントの conntrack エントリが削除されます。既存の接続からの SYN 以外のパケットは、正常なバックエンドの新しい conntrack エントリの作成につながります。パケットが新しい正常なバックエンドに送信されると、バックエンドには受信したパケットの記録がないため、クライアントに RST を送信します。内部パススルーネットワークロードバランサと外部パススルーネットワークロードバランサ自体は、コネクションドレインのタイムアウトが切れた後に既存の接続を終了するために TCP-RST または TCP-FIN を送信しません。
同じインスタンスグループや NEG を共有する複数のバックエンドサービスでコネクションドレインを有効にした場合は、最大のタイムアウト時間が使用されます。たとえば、同じインスタンスグループまたはゾーン NEG が 2 つのバックエンドサービスのバックエンドであり、一方のバックエンドサービスのコネクションドレインタイムアウトが 100 秒で、もう一方のバックエンドサービスのコネクションドレインタイムアウトが 200 秒であるとします。 Google Cloud は、終了する前に有効なコネクションドレインのタイムアウトとして 200 秒を使用します。バックエンドがマネージドインスタンスグループの場合、インスタンスを削除するオペレーションは少なくとも 200 秒遅れます。
コネクションドレインのタイムアウトを設定しない場合、またはコネクションドレインのタイムアウトがゼロ（0）に設定されている場合、 Google Cloud は削除されたインスタンスまたはエンドポイント上の既存の接続をできるだけ早く終了します。
接続プールを使用している場合、以前に確立した接続を使用する新しいリクエストが、ドレインされている VM でまだ受信され、それらの VM が最終的に削除された際に接続エラーの原因になることがあります。

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

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

コンソール

ロードバランサを更新する

Google Cloud コンソールで [ロードバランシング] ページに移動します。
[ロードバランシング] に移動
[ロードバランサ] タブで、更新するロードバランサの more_vert をクリックし、[編集] をクリックします。
[バックエンドの構成] をクリックします。
[バックエンドの構成] ペインで、をクリックします。
[バックエンドサービスの編集] ペインの下部にある [高度な構成] をクリックします。
[コネクションドレインのタイムアウト] フィールドに、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
```
注: 従来のアプリケーションロードバランサと従来のプロキシネットワークロードバランサは、常に「グローバル」バックエンドサービスを使用します。これはロードバランサの設定でネットワークにスタンダードティアを使用しているため、バックエンドの配置先が 1 つのリージョンのみである場合でも変わりません。

既存のリージョンロードバランサの場合:
```
PATCH https://www.googleapis.com/compute/v1/projects/PROJECT_ID/region/REGION/backendServices

{
   "name": "BACKEND_SERVICE",
   "connectionDraining": {
     "drainingTimeoutSec": CONNECTION_TIMEOUT_SECS
   }
}
```
次のように置き換えます。
- PROJECT_ID: ロードバランサまたは Cloud Service Mesh のデプロイを含むプロジェクト ID。
- BACKEND_SERVICE: ロードバランサまたは Cloud Service Mesh のデプロイで使用されるバックエンドサービス。
- CONNECTION_TIMEOUT_SECS: インスタンスグループまたは NEG からインスタンスまたはエンドポイントを削除させるまで待機する秒数（0～3,600 秒）。このタイムアウト時間は、バックエンドサービスによって参照されるすべてのインスタンスグループまたは NEG に適用されます。

次のステップ

バックエンドサービスの全般的な情報については、バックエンドサービスの概要をご覧ください。

コネクション ドレインを有効にする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

コネクション ドレインの仕組み

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

コンソール

ロードバランサを更新する

Cloud Service Mesh を更新する

gcloud

API

次のステップ

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

コネクションドレインの仕組み

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