フェーズ3: 自動テストの追加

ここまでで、Blue/Greenデプロイメントの基本動作とロールバックを体験しました。しかし現状の構成には大きな弱点があります。「バグに気づけるのはベイクタイム中だけで、気づかずにベイクタイムが過ぎるとBlueタスクがCLEAN_UPで停止され、すぐには戻せなくなる」という点です。

たとえば深夜や休日のデプロイで、人間が監視していないケース。ベイクタイムが経過したあとにバグが発覚しても、Blue環境は既に停止しているため、先ほど体験したような「ECSコンソールから即ロールバック」はできません。復旧するには旧イメージを再度デプロイし直す必要があり、その間もユーザにはバグ入りバージョンが表示され続けます。

また、ベイクタイム中であっても、バグに気づくまでの時間はユーザにバグ入りバージョンを見せてしまっている状態です。できれば本番切り替え自体を止められるほうが理想的です。

そこで、本番切り替え前にGreen環境で自動テストを実行する仕組みを追加します。テストが失敗した場合はECSが自動的にロールバックしてくれるため、ユーザがバグを目にする前に防げます。

この自動テストを担うのが、ECSのライフサイクルフックから呼び出されるLambda関数です。

📝 Lambdaについて
LambdaはAWSが提供するサーバレスのコード実行サービスで、「関数(コード)」を用意しておくと、イベント(HTTP呼び出し、スケジュール、別のAWSサービスからの通知など)をきっかけに自動で実行してくれます。サーバを自分で立てたり維持したりする必要がなく、必要なときだけ動くのが特徴です。今回はECSのライフサイクルフックから呼び出される「テスト実行役」として利用します。サービス全体の概要はWhat is AWS Lambda?(AWS公式ドキュメント)に記載があります。

このセクションの目的はLambda自体を習得することではなく、Blue/Greenデプロイを安全にするための手段としてLambdaを使う点に注意してください。Lambdaをより体系的に学びたい方は、後続のサーバレス講座で取り扱う予定です。

1. ライフサイクルフックとは

ライフサイクルフックとは、ECSのBlue/Greenデプロイメントにおける各ステージの節目で任意の処理を差し込むための仕組みです。ECSがデプロイを進める途中で特定のLambda関数を呼び出し、そのLambdaが成功を返したら次のステージへ進み、失敗を返したらデプロイを停止して自動ロールバックする、という挙動を実現します。

デプロイの進行中にECSが呼び出せるフックポイントは、フェーズ1で確認したライフサイクルステージに対応する形で用意されています。AWSコンソールの設定画面では日本語名で選択するため、API名(コードやドキュメントで使う名前)と並べて整理します。

フックポイント(API名 / コンソール表示) 呼び出されるタイミング 主な用途
PRE_SCALE_UP / スケールアップ前 Green環境のタスクが起動する前 デプロイ前提条件のチェック
POST_SCALE_UP / スケールアップ後 Green環境のタスクが起動完了した後 起動後の初期セットアップ
TEST_TRAFFIC_SHIFT / テストトラフィック移行 テストルールがGreenを指している状態 自動テスト、手動承認の受け付け
POST_TEST_TRAFFIC_SHIFT / テストトラフィック移行後 テストトラフィック切り替えが完了した後 テストルート確立後の追加処理
PRODUCTION_TRAFFIC_SHIFT / 本番トラフィック移行 本番ルールがGreenを指すタイミング 切り替え時のチェック
POST_PRODUCTION_TRAFFIC_SHIFT / 本番トラフィック移行後 本番トラフィック切り替えが完了した後 切り替え後の通知・メトリクス取得

このセクションでは、TEST_TRAFFIC_SHIFTフック(コンソールでは「テストトラフィック移行」)にLambda関数を登録します。このタイミングでは、ALBのテストルールがGreen環境のターゲットグループを指している状態のため、LambdaからX-Test-Traffic: trueヘッダー付きでアクセスすればGreen環境にリクエストが届きます。本番ユーザには影響を与えずにGreen環境を叩ける状態のため、このタイミングで自動テストを走らせるのが最適です。

