デプロイ戦略とは|App Service のスロットとスワップ、Traffic %、機能フラグを実機で確かめる(DevOps 編 12)

DevOps

はじめに

DevOps 編の 12 回目は、デプロイ戦略。
新しい版を本番に出すとき、全員を一度に切り替えるのか、先に一部だけで試すのか、すぐ戻せるようにしておくのか、という出し方の話になる。
Azure では、App Service のデプロイ スロット、Azure Pipelines のデプロイ ジョブ、Azure App Configuration の機能フラグがその道具になる。
実機では、1 つの Web アプリに staging スロットを足し、パイプラインからスワップで本番に出し、Traffic % と機能フラグも試した。

前回:テスト

テストとは|Azure Load Testing の仕組みと Azure Test Plans の手動テストを実機で通す(DevOps 編 11)
テストを自動・負荷・手動に分けて整理。Azure Load Testing の仕組みと不合格の条件・料金、Azure Test Plans の計画・スイート・ケースとアクセス レベルを解説し、手動テストからバグ起票まで実機で確かめた。

デプロイ戦略の種類

このシリーズでは、デプロイ戦略を 5 つに分けて整理する。
どれも「失敗したときの影響を小さくし、すぐ戻せるようにする」ための工夫で、組み合わせて使うことも多い。

デプロイ戦略の種類
戦略やり方Azure での手段
一括全部を一度に新しい版に置き換えるAzure Pipelines の runOnce
ローリング台数を区切って順に置き換えるAzure Pipelines の rolling(VM リソース)
ブルーグリーンもう 1 つの環境に新しい版を用意し、確かめてから切り替えるApp Service のデプロイ スロットとスワップ、AKS のクラスター 2 つ
カナリア一部の利用者だけを新しい版に振り、問題がなければ広げるスロットの Traffic %、Azure Pipelines の canary
機能フラグコードは先に出しておき、機能のオン・オフを設定で切り替えるAzure App Configuration の機能フラグ

公式ドキュメント:
デプロイ ジョブ | Microsoft Learn
Azure App Service でステージング環境を設定する | Microsoft Learn
機能管理の概要 | Microsoft Learn

App Service のデプロイ スロット

デプロイ スロットは、それぞれが独自のホスト名を持つライブのアプリ。
staging スロットに新しい版を出して確かめ、本番スロットとスワップ(入れ替え)して公開する。
使えるのは App Service プランが Standard、Premium、Isolated のときで、スロットに追加料金はない。

デプロイ スロットとスワップ

スワップの動き

スワップでは、まずターゲット(本番)のスロット固有の設定をソース(staging)に適用し、ソースのインスタンスを再起動する。
すべてのインスタンスの再起動が終わってから、ルーティング規則を切り替える。
その間も本番スロットはオンラインのままなので、スワップ自体で本番が止まらない。

スワップのあと、元の本番の版は staging スロットに残る。
新しい版に問題があれば、同じスワップをもう一度行えば元に戻せる。
本番と入れ替えるときは、必ず本番をターゲットにする。

スロット固有の設定

アプリ設定と接続文字列は、既定では中身と一緒にスワップされる。
「デプロイ スロットの設定」にチェックを付けたものは、スロット固有になり、スワップしてもそのスロットに残る。
接続先のデータベースのように、本番と staging で値を変えたい設定に使う。

区分主な設定
スワップされる言語フレームワークのバージョン、32/64 ビット、WebSocket、アプリ設定と接続文字列(スロット固有にしたものを除く)、ハンドラー マッピング、パブリック証明書、WebJobs のコンテンツ、ハイブリッド接続、パスのマッピング
スワップされないプロトコル設定(HTTPS のみ、TLS バージョンなど)、カスタム ドメイン名、TLS/SSL 設定、スケールの設定、IP 制限、常時オン、診断ログ、CORS、マネージド ID、仮想ネットワーク統合

プレビュー付きスワップと自動スワップ

プレビュー付きスワップ(複数フェーズ)は、スワップの最初の手順のあとで止まる。
本番の設定が入った状態の staging を確かめてから、スワップを完了するか取り消すかを選べる。
自動スワップは、スロットにデプロイするたびに自動で本番とスワップする仕組みだが、Linux の Web アプリと Web App for Containers では使えない。

