ECS デプロイの Pause & Continue を試す — 本番リリースに「確認ポイント」を挟む

2026.09.04
ECS デプロイの Pause & Continue を試す — 本番リリースに「確認ポイント」を挟む
この記事をシェアする

2026 年 5 月に追加された Amazon ECS のデプロイ一時停止機能(Pause & Continue)を、Blue-Green と Canary の両方で検証しました。デプロイのどこで止まるか、止まっている間に何が起きているか、Continue / Rollback / 放置のそれぞれで何秒かかるかを実測しました。あわせて CDK での設定方法と CI/CD への組み込み方をまとめます。

この記事の要約

  • Pause フックを使うと、新バージョンのタスクが起動し終わった時点でデプロイが止まる。本番トラフィックは旧バージョンのまま、テストリスナー経由で新バージョンを叩いて確認してから Continue できる
  • Continue から完了まで約 2 分、Rollback は 1 分未満。放置した場合は設定したタイムアウトちょうどに自動 Rollback が走る
  • 前回記事の課題「手動ロールバック後に CloudFormation が 17〜20 分止まる」は解消。Pause フック経由の Rollback なら約 2〜3 分で UPDATE_ROLLBACK_COMPLETE になり、Lambda なしで IaC の状態を壊さずに戻せる
  • Canary では 25% シフト前と 100% シフト前の 2 回止まり、hookId は毎回変わる。5 秒おきに API を叩く 50 行ほどのスクリプトで検知 3〜5 秒、無人で完走できた
  • CDK L2 には Pause フック用の Construct がまだなく、L1 エスケープハッチで設定する

1. Pause & Continue とは

前回記事の続きとして

前回の記事(ECS ビルトインデプロイ戦略を全比較)では、Blue-Green / Canary / Linear に Circuit Breaker が使えないことを書きました。デプロイを自動でロールバックさせるには、ライフサイクルフック Lambda の実装が必要でした。Lambda を書かないと、ヘルスチェックに失敗したデプロイは宙ぶらりんで止まります。StopServiceDeployment で手動ロールバックした後は、CloudFormation スタックが 17〜20 分止まるという課題も残っていました。

Pause & Continue は、この「Lambda を書くほどではないが、一旦止めて人が見てから進めたい」というニーズに対する答えです。この記事では前回と同じ構成に Pause フックを足し、実際に止めて確認したうえで 3 パターン(進める、戻す、放置する)を試します。

Pause フックの仕組み

ECS のサービスデプロイには、デプロイの各段階でフックを差し込める「デプロイライフサイクルフック」があります。これまでのフックのターゲットは Lambda だけでした。2026 年 5 月 19 日に PAUSE というターゲットタイプが追加され、Lambda を書かずに「この段階で一旦止める」を宣言できるようになりました。追加料金はありません。

止まったデプロイは ContinueServiceDeployment API で再開(CONTINUE)するか、戻す(ROLLBACK)かを選びます。何もしなければ、フックに設定したタイムアウト(デフォルト 24 時間、最長 14 日)の後に ROLLBACK か CONTINUE のどちらか指定した方が自動で実行されます。

Pause を置けるライフサイクルステージ

Pause フックは以下の 6 つのステージに置けます。

ステージタイミング
RECONCILE_SERVICE過去のデプロイの残りタスクを整理した後
PRE_SCALE_UP新バージョンのタスクを起動する前
POST_SCALE_UP新バージョンのタスクが起動しヘルシーになった後
POST_TEST_TRAFFIC_SHIFTテストリスナーのトラフィックを新バージョンに切り替えた後
PRE_PRODUCTION_TRAFFIC_SHIFT本番トラフィックを切り替える前
POST_PRODUCTION_TRAFFIC_SHIFT本番トラフィックを切り替えた後(bake time の前)

TEST_TRAFFIC_SHIFT と PRODUCTION_TRAFFIC_SHIFT の 2 つは Lambda フック専用で、Pause は置けません。1 サービスあたり Pause フック 10 個、Lambda フック 10 個まで設定できます。Rolling / Blue-Green / Canary / Linear の 4 戦略すべてで使えます。