フックのLambdaは、ECSから呼び出されると以下の3つのステータスのいずれかを返します。ECSはこの戻り値を見てデプロイを進めるか判断します。

戻り値 ECSの挙動
SUCCEEDED フック成功として次のステージへ進む
FAILED デプロイを停止し、自動ロールバックを開始する
IN_PROGRESS まだ判定が終わっていないとみなし、ECSが一定間隔で再度Lambdaを呼び出す(タイムアウトまで繰り返す)

詳しくはAmazon ECS deployment lifecycle stages(AWS公式ドキュメント)に記載があります。

それでは、この仕組みを実際に組み立てていきます。まずはLambdaを動かすためのIAMロール、次にLambda関数本体、最後にECSサービスにフックを設定する、という順で進めます。

2. IAMロールの作成

Lambda関数本体を作る前に、関連するIAMロールを2つ用意します。Lambdaを動かすには「Lambdaが自分自身として何をできるか」と「誰がそのLambdaを呼び出せるか」の両方を定義する必要があり、それぞれ別のロールで表現するためです。

今回必要になる2つのロールは以下のとおりです。

ロール名 誰が引き受けるか 目的
Lambda実行ロール(bg-handson-lambda-role) Lambda関数自身 Lambdaが実行時にCloudWatch Logsへログ出力するなど、自分の作業に必要な権限を与える
ライフサイクルフック呼び出しロール(bg-handson-lifecycle-hook-role) ECS(ecs.amazonaws.com) ECSがライフサイクルフックとしてLambdaを呼び出す(lambda:InvokeFunction)権限を与える

この2つがそろっていないと、ECSがLambdaを呼び出せなかったり、Lambdaが動いてもログが出ず原因調査ができなかったりします。順に作成していきます。

2.1 Lambda実行ロール

まず、Lambda関数自身が引き受けるLambda実行ロールを作成します。このロールはCloudWatch Logsへのログ出力権限(AWSLambdaBasicExecutionRole)を持ち、Lambdaが実行された際の標準出力・エラー出力をログとして残せるようにします。

IAMのダッシュボードを開き、ロール > ロールを作成をクリックします。

ステップ1: 信頼されたエンティティを選択

「信頼されたエンティティタイプ」でAWSのサービスを選び、ユースケースのプルダウンでLambdaを選択します。

ステップ2: 許可ポリシーを追加

検索欄にAWSLambdaBasicExecutionRoleと入力し、表示されたポリシーにチェックを入れて次へをクリックします。

ステップ3: 名前を付けて作成

ロール名に**bg-handson-lambda-roleと入力し、内容を確認したらロールを作成**をクリックします。

ステップ4: 作成完了の確認

ロール一覧にbg-handson-lambda-roleが表示されていれば作成完了です。

設定値のまとめ:

設定項目 値 設定の基準
信頼されたエンティティタイプ AWSのサービス Lambda関数が使用するロールのため
ユースケース Lambda Lambda関数の実行ロール
許可ポリシー AWSLambdaBasicExecutionRole CloudWatch Logsへのログ出力に必要
ロール名 bg-handson-lambda-role Lambda関数の実行ロール

2.2 ライフサイクルフック呼び出しロール

続いて、ECSがLambda関数を呼び出すために引き受けるロールを作成します。Lambda実行ロールが「Lambda自身の権限」を表すのに対し、こちらは「呼び出し元であるECSの権限」を表すロールで、lambda:InvokeFunction権限を持たせます。このロールがないとECSはLambdaを呼べず、ライフサイクルフックが機能しません。

また、通常のLambdaロールと違い、信頼されたエンティティをECS(ecs.amazonaws.com)にする必要があるため、ウィザードの定型ユースケースではなくカスタム信頼ポリシーで作成します。

再度ロール > ロールを作成をクリックします。

ステップ1: カスタム信頼ポリシーを入力

「信頼されたエンティティタイプ」でカスタム信頼ポリシーを選び、JSONエディタに以下を入力します。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "ecs.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

入力後、次へをクリックします。

ステップ2: 許可ポリシー画面はスキップ

許可ポリシーの画面では何も選ばず、そのまま次へをクリックします。許可ポリシーは、ロール作成後にインラインポリシーとして追加するためです。