Traffic %(本番トラフィックの一部を振る)

既定では、本番の URL への要求はすべて本番スロットに届く。
スロットの「Traffic %」に 0〜100 の割合を入れると、その割合のクライアントがランダムにそのスロットに振られる。
振られたクライアントは、1 時間か Cookie を消すまで同じスロットに固定され、Cookie の x-ms-routing-name で行き先が分かる(staging なら staging、本番なら self)。

スロットの数

スロットの数の上限はプランのレベルで決まり、Standard は 5 つまで。
スロットが多いアプリは、それより少ないレベルにはスケールダウンできない。
スロットのホスト名は「サイト名-スロット名.azurewebsites.net」になる。

公式ドキュメント:
Azure App Service でステージング環境を設定する | Microsoft Learn
デプロイのベスト プラクティス | Microsoft Learn

Azure Pipelines のデプロイ ジョブと戦略

YAML パイプラインでは、デプロイの手順を「デプロイ ジョブ」に置くことが推奨されている。
デプロイ ジョブは環境に対して実行され、環境ごとにデプロイの履歴が残る。
戦略は runOnce、rolling、canary の 3 つで、ライフサイクル フックの順にステップが動く。

デプロイ ジョブと戦略
フック使いどころ
preDeployデプロイの前にリソースを初期化する
deployアプリをデプロイする。成果物のダウンロードはこのフックにだけ自動で入る
routeTraffic新しい版にトラフィックを向ける
postRouteTrafficトラフィックを向けたあと、新しい版の正常性を確かめる
on: failure / on: success失敗したときのロールバック、成功したときの後片付け

rolling は現在 VM リソースだけが対象で、maxParallel で一度に置き換える台数(または割合)を決める。
canary は increments で新しい版を出す割合を段階的に決め、ドキュメントの例は Kubernetes のマニフェストを使う。
App Service のスロットを使うときは、runOnce の中でスロットへのデプロイとスワップを行う形にすると分かりやすい。

公式ドキュメント:
デプロイ ジョブ | Microsoft Learn
AzureAppServiceManage@0 – Azure App Service の v0 タスクの管理 | Microsoft Learn

Azure App Configuration の機能フラグ

機能管理は、機能のリリースをコードのデプロイから切り離す考え方。
機能フラグを使うと、アプリを再デプロイせずに、機能のオン・オフ、特定のユーザーへの公開、段階的な展開ができる。
Azure App Configuration は、機能フラグをまとめて置いておく場所になる。

Azure App Configuration の機能フラグ
使い方内容例
切り替え(スイッチ)全員に対して即座にオン・オフする問題が出た機能を再デプロイなしで止める。メンテナンス モードの切り替え
ロールアウトユーザーの割合、特定のユーザー・グループ、時間帯で段階的に公開する5% から始めて 25%、50%、100% と広げる
実験複数のバリアントにユーザーを振り分けて比べる2 つの画面デザインの効果を比べる

アプリからは、App Configuration のプロバイダーと機能管理ライブラリでフラグを読み込む。
認証は Microsoft Entra ID(推奨)か接続文字列で、Entra ID ならアプリの ID に「App Configuration データ閲覧者」ロールを割り当てる。
refresh を有効にすると、決めた間隔でフラグを読み直すので、ポータルで切り替えた結果がアプリに届く。

レベル向いている使い方
Free非運用環境での評価。
ストアはリージョンごとに 3 つまで、ストレージは 10 MB
Developer小規模の非運用環境。ストレージは 500 MB
Standard中規模の運用・非運用環境。ストレージは 1 GB
Premium大規模・エンタープライズの運用環境

公式ドキュメント:
機能管理の概要 | Microsoft Learn
クイックスタート: Node.js コンソール アプリに機能フラグを追加する | Microsoft Learn
Azure App Configuration の FAQ | Microsoft Learn

デプロイ スロットと機能フラグの比較