2. 検証構成

前回記事の CDK 構成をベースに、Pause フックとテストリスナーを追加しました。

インフラ:

  • Fargate(256 CPU / 512 MiB)、desiredCount=2
  • ALB(internet-facing)。80 番が本番リスナー、8080 番がテストリスナー。ヘルスチェック間隔 10 秒
  • CDK v2.268(TypeScript)。ベースインフラ(VPC / ALB)とサービスを別スタックに分離
  • EventBridge ルールで ECS Hook State Change イベントを CloudWatch Logs に保存

アプリケーション:

パブリックイメージ python:3.12-slim にインラインの Python HTTP サーバーを載せています。/ でバージョン番号を JSON で返し、/health で 200 を返します。

デプロイ設定:

パラメータ値
deploymentStrategyBLUE_GREEN または CANARY(stepPercent=25, stepBakeTime=1 分)
bakeTime1 分
Pause フックのステージPRE_PRODUCTION_TRAFFIC_SHIFT(一部 POST_SCALE_UP)
Pause フックのタイムアウト60 分 / ROLLBACK(タイムアウト検証では 5 分)

Pause 中の状態は、ALB に curl を投げてレスポンスの version を数える方法と、ECS と ELB の describe 系 API で確認しました。

デプロイは v1 から v9 まで検証順に 9 回行いました。本文中のバージョン番号はその通し番号です。

3. Blue-Green で止めて確認する

3-1. Pause 中に何が起きているか

v7 が稼働しているサービスに v8 をデプロイしました。デプロイ開始から 2 分 16 秒後、PRE_PRODUCTION_TRAFFIC_SHIFT で止まりました。コンソールを開くと、サービス画面の上に黄色いバナーが出ます。

デプロイがアクションを待機しています、と表示された ECS サービス画面

このとき、内部はこうなっています。

観点状態
タスク4 つ(v7 が 2 つ、v8 が 2 つ)。すべて RUNNING
ターゲットグループv7 側も v8 側も 2 ターゲットが healthy
本番リスナー(:80)100% v7
テストリスナー(:8080)100% v8
デプロイのステータスIN_PROGRESS

見てほしいのは、新バージョンのタスクは起動してヘルスチェックも通っているのに、本番トラフィックは 1 リクエストも流れていないことです。テストリスナーに向けて curl を 10 回投げるとすべて v8、本番リスナーに 10 回投げるとすべて v7 でした。

$ for i in $(seq 1 10); do curl -s http://$ALB/      | jq -r .version; done | sort | uniq -c
     10 v7
$ for i in $(seq 1 10); do curl -s http://$ALB:8080/ | jq -r .version; done | sort | uniq -c
     10 v8

Pause で止めてやりたいのは、この確認です。本番に影響を出さずに新バージョンの動作を叩いて確かめ、問題なければ Continue、まずければ Rollback できます。

デプロイタブを見ると、タイムラインが「テストトラフィック移行」まで進んで「本番トラフィック移行」の手前で待っているのが分かります。

デプロイタイムラインが一時停止フックで止まっている画面

3-2. 状態の取得と Continue / Rollback

CLI では、まず進行中のデプロイ ARN を取り、lifecycleHookDetails から hookId を読みます。

DEPLOY_ARN=$(aws ecs list-service-deployments \
  --cluster "$CLUSTER" --service "$SERVICE" \
  --query 'serviceDeployments[?status==`IN_PROGRESS`].serviceDeploymentArn' --output text)

aws ecs describe-service-deployments --service-deployment-arn "$DEPLOY_ARN" \
  --query 'serviceDeployments[0].lifecycleHookDetails'
[
    {
        "hookId": "ecs-pause-hSLfDQrYQiWdEfOhpxLKdwQsAe7En0kYgjKhfpDSWdg",
        "targetType": "PAUSE",
        "status": "AWAITING_ACTION",
        "expiresAt": "2026-09-03T09:57:29.024000+00:00",
        "timeoutAction": "ROLLBACK"
    }
]