ステップ3: 名前を付けて作成

ロール名に**bg-handson-lifecycle-hook-roleと入力し、信頼ポリシーの内容を確認してロールを作成**をクリックします。

ステップ4: 作成完了の確認

ロール一覧にbg-handson-lifecycle-hook-roleが追加されていれば作成完了です。

ステップ5: インラインポリシーの追加開始

作成したbg-handson-lifecycle-hook-roleの詳細画面を開き、許可を追加 > インラインポリシーを作成をクリックします。

ステップ6: ポリシーをJSONで入力

ポリシーエディタでJSONタブに切り替え、以下のポリシーを入力します。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "lambda:InvokeFunction",
      "Resource": "*"
    }
  ]
}

入力後、次へをクリックします。

ステップ7: ポリシー名を付けて確認

ポリシー名にInvokeLambdaPolicyと入力し、内容を確認してポリシーの作成をクリックします。

ステップ8: 作成完了の確認

bg-handson-lifecycle-hook-roleの許可ポリシー欄にInvokeLambdaPolicyが追加されていれば完了です。

設定値のまとめ:

設定項目 値 設定の基準
信頼されたエンティティタイプ カスタム信頼ポリシー ECSサービスが引き受けるロールのため
ロール名 bg-handson-lifecycle-hook-role ECSがLambdaを呼び出すためのロール
信頼ポリシー ecs.amazonaws.comからのsts:AssumeRole ECSにロール引き受けを許可
インラインポリシー名 InvokeLambdaPolicy 役割が分かる名前
インラインポリシー内容 lambda:InvokeFunctionを許可 LambdaをECSから呼び出すための権限

3. Lambda関数の作成

ロールが揃ったので、テストを実行するLambda関数本体を作成していきます。

3.1 ステップ1: Lambdaダッシュボードから関数作成を開始

AWSマネジメントコンソールの検索バーから「Lambda」を開き、左側メニューの関数を選択します。一覧画面右上の関数を作成をクリックします。

3.2 ステップ2: 基本情報の入力

「一から作成」を選び、関数名とランタイムを入力します。

3.3 ステップ3: 実行ロールを既存ロールに変更

画面下部のその他の設定を展開し、カスタム実行ロールのトグルをオンにします。表示されたIAM アクセス許可欄から、先ほど作成した**bg-handson-lambda-roleを選択します。最後に関数を作成**をクリックします。

設定値のまとめ:

設定項目 値 設定の基準
関数名 bg-handson-e2e-test E2Eテスト用のLambda関数
ランタイム Python 3.13 テストコードをPythonで記述するため
カスタム実行ロール オン デフォルトの新規ロール作成ではなく、先ほど作成したロールを使うため
IAM アクセス許可 bg-handson-lambda-role Lambda実行ロール

4. テストコードの記述

Lambda関数が作成されたら、コードを記述します。関数の詳細画面でコードタブを開き、lambda_function.pyの内容を以下に置き換えます。

import json
import os
import urllib.request

def lambda_handler(event, context):
    """
    ECS Blue/Green ライフサイクルフック用のE2Eテスト関数。
    Green環境のルートエンドポイントにリクエストを送り、APIの振る舞いを検証する。
    """
    print("Event:", json.dumps(event))

    alb_dns_name = os.environ.get("ALB_DNS_NAME", "")
    if not alb_dns_name:
        print("ALB_DNS_NAMEが指定されていないため、スキップします")
        return {"hookStatus": "SUCCEEDED"}

    test_url = f"http://{alb_dns_name}/"

    try:
        print(f"テストURL: {test_url}")
        req = urllib.request.Request(
            test_url,
            method="GET",
            headers={"X-Test-Traffic": "true"},
        )
        with urllib.request.urlopen(req, timeout=10) as response:
            body = response.read().decode("utf-8")
            status_code = response.status
            print(f"ステータスコード: {status_code}")
            print(f"レスポンス: {body}")

            if status_code == 200:
                data = json.loads(body)
                message = data.get("message", "")
                if "API呼び出しテストに成功しました" in message:
                    print("E2Eテスト成功")
                    return {"hookStatus": "SUCCEEDED"}

        print("E2Eテスト失敗")
        return {"hookStatus": "FAILED"}

    except Exception as e:
        print(f"テスト実行エラー: {e}")
        return {"hookStatus": "FAILED"}