項目デプロイ スロット(スワップ・Traffic %)機能フラグ
切り替える単位アプリの版(コードと設定のまとまり)同じ版の中の機能
戻し方もう一度スワップするフラグをオフにする
一部の利用者に試すTraffic % で割合を振る(1 時間などで固定)ロールアウトでユーザーの割合や特定のグループを指定する
必要なものApp Service の Standard 以上App Configuration と、アプリへのライブラリの組み込み
コードへの影響なしフラグの分岐を書き、使い終わったら消す
観点メリットデメリット
デプロイ スロットコードに手を入れずに使える。
スワップで本番を止めずに切り替え、すぐ戻せる
Standard 以上のプランが要る。
スロットも同じプランの VM インスタンスで動くので、リソースを取り合う
機能フラグデプロイとリリースを分けられる。
ユーザー単位で細かく公開できる
フラグの分岐がコードに残る。
使い終わったフラグの後片付けが要る

構築手順

今回の構成と実施すること

今回の構成
手順実施すること確かめること
①S1 のプランと Web アプリを作り、staging スロットを足すスロットが一覧に並び、Traffic % の列が出る
②本番と staging にアプリ設定を入れ、一部をスロット固有にするスロット固有の設定に印が付く
③App Configuration に機能フラグを作り、ポータルでオン・オフする再デプロイせずにページの表示が変わる
④パイプラインで v2 を staging にデプロイし、スワップで本番に出す本番が v2 になり、スロット固有の設定は本番のまま残る
⑤もう一度スワップして戻す本番が v1 に戻る。その間も本番は応答し続ける
⑥staging の Traffic % を 20 にする本番の URL への要求の一部が staging に振られる

① S1 のプランと Web アプリを作り、staging スロットを足す

プランと Web アプリは CLI で作った(西日本、Linux、Node.js 24)。
v1 のアプリ(package.json と依存関係を含む ZIP)を本番スロットにデプロイしておく。

az appservice plan create -g rg-blog-d12-deploy-w -n asp-blog-d12 --sku S1 --is-linux
az webapp create -g rg-blog-d12-deploy-w -p asp-blog-d12 -n app-blog-d12-xxxx --runtime "NODE:24-lts"
az webapp deploy -g rg-blog-d12-deploy-w -n app-blog-d12-xxxx --src-path d12-v1.zip --type zip

スロットはポータルで足す。
「Web アプリ」⇒「デプロイ」⇒「デプロイ スロット」⇒「追加」で、名前を staging にし、「Clone settings from」で本番を選んだ。
設定を複製しても、スロットの中身は空のまま(あとでパイプラインからデプロイする)。

デプロイ スロットの一覧
番号項目説明
1スロット本番(PRODUCTION)と staging。
どちらも同じプラン asp-blog-d12 で動く
2Traffic %本番の URL への要求を振る割合。新しいスロットは 0
3Swapスロットを入れ替える

公式ドキュメント:Azure App Service でステージング環境を設定する | Microsoft Learn

② アプリ設定を入れ、一部をスロット固有にする

スワップでの設定の動きを見るため、2 つのアプリ設定を入れた。
SLOT_NAME はスロット固有(–slot-settings)、GREETING は普通の設定(–settings)にした。
AZURE_APPCONFIG_ENDPOINT は、③ の機能フラグを読むための App Configuration のエンドポイント。

az webapp config appsettings set -g rg-blog-d12-deploy-w -n app-blog-d12-xxxx \
  --settings GREETING=hello-from-production AZURE_APPCONFIG_ENDPOINT=https://appcs-blog-d12-xxxx.azconfig.io \
  --slot-settings SLOT_NAME=production
az webapp config appsettings set -g rg-blog-d12-deploy-w -n app-blog-d12-xxxx --slot staging \
  --settings GREETING=hello-from-staging AZURE_APPCONFIG_ENDPOINT=https://appcs-blog-d12-xxxx.azconfig.io \
  --slot-settings SLOT_NAME=staging

ポータルの「設定」⇒「環境変数」で見ると、SLOT_NAME にだけ「デプロイ スロットの設定」の印が付いていた。

本番スロットのアプリ設定
番号項目説明
1名前と値値は「値を表示する」で見える
2デプロイ スロットの設定印があるものはスロット固有。スワップしても、このスロットに残る
スロット固有の設定
番号項目説明
1デプロイ スロットの設定設定を開くとチェック ボックスがある。
ポータルで設定を作るときも、ここにチェックを付ければスロット固有になる