進めるか戻すかは continue-service-deployment の --action で決めます。デプロイ ARN と hookId の両方が必須です。

aws ecs continue-service-deployment \
  --service-deployment-arn "$DEPLOY_ARN" \
  --hook-id "$HOOK_ID" \
  --action CONTINUE    # または ROLLBACK

コンソールなら、バナーの「アクションを実行する」を押すとダイアログが出ます。残り時間のバーと「続行 / ロールバック」の選択肢があります。

一時停止フックでアクションを実行するダイアログ

3-3. Continue と Rollback の所要時間

Continue すると本番リスナーの重みが一括で v8 に切り替わり、bake time(1 分)の後に v7 のタスクが止まります。Rollback すると新バージョンのタスクが止まり、旧バージョンはそのまま残ります。Blue-Green の場合、トラフィックはもともと旧バージョンにしか流れていないので、Rollback でトラフィックが動くことはありません。

操作開始から Pause まで操作から完了まで結果
Continue(v1→v2)1 分 06 秒2 分 06 秒SUCCESSFUL
Rollback(v2→v3)1 分 35 秒54 秒ROLLBACK_SUCCESSFUL
Continue(v7→v8、テストリスナーあり)2 分 16 秒1 分 59 秒SUCCESSFUL

開始から Pause までの 1〜2 分は、新タスクの起動とヘルスチェック通過にかかる時間です。Continue 後の約 2 分は「トラフィック切り替え + bake 1 分 + 旧タスク停止」で、bake time を長くすればその分伸びると考えてください。

Continue 後に完了したデプロイタイムライン

3-4. どのステージで止めるか

POST_SCALE_UP でも止めてみましたが、PRE_PRODUCTION_TRAFFIC_SHIFT と観測できる違いはありませんでした。タスク 4 つ、新バージョン側のターゲットグループは healthy、本番トラフィックは 100% 旧バージョン、という同じ状態です。

2 つのステージの間にあるのは「テストトラフィック移行」だけなので、テストリスナーがない構成では差が出ません。テストリスナーがある構成なら、PRE_PRODUCTION_TRAFFIC_SHIFT で止めるとテストリスナーがすでに新バージョンを向いている状態で確認できます。テストリスナーを使うなら PRE_PRODUCTION_TRAFFIC_SHIFT、使わないならどちらでも同じ、と覚えておけば十分です。

4. Canary で段階ごとに止める

Canary(stepPercent=25)に PRE_PRODUCTION_TRAFFIC_SHIFT の Pause を置くと、25% シフトの前と 100% シフトの前の 2 回止まります。

時刻イベント状態
0:00デプロイ開始
1:281 回目の Pause本番 100% 旧、タスク 4
2:02Continue → 25% シフト → canary bake 1 分
3:382 回目の Pauseリスナー重み 旧 750 / 新 250
9:14Continue → 100% シフト → bake 1 分
11:34完了本番 100% 新、タスク 2

2 回目の Pause 中に curl を 40 回投げたところ、9 回が新バージョンに流れていました。25% のトラフィックを流したまま止まっているので、カナリアの結果を人が見てから全量に進むか戻すかを決められます。

注意したいのは、2 回の Pause で hookId が別になることです。1 回目の hookId で Continue しても 2 回目は再び待ちになるので、毎回 describe-service-deployments で取り直す必要があります。もう一点、lifecycleHookDetails に載るのは「今待っているフック」だけで、Continue 済みのフックは配列から消え、デプロイ完了後は空になります。履歴を残したい場合は後述の EventBridge イベントを使ってください。

5. 放置したらどうなるか

タイムアウトを 5 分、アクションを ROLLBACK にして、Pause したまま何もしませんでした。

時刻イベント
07:18:38デプロイ開始
07:20:03Pause(expiresAt = 07:25:03)
07:25:03HOOK_TIMED_OUT
07:25:44ROLLBACK_SUCCESSFUL

expiresAt の時刻ちょうどにタイムアウトし、41 秒で旧バージョンに戻りました。statusReason には次のように記録されます。