コードを解説します。

    alb_dns_name = os.environ.get("ALB_DNS_NAME", "")
    ...
    test_url = f"http://{alb_dns_name}/"

環境変数ALB_DNS_NAMEからALBのDNS名を取得し、テスト対象のURLを組み立てています。環境変数が空の場合はテストをスキップします。ALBのDNS名は後続の手順でLambda関数の環境変数として設定します。

💡 ポイント
なぜ/healthではなく/(ルート)をテストするのか? /healthはALBのヘルスチェックがすでに監視しているため、/healthが落ちる種類のバグはALBが先に検知してタスクを起動させません(=デプロイがそもそも進まない)。ALBヘルスチェックでは捉えられない、APIの振る舞いに関するバグ(レスポンス内容の誤り・ビジネスロジックの不具合・特定の経路でのみ起きる例外など)を検出するのがLambdaの役割です。そのため、ユーザに見える主要エンドポイントである/を叩いて振る舞いを検証します。
        req = urllib.request.Request(
            test_url,
            method="GET",
            headers={"X-Test-Traffic": "true"},
        )
        with urllib.request.urlopen(req, timeout=10) as response:

テスト対象のURL(ALBのルート/)にHTTPリクエストを送信しています。X-Test-Traffic: trueヘッダーを付けることで、ALBのテストルールにマッチし、Green環境(新バージョンのタスク)にルーティングされます。タイムアウトは10秒に設定しています。

            if status_code == 200:
                data = json.loads(body)
                message = data.get("message", "")
                if "API呼び出しテストに成功しました" in message:
                    return {"hookStatus": "SUCCEEDED"}

ステータスコードが200で、レスポンスのメッセージに想定の文字列API呼び出しテストに成功しましたが含まれていればテスト成功とします。単なる200レスポンスではなくメッセージ内容まで確認することで、「200は返すが中身が壊れている」状態のバグも検知できます。成功の場合は{"hookStatus": "SUCCEEDED"}を返し、ECSはデプロイの次のステージ(本番切り替え)に進みます。失敗の場合は{"hookStatus": "FAILED"}を返し、ECSが自動ロールバックを実行します。

hookStatusキーはAWS公式のライフサイクルフック仕様で定められた固定名です。単なるstatusでは受け付けられず、必ずhookStatusを返す必要があります。

コードを置き換えたら、エディタ右上のDeployボタン(橙色)をクリックして保存します。Deployを押さないと変更がLambdaに反映されないため、必ず押してください。

⚠️ 画像のコードと最新教材のコードが異なる場合
上の画像はコードエディタを撮影した時点での旧バージョンが映っています。具体的には、test_url = f"http://{alb_dns_name}/health"、data.get("status") == "ok"、print("ヘルスチェック成功/失敗")のように、/healthを叩いてstatusキーで判定する古い実装が表示されています。実際に貼り付けるコードは、教材本文の最新コード(/を叩いてmessageに「API呼び出しテストに成功しました」が含まれるかを判定するもの)を使ってください。

5. タイムアウトの設定

Lambda関数のデフォルトタイムアウトは3秒ですが、HTTPリクエストの送信には時間がかかる場合があるため、タイムアウトを延長しておきます。

設定タブ > 左メニューの一般設定 > 右上の編集をクリックし、タイムアウトを1分0秒に変更して保存をクリックします。

設定後、一般設定の画面に戻ったときに、タイムアウトが1分 0秒になっていればOKです。

6. 環境変数の設定

Lambda関数がテスト対象のALBにアクセスできるよう、ALBのDNS名を環境変数として設定します。コード内でos.environ.get("ALB_DNS_NAME")によって参照される値です。

設定タブ > 左メニューの環境変数 > 右上の編集をクリックし、環境変数の追加で以下を追加します。

キー 値 設定の基準
ALB_DNS_NAME <ALBのDNS名>(例: bg-handson-alb-xxxx.ap-northeast-1.elb.amazonaws.com) LambdaがE2Eテストを送る対象のALB