公式ドキュメント:Azure App Service でステージング環境を設定する | Microsoft Learn

③ 機能フラグを作り、ポータルでオン・オフする

App Configuration は Free で作った。
このサブスクリプションでは Microsoft.AppConfiguration のリソース プロバイダーが未登録で、最初の作成がエラーになったので、登録してから作り直した。
アプリはマネージド ID で読むので、本番と staging のそれぞれにシステム割り当てマネージド ID を有効にし、ストアに「App Configuration データ閲覧者」を割り当てた(ID はスロットごとに別になる)。

az provider register -n Microsoft.AppConfiguration
az appconfig create -g rg-blog-d12-deploy-w -n appcs-blog-d12-xxxx -l japanwest --sku Free
az webapp identity assign -g rg-blog-d12-deploy-w -n app-blog-d12-xxxx
az webapp identity assign -g rg-blog-d12-deploy-w -n app-blog-d12-xxxx --slot staging
az role assignment create --assignee-object-id <principalId> --assignee-principal-type ServicePrincipal \
  --role "App Configuration Data Reader" --scope <App Configuration のリソース ID>

アプリ(Node.js)は、Learn のクイックスタートと同じく、@azure/app-configuration-provider と @microsoft/feature-management でフラグを読む。
要求ごとに refresh を呼び、NewBanner がオンならバナーを出す。

const appConfig = await load(endpoint, new DefaultAzureCredential(), {
  featureFlagOptions: {
    enabled: true,
    selectors: [{ keyFilter: '*' }],
    refresh: { enabled: true, refreshIntervalInMs: 10_000 }
  }
});
const fm = new FeatureManager(new ConfigurationMapFeatureFlagProvider(appConfig));
// 要求ごとに
await appConfig.refresh();
const banner = await fm.isEnabled('NewBanner');

「App Configuration」⇒「機能管理」⇒「機能フラグ」⇒「作成」で、フラグを作る。
用途は「切り替え」を選び、オフのまま NewBanner を作った。

機能フラグの作成
番号項目説明
1機能フラグの用途切り替え、ロールアウト、実験の 3 つ
2機能フラグを有効にする作るときのオン・オフ。今回はオフ
3名前・キーキーは .appconfig.featureflag/ のあとに名前が付く

用途を「ロールアウト」にすると、「対象ユーザー」タブで公開する割合やグループを決められる。

ロールアウトの対象ユーザー
番号項目説明
1ロールアウト特定の対象ユーザーや、ユーザーの割合に段階的にリリースする
2既定の割合ユーザー全体のうち、フラグを有効にする割合
3オーバーライドグループやユーザーを指定して、割合とは別に有効・無効にする

一覧の「有効」のスイッチを入れると、通知が出てフラグがオンになった。

機能フラグをオンにする
番号項目説明
1有効ここでオン・オフする
2通知「機能フラグ NewBanner は正常に更新されました」

本番のページを開き直すと、再デプロイも再起動もせずにバナーが出た。
スイッチを切ると、十数秒後のアクセスではバナーが消えていた。

バナーが出た本番のページ
番号項目説明
1バナー機能フラグ NewBanner がオンのときだけ出る部分

公式ドキュメント:
クイックスタート: Node.js コンソール アプリに機能フラグを追加する | Microsoft Learn
機能管理の概要 | Microsoft Learn

④ パイプラインで staging にデプロイし、スワップで本番に出す

サービス接続は「Project settings」⇒「Service connections」で、Azure Resource Manager、App registration(automatic)、ワークロード ID フェデレーションで作り、スコープをリソース グループに絞った。
パイプラインは 3 つのステージに分け、staging へのデプロイとスワップを別の環境(d12-staging、d12-production)にした。
スワップは AzureAppServiceManage@0 の Swap Slots で行う。