Service deployment rolled back because PRE_PRODUCTION_TRAFFIC_SHIFT lifecycle hook(s) failed. Timed out waiting for hook ecs-pause-… to be notified.

デフォルトのタイムアウトは 24 時間、アクションは ROLLBACK です。承認を忘れて放置しても、翌日には勝手に戻っています。ただし Pause 中は新旧両方のタスクが動いているので、タイムアウトを長くするほど待機中のコストは覚悟しておいてください。

6. CloudFormation から見た Rollback

ここが前回記事からの一番大きな進歩です。Pause フック経由の Rollback は、手動とタイムアウトのどちらの場合も、CloudFormation では「AWS::ECS::Service の更新失敗」として扱われます。

デプロイECS の Rollback 完了CFn が UPDATE_ROLLBACK_COMPLETE差
手動 Rollback06:23:4906:26:112 分 22 秒
タイムアウト07:25:4407:28:232 分 39 秒

スタックイベントには次のエラーが記録され、スタックのテンプレートは旧バージョンの内容に戻ります。

Resource handler returned message: "Error occurred during operation 'ECS Deployment hook execution failure(s) detected'."

前回記事では StopServiceDeployment で手動ロールバックした後、CFn スタックが UPDATE_IN_PROGRESS のまま 17〜20 分止まりました。Pause フックの Rollback なら 2〜3 分で片付き、IaC の状態と実態がズレません。次の cdk deploy をそのまま打てます。

ちなみに、ロールバックで終わった cdk deploy の出力には、失敗したタスクのログ(Starting server version=v6)が自動で表示されました。ロールバックの原因を追うときに、コンソールを開かずに済みます。

7. CI/CD に組み込む

7-1. EventBridge で通知する

Pause の状態が変わるたびに、EventBridge に ECS Hook State Change イベントが飛びます。

{
  "source": ["aws.ecs"],
  "detail-type": ["ECS Hook State Change"]
}

イベントの detail は以下の形です。

{
  "eventType": "INFO",
  "eventName": "HOOK_AWAITING_ACTION",
  "hookId": "ecs-pause-...",
  "hookType": "PAUSE",
  "expiresAt": "2026-09-03T07:25:03.256Z",
  "lifecycleStage": "PRE_PRODUCTION_TRAFFIC_SHIFT",
  "clusterArn": "...",
  "serviceArn": "...",
  "serviceDeploymentArn": "..."
}

eventName と操作の対応は次のとおりです。

操作eventName
Pause したHOOK_AWAITING_ACTION
Continue したHOOK_SUCCEEDED
手動で Rollback したHOOK_FAILED
タイムアウトしたHOOK_TIMED_OUT

手動 Rollback に専用のイベント名はなく HOOK_FAILED になる点と、すべて eventType が INFO である点に注意してください。アラートの条件は eventName で書きます。HOOK_AWAITING_ACTION を SNS や Slack に流せば、Lambda なしで「承認待ち通知」が作れます。

7-2. 自動 Continue スクリプト

E2E テストを通してから自動で Continue する、というパイプラインを想定して、Pause を検知して Continue するループを書きました。Canary のように複数回止まる場合も、hookId を毎回取り直して対応します。

while true; do
  STATUS=$(aws ecs describe-service-deployments --service-deployment-arn "$DEPLOY_ARN" \
             --query 'serviceDeployments[0].status' --output text)
  [ "$STATUS" != "IN_PROGRESS" ] && { echo "finished: $STATUS"; break; }

  while read -r HOOK_ID EXPIRES_AT; do
    [ -z "$HOOK_ID" ] && continue
    # ここで E2E テストを実行し、失敗なら --action ROLLBACK にする
    aws ecs continue-service-deployment --service-deployment-arn "$DEPLOY_ARN" \
      --hook-id "$HOOK_ID" --action CONTINUE
  done < <(aws ecs describe-service-deployments --service-deployment-arn "$DEPLOY_ARN" \
             --query "serviceDeployments[0].lifecycleHookDetails[?status=='AWAITING_ACTION'].[hookId,expiresAt]" \
             --output text)
  sleep 5