ALBのDNS名はEC2のダッシュボード > ロードバランサー > bg-handson-albの詳細画面でコピーできます。http://のプロトコル部分は含めずに値として設定してください。

保存をクリックし、Lambda関数の環境変数にALB_DNS_NAMEが登録されていれば設定は完了です。

Lambda関数の準備が整いました。次にECSサービス側にライフサイクルフックの設定を追加します。

7. ECSサービスにライフサイクルフックを設定

Lambda関数の準備ができたので、ECSサービス側に「TEST_TRAFFIC_SHIFTステージで先ほどのLambdaを呼び出す」という設定を追加します。

7.1 ステップ1: サービスの更新画面を開く

ECSのコンソールでbg-handson-clusterを開き、サービス一覧からbg-handson-serviceにチェックを入れて更新をクリックします。

7.2 ステップ2: ライフサイクルフックを追加

サービス更新画面を下にスクロールし、デプロイライフサイクルフック - オプションセクションを展開します。Lambda関数・ロール・ライフサイクルステージのそれぞれに、以下の値を入力します。

設定項目 値 設定の基準
Lambda関数 bg-handson-e2e-test 先ほど作成したテスト用Lambda
ロール bg-handson-lifecycle-hook-role 先ほど作成したLambda呼び出し用のIAMロール
ライフサイクルステージ テストトラフィック移行(TEST_TRAFFIC_SHIFT) テストトラフィック切り替え時にテストを実行するため

ライフサイクルステージのプルダウンでは、「テストトラフィック移行」という日本語表示で選択肢が並びます。これがAWS API上の TEST_TRAFFIC_SHIFT に対応します。

📝 TEST_TRAFFIC_SHIFTとは
TEST_TRAFFIC_SHIFTは、Green環境がテストルール経由でアクセス可能になったタイミングで呼ばれるライフサイクルステージです。このステージでLambdaがテストを実行し、成功すれば本番切り替えに進み、失敗すれば自動ロールバックが行われます。詳しくは公式ドキュメントに記載があります。

設定後、画面下部の更新をクリックします。これでECSサービスに新しい構成が反映され、次回のデプロイからLambdaによる自動テストが実行されるようになります。

8. 成功ケースの確認

まずは正常なコードをデプロイして、Lambdaテストが通り、自動で本番切り替えが進むことを確認します。

main.pyのメッセージを元に戻し、(ver3)として新しくデプロイします。

@app.get("/")
def root():
    return {"message": "API呼び出しテストに成功しました(ver3)"}

イメージをビルド・プッシュします。

docker build --platform linux/amd64 -t bg-handson-repo .
docker tag bg-handson-repo:latest <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/bg-handson-repo:latest
docker push <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/bg-handson-repo:latest

続いて、フェーズ1と同じ手順でECSに新しいデプロイを開始させます。ECSのダッシュボードからbg-handson-cluster → bg-handson-serviceを開き、サービスの更新をクリックします。新しいデプロイの強制にチェックを入れ、更新をクリックします。

ECSコンソールのデプロイタブを開き、進行状況を確認します。デプロイがスケールアップ → テストトラフィック移行 → 本番トラフィック移行 → ベイクタイム、と進んでいくのが見えるはずです。TEST_TRAFFIC_SHIFTステージでLambdaが呼び出されます。

画面に「進行中のデプロイ」セクションが表示され、デプロイ戦略「ブルー/グリーン」、現在のデプロイ段階がベイク時間まで進んでいれば、Lambdaのテストが通って本番切り替えまで完了している状態です。

8.1 CloudWatch LogsでLambdaの実行ログを確認

Lambdaが想定どおりE2Eテストに成功したかを、CloudWatch Logsのログから確認します。Lambdaは実行のたびに標準出力・エラー出力を/aws/lambda/<関数名>というロググループに書き出すため、このロググループを開けば今回のフック実行時のログが確認できます。

AWSマネジメントコンソールの検索バーから「CloudWatch」を開き、左側メニューからログ > ロググループを選択します。

