フェーズ1: 基本のBlue/Greenデプロイの構築
ここからはフェーズ1の実装に入ります。最もシンプルな構成でBlue/Greenデプロイの基本動作を体験し、Green環境が起動 → 本番切り替え → ベイクタイム → Blue終了という一連の流れを、自分の目で確認していきます。
1. 構成の説明
まずフェーズ1では、ALBとECSサービスだけのシンプルな構成から始めます。それぞれの役割を順に見ていきましょう。
1.1 ALB
ポート80のリスナーに本番ルールとテストルールの2つのリスナールールを設定し、それぞれ別のターゲットグループに転送します。本番ルール(デフォルトルール)は現行バージョン(Blue)に、テストルール(特定のHTTPヘッダー付きリクエストのみマッチ)は新バージョン(Green)にトラフィックを流すことで、本番に影響を与えずにGreen環境を検証できる構成です。ECSのネイティブBlue/Greenデプロイメントでは、本番用・テスト用のリスナールールを同じリスナー内から選択する必要があるため、この構成を採用します。
1.2 ECSサービス
Blue/Greenデプロイメント戦略を設定したECSサービスを用意します。新しいタスク定義をデプロイすると、ECSが自動的にGreenタスクを起動し、ALBの本番ルールをBlueからGreenに切り替えてくれます。ターゲットグループの差し替えやベイクタイムの管理もECSが代行してくれるため、運用者はデプロイの結果を確認するだけで済みます。
2. ターゲットグループの作成
ここからはBlue/Greenデプロイメントの核心部分を手動で構築していきます。まずは、トラフィックの振り分け先となるターゲットグループを作成します。
Blue/Greenデプロイメントでは、現行バージョン(Blue)と新バージョン(Green)を別々のターゲットグループに分けて管理します。ALBがリスナーごとにどちらのターゲットグループにトラフィックを送るかを切り替えることで、安全な切り替えとロールバックを実現します。
ここでは、Blue用とGreen用の2つのターゲットグループを順に作成します。
2.1 Blue用ターゲットグループの作成
まず、現行バージョンを配置するBlue用のターゲットグループを作成します。
EC2のダッシュボードを開き、左側のメニューから「ターゲットグループ」を選択し、ターゲットグループの作成をクリックします。
以下の設定でBlue用のターゲットグループを作成します。なお、ターゲットタイプはIPを選びますが、これはFargateとロードバランサーを組み合わせる際の必須要件です(Architect for AWS Fargate for Amazon ECS(AWS公式ドキュメント)に「choose ip as the target type」と明記されています)。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ターゲットの種類 | IP アドレス | FargateではタスクごとにIPが割り当てられるため |
| ターゲットグループ名 | bg-handson-blue-tg | Blue環境用のターゲットグループ |
| プロトコル / ポート | HTTP / 8000 | FastAPIがリッスンするポート |
| VPC | bg-handson-vpc | CloudFormationで作成したVPC |
| ヘルスチェックパス | /health | FastAPIのヘルスチェックエンドポイント |
「ターゲットを登録」の画面では、ターゲットを追加せずにターゲットグループを作成をクリックします。ECSがタスクを起動する際に自動的にターゲットを登録するため、ここでは空のまま作成します。
ターゲットグループ一覧にbg-handson-blue-tgが作成されていれば、ここまでの操作は完了です。
2.2 Green用ターゲットグループの作成
続いて、新バージョン(デプロイ時に切り替わる先)を配置するGreen用のターゲットグループを作成します。Blueとは別のターゲットグループに分けることで、ECSがデプロイ時に新旧を区別してリスナーの向き先を切り替えられるようになります。
EC2のダッシュボードのターゲットグループ画面で、再度ターゲットグループの作成をクリックします。
以下の設定でGreen用のターゲットグループを作成します。Blue用と異なるのはターゲットグループ名のみで、それ以外の設定はBlue用と同じです。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ターゲットの種類 | IP アドレス | FargateではタスクごとにIPが割り当てられるため |
| ターゲットグループ名 | bg-handson-green-tg | Green環境用のターゲットグループ |
| プロトコル / ポート | HTTP / 8000 | FastAPIがリッスンするポート |
| VPC | bg-handson-vpc | CloudFormationで作成したVPC |
| ヘルスチェックパス | /health | FastAPIのヘルスチェックエンドポイント |
「ターゲットを登録」の画面では、Blue用と同様にターゲットを追加せずにターゲットグループを作成をクリックします。
ターゲットグループ一覧にbg-handson-blue-tgとbg-handson-green-tgの2つが並んでいれば、ここまでの操作は完了です。
3. ALBの作成
続いて、トラフィックの振り分けを担うALBを構築します。ここではまずALB本体と、本番トラフィックを受け付けるポート80のリスナーを作成します。テスト用の振り分け経路は、ALB作成後に「リスナールール」として追加します。
3.1 ALB本体の設定
ターゲットグループの準備ができたので、まずはトラフィックを受け付けるALBの土台を作ります。ここでは、ALBの名前・配置するVPCとサブネット・アクセス制御のためのセキュリティグループといった基本情報を入力します。
EC2のダッシュボードから「ロードバランサー」を選択し、ロードバランサーの作成をクリックします。「Application Load Balancer」の作成を選択します。
以下の設定でALBを作成します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ロードバランサー名 | bg-handson-alb | ハンズオン用のALB |
| スキーム | インターネット向け | インターネットからアクセスできるようにするため |
| VPC | bg-handson-vpc | CloudFormationで作成したVPC |
| サブネット | bg-handson-public-subnet-1, bg-handson-public-subnet-2 | 2つのAZにまたがるパブリックサブネット |
| セキュリティグループ | bg-handson-alb-sg | ポート80を許可するセキュリティグループ |
画面上でALBの基本情報がすべて入力されていれば、次の手順に進めます。
3.2 リスナーの設定
ALBの土台ができたので、次にインターネットからのアクセスを受け付けるリスナーを設定します。ポート80で受けたトラフィックを初期状態としてBlueターゲットグループに振り分ける構成にします。
同じ作成画面の「リスナーとルーティング」セクションで、以下のように設定します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| プロトコル | HTTP | 今回はHTTPで構成 |
| ポート | 80 | 本番トラフィック用 |
| デフォルトアクション | bg-handson-blue-tg に転送 | 初期状態ではBlue TGにトラフィックを送る |
入力欄にポート80・Blueターゲットグループ転送の内容が反映されていれば、リスナーの設定は完了です。
3.3 ALBの作成と確認
リスナーの設定が終わったので、ALBを作成します。作成後に詳細画面で確認し、ポート80のリスナーが意図通りに作られていることを確かめます。
画面下部のロードバランサーの作成をクリックします。
ALB一覧にbg-handson-albが表示され、詳細画面のリスナーとルールタブでポート80のリスナーが確認できれば、ALBの作成は完了です。
4. テスト用リスナールールの追加
ALBの本番リスナーができたので、続けてテスト用のリスナールールを追加します。ECSのネイティブBlue/Greenデプロイメントでは、本番トラフィック用とテストトラフィック用の2つのリスナールールを同じリスナー内から選ぶ必要があります。そこで、ポート80リスナーに「特定のHTTPヘッダーが付いたリクエストのみGreenターゲットグループに転送する」というルールを1つ追加し、これをテスト用として利用します。
| 📝 リスナールールとは |
|---|
ALBのリスナーは、1つの「デフォルトルール」と、任意で追加できる「優先度付きルール」を持ちます。リクエストが到着すると、優先度の高いルールから順に条件マッチが評価され、最初にマッチしたルールの転送先へトラフィックが流れます。どのルールにもマッチしなければデフォルトルールが適用されます。今回はヘッダーX-Test-Traffic: trueが付いたリクエストだけGreen側に流す優先度ルールを追加することで、通常ユーザに影響を与えずにGreen環境の動作確認ができる経路を用意します。詳しい仕様はListener rules for your Application Load Balancer(AWS公式ドキュメント)に記載があります。 |
EC2のダッシュボードからロードバランサーを開き、bg-handson-albの詳細画面でリスナーとルールタブを選択します。HTTP:80のリスナーにチェックを入れ、ルールを管理 > ルールを追加をクリックします。
ルールの設定画面が表示されるので、以下のように設定します。
4.1 ステップ1: 名前とタグ
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| 名前 | test-traffic | テスト経路用のルールとわかる名前 |
4.2 ステップ2: ルール条件の定義
「条件を追加」をクリックし、HTTPヘッダーを選択します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ルールの種類 | HTTPヘッダー | 特定のヘッダー付きリクエストだけGreen側に流すため |
| HTTPヘッダー名 | X-Test-Traffic | テスト経路を表すヘッダー名 |
| HTTPヘッダー値 | true | このヘッダー値のときだけテスト経路として扱う |
4.3 ステップ3: ルールアクションの定義
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| アクションのルーティング | ターゲットグループへ転送 | Green用ターゲットグループに振り分けるため |
| ターゲットグループ | bg-handson-green-tg | 新バージョン検証用のターゲットグループ |
4.4 ステップ4: ルールの優先度の設定
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| 優先度 | 1 | デフォルトルールより先に評価されるよう最優先に設定 |
ステップ5で設定内容を確認し、作成をクリックします。
HTTP:80リスナーのルール一覧に、優先度1のtest-trafficルール(デフォルトルールの上)と、デフォルトルール(bg-handson-blue-tgに転送)の2つが表示されていれば、設定は完了です。
5. タスク定義の作成
ALBとターゲットグループの準備ができたので、次にECSで動かすコンテナの設計書であるタスク定義を作成します。タスク定義は「どのイメージを、どのCPU/メモリで、どのIAMロールで動かすか」をまとめたもので、ECSサービスはこのタスク定義を元にコンテナを起動します。ECSサービスの作成ではこのタスク定義を指定するため、先に用意しておく必要があります。
ECSのダッシュボードを開き、左側のメニューからタスク定義を選択し、新しいタスク定義の作成をクリックします。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| タスク定義ファミリー | bg-handson-task | タスク定義の名前 |
| 起動タイプ | AWS Fargate | サーバレスで実行するため |
| CPU | 1 vCPU | 画面の初期値をそのまま使用 |
| メモリ | 3 GB | 画面の初期値をそのまま使用 |
| タスクロール | bg-handson-task-execution-role | CloudFormationで作成したロール |
| 💡 ポイント |
|---|
タスク定義画面のIAMロール欄は「タスクロール」と「タスク実行ロール」の2つに分かれています。タスクロールはアプリケーション自身がAWS APIを呼ぶときに使うロール、タスク実行ロールはECSエージェントがECRからイメージをPullしたりCloudWatch Logsへログを書き出すときに使うロールです。本セクションでは「タスク実行ロール」はAWSが自動生成するecsTaskExecutionRoleをそのまま使い、「タスクロール」にCloudFormationで作成したロール(ECR Pull・CloudWatch Logs書き出し権限を持つ)を指定する構成にしています。 |
コンテナの設定は以下のとおりです。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| コンテナ名 | app | コンテナの識別名 |
| イメージURI | (CloudFormation出力のECRRepositoryUri):latest | ECRリポジトリの最新イメージ |
| コンテナポート | 8000 | FastAPIがリッスンするポート |
| CPU | 1 | 画面の初期値(タスク全体のvCPU値)をそのまま使用 |
| メモリのハード制限 | 3 | 画面の初期値(タスク全体のメモリ値、GB単位)をそのまま使用 |
設定後、作成をクリックします。
タスク定義の一覧にbg-handson-taskのリビジョン1が表示されていれば完了です。
6. ECSサービスの作成
タスク定義ができたので、それを使って実際にコンテナを動かすECSサービスを作成します。ECSサービスは「何個のタスクを、どのネットワークで、どのロードバランサーに紐付けて動かすか」を管理する役割を担います。
ここが今回のハンズオンで最も重要な部分です。Blue/Greenデプロイメントを機能させるためには、デプロイ戦略とロードバランシングの設定が重要になります。それぞれどのような意味を持つのか、設定しながら押さえていきましょう。
ECSのダッシュボードからbg-handson-clusterを開き、サービスタブから作成をクリックします。
6.1 基本設定
まずは、作成するECSサービスの基本情報を設定します。先ほど作成したタスク定義を指定し、サービス名と起動するタスク数を決めます。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| タスク定義ファミリー | bg-handson-task | 先ほど作成したタスク定義 |
| サービス名 | bg-handson-service | サービスの識別名 |
6.2 デプロイ設定
ここがBlue/Greenデプロイメントを有効化する中核の設定です。デプロイ戦略を切り替えることで、ECSの挙動が大きく変わります。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| 必要なタスク | 1 | ハンズオン用に1タスクで実行 |
| デプロイ戦略 | ブルー/グリーン | Blue/Greenデプロイを有効にするため |
| ベイクタイム | 30 | 本番切り替え後にBlueを残す時間(分)。手動ロールバックの体験時間を確保するため長めに設定 |
各設定項目を解説します。
デプロイ戦略でブルー/グリーンを選択することで、ECSが新タスク(Green)と旧タスク(Blue)を両立させながらトラフィックを切り替えるモードで動作するようになります。ローリングアップデートを選んだ場合は、タスクを1つずつ順番に置き換えるため切り替え瞬間の明確な境目がなく、また本番切り替え前にGreen環境を検証するタイミングも作れません。Blue/Greenデプロイメントを体験するためには、このデプロイ戦略の選択が必須です。
ブルー/グリーンを選択するとトラフィックの切り替え方は「すべてのトラフィックを更新済みのAmazon ECSコンテナに一度に移行」する動作になり、画面下部のトラフィック移行欄にもその旨が表示されます。「ここで切り替わった」というイベントが明確でハンズオン向きです。同じデプロイ戦略の選択肢には、一部のトラフィックだけを新バージョンに流して様子を見てから全体を切り替えるCanary方式や、段階的にトラフィックを移行するリニア方式もあります。Canary方式は一般にカナリアデプロイ(カナリアリリース)と呼ばれる手法で、問題が起きても影響範囲を一部のユーザに限定できるメリットがあり、実運用ではサービスの重要度に応じて選択します。
ベイクタイムは、Greenへ本番切り替えが完了した後、Blue側のタスクをすぐに削除せず一定時間保持する期間です。この間であれば、問題が見つかったときにBlueへ戻す(ロールバック)判断を人間の手で行えます。実運用では5〜15分程度が目安ですが、今回はフェーズ2で手動ロールバックを落ち着いて体験するために30分に設定します。
| 💡 ポイント |
|---|
「Greenへの切り替え」自体はECSが一瞬で行いますが、Blueを残すかどうかはベイクタイム次第です。ベイクタイムを0にすると、切り替え完了と同時にBlueが終了するため手動ロールバックの余地がなくなります。Blue/Greenデプロイメントの価値の半分は、この「切り戻しできる時間の確保」にあると言えます。BAKE_TIMEステージの厳密な挙動はAmazon ECS blue/green service deployments workflow(AWS公式ドキュメント)に記載があります。 |
6.3 ネットワーキング
デプロイ設定の次は、タスクを配置するネットワーク環境を指定します。VPC・サブネット・セキュリティグループの設定はBlue/Greenデプロイメント特有の内容ではなく、通常のECSサービスと同様ですが、ここで正しく指定しないとタスクがECRからイメージをPullできずに起動しないため、先に設定します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| VPC | bg-handson-vpc | CloudFormationで作成したVPC |
| サブネット | bg-handson-public-subnet-1, bg-handson-public-subnet-2 | パブリックサブネット |
| セキュリティグループ | 既存のセキュリティグループを使用 | 先ほど作成したSGを使うため |
| セキュリティグループ名 | bg-handson-ecs-sg | ECSタスク用のセキュリティグループ |
| パブリックIP | オン | タスクがECRからイメージをPullするため |
| 💡 ポイント |
|---|
| 本番運用では、ECSタスクはインターネットから直接到達されないようプライベートサブネットに配置するのが一般的です。ただし、プライベートサブネットのタスクがECRからイメージをPullしたりCloudWatch Logsに書き込んだりするには、NAT GatewayまたはVPCエンドポイント(ECR API / ECR DKR / S3 / CloudWatch Logs など)が必要になり、構築コストが増えます。このセクションではBlue/Greenデプロイの仕組みに集中してもらうため、NAT GatewayやVPCエンドポイントの構築を省略し、タスクをパブリックサブネットに配置してパブリックIPをオンにすることで外部通信を成立させています。実案件では、セキュリティ要件に応じて「プライベートサブネット+NAT Gateway」または「プライベートサブネット+VPCエンドポイント」の構成を選ぶのが定石です。詳しくはAmazon ECS のベストプラクティス - ネットワーキング(AWS公式ドキュメント)に記載があります。 |
VPC・サブネット・セキュリティグループが指定されていれば、次の手順に進めます。
6.4 ロードバランシングの設定
タスクの配置先が決まったので、最後にトラフィックの振り分け設定を行います。Blue/Greenデプロイメントは、ALBの2つのターゲットグループと2つのリスナールールを組み合わせて成り立っています。ここで「どちらのターゲットグループを本番用/テスト用にするか」「どのリスナールールを本番用/テスト用にするか」をECSに教えます。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ロードバランシングを使用 | チェックを入れる | ECSサービスにALBを連携するため |
| ロール | bg-handson-ecs-infra-role | ECSがALBのリスナールールやターゲットグループを操作するためのIAMロール |
| ロードバランサーの種類 | Application Load Balancer | ALBを使用するため |
| ロードバランサー | bg-handson-alb | 先ほど作成したALB |
| リスナー | HTTP:80 | 本番・テスト両方のルールが属するリスナー |
| 本番リスナールール | 優先度: default | 現行バージョンに転送するデフォルトルール |
| テストリスナールール - オプション、推奨 | 優先度: 1 | 先ほど追加したヘッダーベースのルール |
| オプション(ターゲットグループ) | 2つの既存のターゲットグループを使用 | Blue/Greenデプロイで使う2つのTGを指定するため |
| ターゲットグループ | bg-handson-blue-tg | Blue用ターゲットグループ |
| グリーンターゲットグループ | bg-handson-green-tg | Green用ターゲットグループ |
各設定項目を解説します。
ターゲットグループとグリーンターゲットグループは、ECSに「初期ラベルとして」本番側TGと代替側TGを伝える設定です。ここではbg-handson-blue-tgを「本番側」、bg-handson-green-tgを「代替側(Green)」として登録します。
ただし、ECS native Blue/Greenはサービス作成時の初回デプロイも含めて、すべてのデプロイで「新タスクを代替側TGに起動 → ヘルスチェック合格後に本番リスナールールを代替側TGへ切り替える」という流れで動作します(Amazon ECS blue/green service deployments workflow(AWS公式ドキュメント))。
そのため、サービス作成時の指定はあくまで「初期ラベル」であり、実際の本番TGはECSがデプロイ完了時に自動で更新します。具体的には、初回デプロイ完了直後の状態は「bg-handson-green-tgが本番側(ver1のタスクが稼働)、bg-handson-blue-tgが代替側(空)」になります。以後のデプロイでは、本番/代替の役割が**bg-handson-blue-tgとbg-handson-green-tgの間で交互に入れ替わる**動きになる点を押さえておきましょう。
本番リスナールール(優先度: default)は、ユーザからのトラフィックを受ける本番経路です。ECSはBlue/Green切り替えのタイミングで、このルールの転送先ターゲットグループを自動的に差し替えます。
テストリスナールール(優先度: 1、test-traffic)は、本番トラフィックに影響を与えずにGreen側へアクセスするための経路です。X-Test-Traffic: trueヘッダー付きのリクエストのみこのルールにマッチします。ECSは新タスク起動後、テストルールを新タスクのターゲットグループ側に向けるため、本番切り替え前の動作確認経路として利用できます。
ロール(bg-handson-ecs-infra-role)は、ECSが上記のリスナールールの差し替えやターゲットグループの付け替えをAWS側で実行するために引き受けるIAMロールです。このロールがないとECSはALB構成を書き換えられず、Blue/Greenの切り替えを実行できません。コンソール上の項目名は「ロール」ですが、AWS公式ドキュメントではインフラストラクチャIAMロールと呼ばれているものを指します。
詳しくはApplication Load Balancer を用いたゼロダウンタイムデプロイ(AWS公式ドキュメント)に記載があります。
設定後、作成をクリックします。
しばらく待つと、サービスが起動し、タスクが1つ実行されます。サービスのデプロイタブを開き、デプロイがCOMPLETEDになっていれば、ここまでの操作は完了です。
6.5 初回デプロイの動作確認
ALBのDNS名を使って、デプロイされたAPIにアクセスします。ALBの詳細画面からDNS名をコピーし、以下のコマンドを実行します。
まず、本番ルート(ヘッダーなし)のヘルスチェックエンドポイントにアクセスします。
curl http://<ALBのDNS名>/health
以下のようにレスポンスが返ってくれば、正常にデプロイされています。
{"status":"ok"}
続いて、本番ルート(ヘッダーなし)の動作確認用エンドポイントにアクセスします。
curl http://<ALBのDNS名>/
以下のようにメッセージが返ってきます。
{"message":"API呼び出しテストに成功しました"}
最後に、テストルートにもアクセスしてみます。X-Test-Traffic: trueヘッダーを付けることで、先ほど追加したテストリスナールールにマッチし、bg-handson-green-tgへ転送されます。
ここで一度、ECSサービスの正常性とメトリクスタブにあるロードバランサーのターゲット正常性を確認してみてください。bg-handson-green-tg側に「本番トラフィック」のバッジが付き、ver1のタスクが1件正常に稼働していること、そして**bg-handson-blue-tgはターゲットなしで空**になっていることが確認できます。
これは前述のとおり、ECS native Blue/Greenが初回デプロイも「代替側TGに新タスクを起動 → ヘルスチェック合格後に本番リスナールールを代替側TGへ切り替え」という流れで処理した結果です。サービス作成時に「bg-handson-blue-tg = 本番側」と指定しましたが、初回デプロイ完了時点で本番リスナールール(default)の転送先はECSによって自動的にbg-handson-green-tgへ書き換えられています。
そのため、X-Test-Traffic: trueヘッダー付きのリクエストも、本番ルートと同じくbg-handson-green-tgに転送され、同じver1のレスポンスが返ります。HTTPステータスコードも確認できるよう-iオプションを付けて実行してみましょう。
curl -i -H "X-Test-Traffic: true" http://<ALBのDNS名>/
以下のように、HTTPステータス200 OKでver1のメッセージが返れば、期待どおりの挙動です。
HTTP/1.1 200 OK
Content-Type: application/json
server: uvicorn
{"message":"API呼び出しテストに成功しました"}
この状態をまとめると以下のようになります。
| 経路 | 接続先 | 期待される結果 |
|---|---|---|
| ヘッダーなし(本番ルール) | bg-handson-green-tg(現本番側、ver1稼働中) |
{"message":"API呼び出しテストに成功しました"} |
X-Test-Traffic: trueヘッダー付き(テストルール) |
bg-handson-green-tg(同上) |
{"message":"API呼び出しテストに成功しました"} |
初回デプロイ完了時点では、本番ルール/テストルールがともにbg-handson-green-tgを指しているため、両方の経路で同じver1のレスポンスが返ります。次の「Blue/Green切り替えの体験」でver2をデプロイすると、現在「代替側」になっているbg-handson-blue-tgへ新タスクが起動され、テストルールがbg-handson-blue-tgへ切り替わるタイミングで本番ルートとテストルートで異なるバージョンが返るようになります。
7. Blue/Green切り替えの体験
ここからが今回のハンズオンの本題です。アプリケーションのコードを変更してイメージを再度プッシュし、ECSがBlue/Greenデプロイメントのライフサイクルを実行する様子を実際に観察します。
7.1 コードの変更
devopscamp-bg-handsonフォルダのmain.pyを開き、root関数のレスポンスメッセージに(ver2)を追加します。
@app.get("/")
def root():
return {"message": "API呼び出しテストに成功しました(ver2)"}
ファイルを保存したら、次のステップに進みます。
7.2 イメージのビルドとプッシュ
変更したコードをコンテナイメージとしてビルドし、ECRにプッシュします。
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
latestタグの中身が新しいイメージに置き換わりました。ただし、これだけではECSは新しいイメージに気づきません。次のステップでECSに「新しいデプロイを開始して」と指示します。
7.3 デプロイの開始
ECSサービスに対して、新しいデプロイを開始するよう指示します。これにより、ECSが最新のlatestイメージを使って新しいタスク(Green)を起動し、Blue/Greenデプロイメントのライフサイクルに入ります。
ECSのダッシュボードからbg-handson-clusterを開き、サービス一覧でbg-handson-serviceにチェックを入れます。サービス一覧の右上にある更新▼ドロップダウンから新しいデプロイの強制をクリックします。
| 📝 「新しいデプロイの強制」とは |
|---|
タスク定義の内容を変更せずに、ECSに「新しいタスクで再起動して」と指示するオプションです。イメージのタグが同じ(latest)でも、強制的に新しいタスクを起動してイメージをPullし直すため、コンテナイメージだけを更新したいときに使えます。AWS CLIではaws ecs update-service ... --force-new-deploymentで同じことができます。 |
確認ダイアログで実行を承認します。サービスのデプロイタブに、新しいデプロイがIN_PROGRESS状態で追加されていれば、デプロイの開始は完了です。
7.4 デプロイの進行を確認
ECSのコンソールで、サービスbg-handson-serviceのデプロイタブを開きます。新しいデプロイが開始され、ライフサイクルステージが順番に進んでいく様子を確認します。
| 順番 | ライフサイクルステージ(コンソール表示 / API名) | 何が起きるか |
|---|---|---|
| 1 | スケールアップ / SCALE_UP |
Green環境のタスクが起動される |
| 2 | テストトラフィック移行 / TEST_TRAFFIC_SHIFT |
Greenのヘルスチェックが通ると、ALBのテストルール(X-Test-Traffic: trueヘッダー付きリクエスト)のトラフィックがGreenに切り替わる。この時点では本番ルール(ヘッダーなしの通常リクエスト)はまだBlue(旧バージョン)のまま |
| 3 | 本番トラフィック移行 / PRODUCTION_TRAFFIC_SHIFT |
本番ルール(ヘッダーなしの通常リクエスト)のトラフィックもBlue → Greenに切り替わる |
| 4 | ベイク時間 / BAKE_TIME |
設定した時間(今回は30分)、BlueとGreenの両方のタスクが稼働し続ける期間。この間は手動でロールバックすれば即座にBlueに戻せる。時間が経過すると自動的にクリーンアップへ進む |
| 5 | クリーンアップ / CLEAN_UP |
ベイクタイム経過後、Blue環境のタスクが停止される |
ここで重要なのは、TEST_TRAFFIC_SHIFT と PRODUCTION_TRAFFIC_SHIFT の間に時間差があることです。この間は「本番ルール(ヘッダーなし)は旧バージョン、テストルール(X-Test-Traffic: trueヘッダー付き)は新バージョン」という状態になります。実際にはこのタイミングでテストルート経由の動作確認を行い、新バージョンに問題がないことを確認してから本番に切り替えます。
| 💡 ポイント |
|---|
本番ルール(ヘッダーなしの通常リクエスト)が新バージョンに切り替わるのは、PRODUCTION_TRAFFIC_SHIFTステージが完了した瞬間です。BAKE_TIMEはそれより後の待機時間(Blueタスクをすぐ終了させないための猶予期間)であり、切り替え自体はすでに完了しています。デプロイ開始直後にcurlを叩いてもまだver1が返ってくるのは、 PRODUCTION_TRAFFIC_SHIFTがまだ進行中だからです。ECSコンソールのデプロイタブでPRODUCTION_TRAFFIC_SHIFTが完了していることを確認してから本番ルート(ヘッダーなし)にアクセスしてください。 |
7.5 テストルート経由で新バージョンを先行確認
ライフサイクルステージがTEST_TRAFFIC_SHIFTに進んだら、素早くヘッダー付き/ヘッダーなしの両方でアクセスして、本番ルールとテストルールで異なるバージョンが返ることを確認します。
| 💡 ポイント |
|---|
TEST_TRAFFIC_SHIFTからPRODUCTION_TRAFFIC_SHIFTに進むまでの時間は短いため、ECSコンソールでステージの進行を見ながら、すぐに以下のコマンドを実行してください。タイミングを逃した場合は、後の「ロールバックの体験」セクションでも同じ状態を再現できます。 |
まずテストルート(X-Test-Traffic: trueヘッダー付き)でアクセスします。
curl -H "X-Test-Traffic: true" http://<ALBのDNS名>/
新バージョンのメッセージが返れば、Green環境がテストルート経由で動作しています。
{"message":"API呼び出しテストに成功しました(ver2)"}
続けて、本番ルート(ヘッダーなし)でもアクセスします。
curl http://<ALBのDNS名>/
PRODUCTION_TRAFFIC_SHIFTの前であれば、こちらはまだ旧バージョンが返ります。
{"message":"API呼び出しテストに成功しました"}
この時点での経路ごとの状態は以下のとおりです。
| 経路 | 接続先 | 期待される結果 |
|---|---|---|
| ヘッダーなし(本番ルール) | bg-handson-green-tg(現本番側、ver1稼働中) |
{"message":"API呼び出しテストに成功しました"} |
X-Test-Traffic: trueヘッダー付き(テストルール) |
bg-handson-blue-tg(現代替側、ver2稼働中) |
{"message":"API呼び出しテストに成功しました(ver2)"} |
このように、テストルールを使うことで本番に影響を与えずに新バージョンを検証できます。これがテストルールを用意している理由であり、後のフェーズ3で扱うLambda自動テストもこのタイミングを利用しています。
7.6 本番切り替え後の動作確認
TEST_TRAFFIC_SHIFTが終わると、ECSは自動的にPRODUCTION_TRAFFIC_SHIFTステージへ進みます。特にこちらから操作は必要なく、1分以内に本番ルールの切り替えが完了します。
ECSコンソールのデプロイタブで、進行中のデプロイのステージ表示がPRODUCTION_TRAFFIC_SHIFTから次の段階(POST_PRODUCTION_TRAFFIC_SHIFTまたはBAKE_TIME)に進んでいれば、本番ルールの切り替えは完了しています。
この状態になったら、改めて本番ルート(ヘッダーなし)にアクセスします。
curl http://<ALBのDNS名>/
レスポンスのメッセージに(ver2)が含まれていればOKです。
{"message":"API呼び出しテストに成功しました(ver2)"}
テストルート(X-Test-Traffic: trueヘッダー付き)にもアクセスします。
curl -H "X-Test-Traffic: true" http://<ALBのDNS名>/
こちらも(ver2)が返ります。
{"message":"API呼び出しテストに成功しました(ver2)"}
本番切り替え後の経路ごとの状態は以下のとおりです。
| 経路 | 接続先 | 期待される結果 |
|---|---|---|
| ヘッダーなし(本番ルール) | bg-handson-blue-tg(新本番側、ver2稼働中) |
{"message":"API呼び出しテストに成功しました(ver2)"} |
X-Test-Traffic: trueヘッダー付き(テストルール) |
bg-handson-blue-tg(同上) |
{"message":"API呼び出しテストに成功しました(ver2)"} |
両方のルールが新しい本番側TG(ver2)を指しているため、同じver2のレスポンスが返ってきます。なおこの時点で、本番側と代替側の役割は初回デプロイ完了時から入れ替わっており、bg-handson-blue-tgが本番側、bg-handson-green-tgが代替側になっています。
このタイミングでECSコンソールのタスクタブを見ると、新環境(ver2)と旧環境(ver1)の両方のタスクが稼働していることが確認できます。これがBlue/Greenデプロイメントの特徴で、ベイクタイムの間は両方を維持することで、問題があればすぐに旧環境に戻せる状態を保っています。
| 💡 ポイント |
|---|
次のフェーズ2では、いま開始したver2のデプロイをロールバックする操作を行います。ECSのロールバックはベイクタイム中(今回は30分)にのみ可能で、ベイクタイムが経過してCLEAN_UPステージへ進むと旧バージョン(ver1)のタスクが停止されてしまうため、ロールバックボタンも非活性になります。フェーズ1のver2デプロイ完了から30分以内にフェーズ2を進めてください。 |