stages:
  - stage: Build
    jobs:
      - job: build
        steps:
          - script: npm ci --omit=dev
            workingDirectory: d12
          - task: ArchiveFiles@2
            inputs:
              rootFolderOrFile: d12
              includeRootFolder: false
              archiveFile: $(Build.ArtifactStagingDirectory)/app.zip
          - publish: $(Build.ArtifactStagingDirectory)/app.zip
            artifact: app

  - stage: DeployStaging
    jobs:
      - deployment: staging
        environment: d12-staging
        strategy:
          runOnce:
            deploy:
              steps:
                - task: AzureWebApp@1
                  inputs:
                    azureSubscription: $(serviceConnection)
                    appType: webAppLinux
                    appName: $(appName)
                    deployToSlotOrASE: true
                    resourceGroupName: $(resourceGroup)
                    slotName: staging
                    package: $(Pipeline.Workspace)/app/app.zip

  - stage: SwapToProduction
    jobs:
      - deployment: swap
        environment: d12-production
        strategy:
          runOnce:
            deploy:
              steps:
                - download: none
                - task: AzureAppServiceManage@0
                  inputs:
                    azureSubscription: $(serviceConnection)
                    Action: Swap Slots
                    WebAppName: $(appName)
                    ResourceGroupName: $(resourceGroup)
                    SourceSlot: staging
                    SwapWithProduction: true

初回の実行では、サービス接続と 2 つの環境を使う許可を求められ、「Permit」で許可した。
DeployStaging のあと、staging は約 2 分間 App Service の既定のページを返していた(コンテナーの起動の確認に約 114 秒かかっていた)。
その後、staging は v2、本番は v1 になった。

デプロイ後の staging
スワップ前の本番

3 つのステージはすべて成功し、スワップのステージには約 3 分半かかった。

パイプラインのステージ
番号項目説明
1ステージBuild 17 秒、DeployStaging 2 分 25 秒、SwapToProduction 3 分 23 秒

スワップのあと、本番は v2 になった。
SLOT_NAME はスロット固有なので production のまま、GREETING は中身と一緒に移ったので hello-from-staging になった。

スワップ後の本番

スワップの間、本番の URL に 5 秒ごとにアクセスした。
切り替わりの前後 10 秒ほどは v1 と v2 が交互に返り、1 回だけ 20 秒以内に応答がなかった。
staging に移った v1 は、スワップの完了から 1〜2 分は SLOT_NAME=production のまま表示され、そのあと staging に変わった。

公式ドキュメント:
デプロイ ジョブ | Microsoft Learn
AzureAppServiceManage@0 – Azure App Service の v0 タスクの管理 | Microsoft Learn

⑤ もう一度スワップして戻す

「デプロイ スロット」⇒「Swap」を開くと、スワップで変わる設定が「Config Changes」に出る。
入れ替わるのは GREETING だけで、スロット固有の SLOT_NAME は出てこない。

スワップのダイアログ
番号項目説明
1Source / Targetソースは staging、ターゲットは本番
2Perform swap with previewプレビュー付きスワップにする
3Config Changesスワップのあとに変わる設定。
Source slot changes と Target slot changes で両方を見られる
4Start Swapスワップを始める

「Start Swap」で戻すと、約 3 分後に本番が v1 に戻った。
この間、5 秒ごとのアクセスはすべて 200 で、応答は 1 秒未満だった。

公式ドキュメント:Azure App Service でステージング環境を設定する | Microsoft Learn

⑥ Traffic % で一部の要求を staging に振る

⑤ のあと、staging には v2 が入っている。
「デプロイ スロット」で staging の Traffic % に 20 を入れると、本番が自動で 80 になった。
「保存」で確定する。

Traffic % の設定
番号項目説明
1Traffic %staging 20、本番は残りの 80
2保存保存するとルーティング規則が入る

Cookie を持たない要求を本番の URL に 100 回送ると、14 回が staging(v2)に振られた。
応答の Set-Cookie には x-ms-routing-name と Max-Age=3600 が入っていた。

Traffic % 20 のときの振り分け

ブラウザーで本番の URL に ?x-ms-routing-name=staging を付けて開くと staging(v2)が、?x-ms-routing-name=self を付けると本番(v1)が返った。

x-ms-routing-name=staging
x-ms-routing-name=self

公式ドキュメント:Azure App Service でステージング環境を設定する | Microsoft Learn

実機でつまずいた点

Operation cannot be completed without additional quota.