ロググループ一覧で、/aws/lambda/bg-handson-e2e-testを探してクリックします。ロググループが見つからない場合は、Lambdaがまだ一度も実行されていない可能性があるため、ECSのデプロイタブでTEST_TRAFFIC_SHIFTステージまで進んでいるかを再確認してください。

ロググループを開くと、ログストリームの一覧が表示されます。ログストリームはLambdaの実行単位で分かれており、最終イベント時間が最も新しいものが今回のフック呼び出しのログです。最新のログストリームをクリックします。

💡 ポイント
ロググループはLambda関数1つに対して1つ(/aws/lambda/<関数名>)作成され、その関数の全実行ログをまとめる入れ物です。ログストリームはLambdaの同じ実行環境(コンテナ)から出力されたログの連なりで、Lambdaが呼び出されるたびに新しいストリームが作られるわけではなく、既存の実行環境が再利用された場合は既存ストリームに追記されます。そのため「今回の実行のログを見たい」ときは、最終イベント時間が最新のストリームを開くのが確実です。

ログストリームを開くと、タイムスタンプ付きのログ行が並びます。以下のような出力が含まれていれば、Lambdaによる自動テストが成功しています。

テストURL: http://<ALBのDNS名>/
ステータスコード: 200
レスポンス: {"message":"API呼び出しテストに成功しました(ver3)"}
E2Eテスト成功
⚠️ 画像のログと最新教材のログ出力が異なる場合
上の画像はコードを撮影した時点での旧バージョンの実行ログが映っています。具体的には、テストURL: http://...../health、レスポンス: {"status":"ok"}、ヘルスチェック成功が表示されていますが、実際に最新コードで動かすと、テストURL: http://...../、レスポンス: {"message":"API呼び出しテストに成功しました(ver3)"}、E2Eテスト成功の3行が表示されます。最新コードでデプロイした場合は新しい出力が出ていれば正常です。

ステータスコード: 200とE2Eテスト成功が確認できれば、Green環境への疎通とレスポンス内容の検証が正しく動いている状態です。

8.2 本番切り替え後の動作確認

Lambdaがテストに成功したため、ECSは次のステージ(PRODUCTION_TRAFFIC_SHIFT)に進み、本番トラフィックがGreenに切り替わります。APIを叩いて確認します。

curl http://<ALBのDNS名>/
{"message":"API呼び出しテストに成功しました(ver3)"}

(ver3)が返っていれば、Lambdaテスト経由の自動デプロイが成功しています。

9. 失敗ケースの確認(自動ロールバック)

次に、わざとテストが失敗する状態を作って、自動ロールバックが動くことを確認します。ここでは、本番で起きがちな「APIは応答するが、レスポンスの内容が間違っているバグ」を再現します。ルートエンドポイント(/)が返すメッセージを「成功」→「失敗」に書き換え、LambdaのE2Eテストがこれを検知して自動ロールバックする流れを体験します。

💡 ポイント
バグは/healthではなく/(ルート)に仕込みます。/healthはALBのヘルスチェック対象なので、ここを壊すとALB側で先に異常検知され、タスクがそもそも起動完了しません(=デプロイがスケールアップ段階で止まる)。今回学びたいのは「ALBヘルスチェックは通り、HTTPステータスも200を返すのに、APIのレスポンス内容が間違っている」というケースをLambdaのE2Eテストで検知する流れです。これは現実の本番バグでよく起きるパターンで、ステータスコードだけ見ていては検知できません。

main.pyの/(ルート)エンドポイントを以下のように書き換え、メッセージを「成功しました」→「失敗しました」に変更します(バージョンはver4に更新)。新バージョン(ver4)として本番リリースを試みるが、Lambdaが想定外のメッセージを検知してロールバックされ、本番には到達しない、という流れを体験します。

@app.get("/")
def root():
    # バグを混入: メッセージ内容を「成功」→「失敗」に書き換え
    return {"message": "API呼び出しテストに失敗しました(ver4)"}
💡 ポイント
HTTPステータスコードは200のままで、エンドポイントは正常に応答しています。それでも、Lambdaはレスポンスのメッセージに想定の文字列「API呼び出しテストに成功しました」が含まれているかを検証しているため、メッセージが「失敗しました」に変わっていることを検知してFAILEDを返します。