done

Canary(25%)の v9 デプロイをこのスクリプトに任せた結果です。

時刻イベント検知までの遅延
09:27:11デプロイ開始
09:29:231 回目の Pause5 秒
09:31:022 回目の Pause3 秒
09:33:00完了(開始から 5 分 49 秒)
  • 5 秒間隔のポーリングで、Pause から数秒で検知できる。API 側の反映遅延は感じなかった
  • 必要な IAM アクションは 3 つ。ecs:ListServiceDeployments、ecs:DescribeServiceDeployments、ecs:ContinueServiceDeployment
  • --action ROLLBACK に切り替えれば、テスト失敗時に自動で戻せる。Lambda フックを書かなくても、パイプライン側でロールバック判定ができる

8. CDK での実装ポイント

8-1. Pause フックは L1 エスケープハッチで設定する

CDK v2.268 時点で、L2 の aws-ecs にあるライフサイクルフック用のクラスは DeploymentLifecycleLambdaTarget だけです。Pause 用のクラスはまだありません。CloudFormation の AWS::ECS::Service 自体は TargetType: PAUSE に対応しています。そこで、L2 で作ったサービスの L1 リソースに addPropertyOverride で書き込みます。

const service = new ecs.FargateService(this, 'Service', {
  cluster,
  taskDefinition: taskDef,
  desiredCount: 2,
  deploymentStrategy: ecs.DeploymentStrategy.BLUE_GREEN,
  bakeTime: cdk.Duration.minutes(1),
});

// CDK L2 に Pause フック用クラスがないため L1 に直接書く
const cfnService = service.node.defaultChild as ecs.CfnService;
cfnService.addPropertyOverride('DeploymentConfiguration.LifecycleHooks', [
  {
    TargetType: 'PAUSE',
    LifecycleStages: ['PRE_PRODUCTION_TRAFFIC_SHIFT'],
    TimeoutConfiguration: {
      Action: 'ROLLBACK',
      TimeoutInMinutes: 60,
    },
  },
]);
  • TargetType: 'PAUSE' のときは HookTargetArn と RoleArn は不要
  • LifecycleStages は配列なので、複数のステージに同じ Pause を置ける
  • Pause 用のターゲットクラスが追加されれば、既存の addLifecycleHook() へそのまま渡せるはず。追加されたかは CDK のリリースノートで確認する

8-2. テストリスナーの配線

テストリスナーは、ALB にリスナーをもう 1 本足し、そのリスナーにも加重フォワードのルールを作って AlternateTarget の testListener に渡します。

// BaseStack: 8080 番のテストリスナー
this.testListener = this.alb.addListener('TestListener', {
  port: 8080,
  protocol: elbv2.ApplicationProtocol.HTTP,
  open: true,
  defaultAction: elbv2.ListenerAction.fixedResponse(404),
});

// ServiceStack: テストリスナー用ルール(本番ルールと同じく blue=100 / green=0)
const testRule = new elbv2.ApplicationListenerRule(this, 'TestRule', {
  listener: props.testListener,
  priority: 10,
  conditions: [elbv2.ListenerCondition.pathPatterns(['/*'])],
  action: elbv2.ListenerAction.weightedForward([
    { targetGroup: blueTG, weight: 100 },
    { targetGroup: greenTG, weight: 0 },
  ]),
});

const target = service.loadBalancerTarget({
  containerName: 'app',
  containerPort: 8080,
  alternateTarget: new ecs.AlternateTarget('Alt', {
    alternateTargetGroup: greenTG,
    productionListener: ecs.ListenerRuleConfiguration.applicationListenerRule(prodRule),
    testListener: ecs.ListenerRuleConfiguration.applicationListenerRule(testRule),
  }),
});
target.attachToApplicationTargetGroup(blueTG);
  • ECS はデプロイの TEST_TRAFFIC_SHIFT でこのルールの重みを新バージョン側に書き換える。ECS 用のロールには CDK が AmazonECSInfrastructureRolePolicyForLoadBalancers を付けるので、追加の権限設定は不要だった
  • テストリスナーは本番と同じ ALB の別ポートで十分。検証では open: true にしたが、実運用では社内 IP や VPN からだけ届くようにセキュリティグループを絞る