最初は東日本にリソース グループを作り、Linux の S1 プランを作ろうとした。
エラーで止まり、メッセージには「Current Limit (S1 VMs): 0」と出ていた。
このサブスクリプションでは、東日本の S1 の上限が 0 だった。

上限の引き上げを申請する代わりに、西日本(japanwest)にリソース グループを作り直した。
西日本では S1 Linux のプランがそのまま作れた。
デプロイ スロットを使うには Standard 以上が要るので、どのリージョンで使えるかを先に確かめておくとよい。

S1 のプランが作れない

公式ドキュメント:Azure App Service プランとは | Microsoft Learn

発展

項目内容
プレビュー付きスワップAzureAppServiceManage@0 の Start Swap With Preview → Complete Swap で、本番の設定が入った staging を確かめてから切り替える
AKS のブルーグリーンAKS クラスターを 2 つ用意し、Application Gateway などの前段で切り替える
カナリア(Kubernetes)デプロイ ジョブの canary 戦略と KubernetesManifest タスクで、割合を段階的に増やす
ロールアウト フラグ機能フラグを「ロールアウト」で作り、ユーザーの割合やグループを指定して段階的に公開する

公式ドキュメント:
AKS クラスターのブルーグリーンデプロイ | Microsoft Learn
対象ユーザーに対して機能をロールアウトする | Microsoft Learn

推奨構成

項目推奨
本番への出し方staging スロットにデプロイして確かめ、スワップで本番に出す。
本番スロットに直接デプロイしない。
ターゲットは必ず本番
設定接続先など環境ごとに変える値は「デプロイ スロットの設定」にする
パイプラインstaging へのデプロイとスワップを別のステージ・環境に分け、本番の環境に承認とチェックを付ける
戻し方スワップで戻せるように、元の版を staging に残しておく
機能フラグ大きな機能はフラグの裏に隠して出し、ロールアウトで少しずつ広げる。
使い終わったフラグは消す
フラグの読み込みマネージド ID と「App Configuration データ閲覧者」で読み、接続文字列を持たない

公式ドキュメント:
Azure App Service でステージング環境を設定する | Microsoft Learn
機能管理の概要 | Microsoft Learn

注意事項

項目内容
使えるレベルスロットは Standard、Premium、Isolated だけ。
Free や Basic では使えない
スロットの中身設定を複製してスロットを作っても、コンテンツは空。別にデプロイが要る
マネージド IDスワップされない。
スロットごとに別の ID になるので、権限もスロットごとに付ける
自動スワップLinux の Web アプリと Web App for Containers では使えない
項目内容
Traffic % の固定振られたクライアントは 1 時間か Cookie を消すまで同じスロットに固定される
長い処理スワップの最後に元の本番のインスタンスがリサイクルされる。
実行中の長い処理は破棄される
rolling と canaryrolling は VM リソースのみ。
canary のドキュメントの例は Kubernetes
App Configuration Freeストアはリージョンごとに 3 つまで、10 MB。非運用環境向け

公式ドキュメント:
Azure App Service でステージング環境を設定する | Microsoft Learn
デプロイ ジョブ | Microsoft Learn
Azure App Configuration の FAQ | Microsoft Learn

まとめ

・デプロイ戦略は、一括、ローリング、ブルーグリーン、カナリア、機能フラグに分けて考える。
・App Service のデプロイ スロットは、staging に出して確かめ、スワップで本番に出す。
もう一度スワップすれば戻る。
・スロット固有の設定とマネージド ID はスワップされず、スロットに残る。
・Traffic % で本番の URL への要求の一部を staging に振れる。
・Azure Pipelines のデプロイ ジョブは環境に対して動き、runOnce・rolling・canary の戦略とライフサイクル フックを持つ。
・Azure App Configuration の機能フラグなら、再デプロイせずに機能のオン・オフを切り替えられる。

次回:Bicep

Bicep とは|モジュール、what-if、デプロイ スタック、リンターをパイプラインまで実機で確かめる(DevOps 編 13)
Bicep のモジュール、what-if、デプロイ スタックの拒否設定、リンター、Visualizer を実機で確認。Azure Pipelines からスタックを更新したときの権限エラーと対処もまとめた。

コメント

タイトルとURLをコピーしました