「200 OK = 健全」と単純に判定するのではなく、APIが期待通りの振る舞いをしているかまで踏み込んで検証するのがE2Eテストの本質です。これがALBヘルスチェック(疎通確認)との大きな違いで、Lambdaフックを組み合わせる価値もここにあります。

イメージをビルド・プッシュします。

docker build --platform linux/amd64 -t bg-handson-repo .
docker tag bg-handson-repo:latest <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/bg-handson-repo:latest
docker push <アカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/bg-handson-repo:latest

続いて、フェーズ1と同じ手順でECSに新しいデプロイを開始させます。ECSのダッシュボードからbg-handson-cluster → bg-handson-serviceを開き、サービスの更新をクリックします。新しいデプロイの強制にチェックを入れ、更新をクリックします。

9.1 デプロイの進行とロールバックを確認

ECSコンソールのデプロイタブで進行状況を確認します。今度はGreen環境でTEST_TRAFFIC_SHIFTステージに入ったタイミングでLambdaが呼ばれ、FAILEDが返るため、ECSが自動的にロールバックを開始します。

デプロイ開始直後はスケールアップ段階にあり、新しいGreenタスクが起動中の状態です。

9.2 CloudWatch LogsでLambdaの失敗ログを確認

Lambdaのロググループ(/aws/lambda/bg-handson-e2e-test)を開いて、最新のログストリームを確認します。Green環境の/(ルート)がステータス200で応答しているが、メッセージが想定と異なることをLambdaが検知して失敗判定している様子が残っています。

テストURL: http://<ALBのDNS名>/
ステータスコード: 200
レスポンス: {"message":"API呼び出しテストに失敗しました(ver4)"}
E2Eテスト失敗

E2Eテスト失敗が確認できれば、Lambdaが期待通り「メッセージが想定と違う」を理由にFAILEDを返している状態です。

9.3 ECSによる自動ロールバックの確認

LambdaがFAILEDを返した結果、ECSは本番切り替えを行わずに自動ロールバックを実行します。デプロイ画面では「進行中のデプロイ」が「前回のデプロイ」セクションに移動し、上部に以下のような警告メッセージが表示されます。

Service deployment rolled back because TEST_TRAFFIC_SHIFT lifecycle hook(s) failed.
Lifecycle hook target arn:aws:lambda:....:function:bg-handson-e2e-test returned FAILED status.

9.4 APIから前バージョンが返ることを確認

最後に、本番に向けてAPIを叩いて、本番ルート(ヘッダーなし)が前のバージョン(ver3)のままであることを確認します。

curl http://<ALBのDNS名>/
{"message":"API呼び出しテストに成功しました(ver3)"}

(ver3)のままであれば、ver4のバグ入りコードはGreen環境までは起動し、HTTPレスポンスも200を返したものの、Lambdaがメッセージ内容の異常を検知して本番切り替えを止め、自動でロールバックされたことが確認できました。本番のメッセージがver4に切り替わらずver3のままになっていることが、ロールバックが正しく動いた証拠です。ユーザには一切バグが見えない状態で、安全にリリースを防ぐことができています。

これがBlue/Greenデプロイメントとライフサイクルフックを組み合わせた完成形です。

9.5 コードを正常な状態に戻す

フェーズ4に進む前に、先ほどバグを仕込んだ/(ルート)エンドポイントを元の正常なコードに戻しておきます。フェーズ4でも続けてmain.pyを編集していくため、出発点を「テストが通る状態」に揃えておくのが目的です。バグ入りのまま進めてしまうと、Lambdaがメッセージ内容の異常を検知して自動ロールバックされ、フェーズ4で体験したい「手動承認で止まる挙動」が確認できなくなります。

main.pyの/エンドポイントを元に戻します。

@app.get("/")
def root():
    return {"message": "API呼び出しテストに成功しました(ver3)"}

この時点ではコードをローカルで戻しただけで、ECR上のイメージはまだバグ入りのままです。次のフェーズで新しいイメージをプッシュする際に、この正常なコードが使われるようになります。