9. ハマりポイント

初回デプロイでも Pause が発火する

サービスを新規作成する CDK デプロイでも、PRE_PRODUCTION_TRAFFIC_SHIFT の Pause は発火します。cdk deploy はスタック作成中のまま待ち続け、コンソールには黄色いバナーが出ます。検証では 50 分放置しても CloudFormation はタイムアウトしませんでした。ただし放置し続けると、フックのタイムアウト(デフォルト 24 時間)で ROLLBACK され、スタック作成が失敗すると考えられます。初回は手動で Continue するか、初回だけ Pause フックなしでデプロイしてください。

テストリスナーを後から足したデプロイでは、テストシフトが効かない

すでに稼働しているサービスに、テストリスナーのルールと新バージョンを同じデプロイで追加すると、そのデプロイではテストリスナーの重みが書き換わりませんでした。Pause 中にテストリスナーを叩いても旧バージョンが返ります。デプロイ元のリビジョンに testListenerRule がないためと考えられます。次のデプロイからは期待どおり動きました。テストリスナーを足す変更と、確認したいアプリの変更は、別のデプロイに分けてください。

Canary / Linear は Pause が複数回発火し、hookId が毎回変わる

4 章で触れたとおりです。自動化する場合は、1 回 Continue して終わりにせず、デプロイが IN_PROGRESS でなくなるまで describe-service-deployments を回してください。検証では 2 つの hookId の末尾 22 文字が同じで、先頭部分だけが違っていました。末尾だけ見て同じフックと判断しないでください。

lifecycleHookDetails に載るのは現在のフックだけ

Continue 済みのフックは describe-service-deployments の結果から消えます。デプロイ完了後は空配列です。いつ誰が Continue したかを残したい場合は、EventBridge のイベントを CloudWatch Logs に保存しておきます。

Blue / Green の役割はデプロイのたびに入れ替わる

CDK で最初に attachToApplicationTargetGroup した側が「Blue」ですが、デプロイが成功するたびに本番トラフィックを持つターゲットグループは入れ替わります。検証では初回デプロイの新バージョンが Green に入り、その後は Blue → Green → Blue と交互になりました。コンソールのターゲット正常性にも、Blue という名前のターゲットグループに「緑」のラベルが付いています。名前で本番側を判断せず、「本番トラフィック」のラベルかリスナールールの重みで見てください。

さいごに

ECS のデプロイ Pause & Continue を、Blue-Green と Canary で実際に止めて確認して進めるところまで試しました。

  • Pause フックは、新バージョンのタスクが起動した状態で止めてくれる。テストリスナーを用意しておけば、本番トラフィックを動かさずに新バージョンを叩いて確認できる
  • Continue から完了まで約 2 分、Rollback は 1 分未満。放置すればタイムアウトちょうどに自動で戻る
  • Pause フック経由の Rollback なら CloudFormation も 2〜3 分で UPDATE_ROLLBACK_COMPLETE になる。前回記事で残った「手動ロールバック後に CFn が 20 分止まる」問題は、Pause フックを置くだけで解消する
  • EventBridge のイベントと ContinueServiceDeployment API だけで、承認待ち通知と自動 Continue の両方を組める。Lambda フックを書く前に、まず Pause で足りるか検討する価値がある
  • CDK L2 は未対応なので、当面は L1 エスケープハッチで設定する

前回記事では「Blue-Green / Canary / Linear は自動ロールバックに Lambda が要る」と書きました。Pause フックがあれば、「人か CI が判断して戻す」という運用を Lambda なしで作れます。すでに Blue-Green や Canary を使っている方は、PRE_PRODUCTION_TRAFFIC_SHIFT に Pause を 1 つ置くところから試してみてください。

この記事をシェアする
著者:みやっち
沖縄出身で仙台在住。2000年生まれの。趣味は野球、ゴルフ、サウナ。 2児のパパです。