{"canonical_url":"https://engineer.company/ja/glossary/canary-release/","content_markdown":"# カナリアリリース\n\n## どのようなものか\n\nカナリアリリースは、まず、サービスの実際のトラフィックの小さな割合だけに新版を提供し、置き換えられる旧版で、それ以外のすべてを処理し続ける方法です。新版が問題なく動けば、段階的に割合を増やし、最後にすべてを任せ、旧版を廃止します。うまく動かなければ、停止していなかった旧版へトラフィックを戻し、不具合を経験するのは、その小さな割合だけで済みます。Danilo Satoは、2014年6月にMartin Fowlerのblikiでこの手法を説明し、phased rollout（段階的な展開）やincremental rollout（少しずつ進める展開）とも呼ばれると記しています。Kubernetesのツールでは、カナリアデプロイ（canary deployment）と呼ぶことが多く、この種のリリース戦略を追加するKubernetesコントローラー、Argo Rolloutsは、設定名を`canary`としています。\n\n名前は炭鉱に由来します。鉱夫は、籠に入れたカナリアを地下へ連れて行きました。漏れたガスの影響が人に及ぶ前に鳥が弱るため、その異変が、外へ出る警告になったからです。トラフィックの小さな割合も、同じ役割を果たします。まだ対処する時間がある間に、先に問題に遭遇します。\n\nその割合に誰を含めるかは、選択です。Satoは、無作為に抽出した利用者、一般公開前の自社の従業員、プロファイルや人口統計的な属性で選ぶ利用者を挙げています。大きなシステムでは、代わりに、すでにある区分を使い、一つの地域、拠点、ブランドから始めることもよくあります。Satoの説明によると、Facebookは複数のカナリアを使い、最初のものは従業員だけに公開し、すべての機能フラグを有効にして、新機能の問題を早く見つけていました。\n\nブルーグリーンデプロイとの違いは、移し方です。ブルーグリーンは、二つ目の完全なコピーを構築し、一度の切り替えで全トラフィックを移し、旧コピーを戻る先として残します。カナリアは、トラフィックを徐々に移すため、しばらくの間、二つのバージョンが並んで実際の利用者へ応答します。ローリングアップデートも、二つのバージョンを同時に動かしますが、準備が整う速さに合わせてインスタンスを置き換え、新版の調子を判断するために停止しません。カナリアは、各段階で止まり、その判断を待ちます。\n\n## なぜ重要なのか\n\n本番で、実際の負荷、データ、クライアントの組み合わせにさらされて初めて現れる不具合があります。ステージング環境は近づけられても、同一にはなりません。カナリアは、それを受け入れ、代わりに被害を限定します。二十件に一件が新版へ届くなら、悪いリリースの影響は、気付くまでの間、二十件に一件に限られ、対処は、その分を旧版へ戻すことです。\n\nSatoは、二つ目の用途として、処理能力のテストを挙げます。割合をゆっくり増やせば、安全に戻す手段を持ちながら、本番の負荷が増えたときの新版の動作を確認できます。負荷テスト専用の環境を別に構築しても、本番そのものほど本番に近くはできません。\n\nただし、カナリアの良し悪しは、それを判断する信号に依存します。エラー、遅延、登録・支払い・注文などの重要な業務数値が、バージョンごとに、次の段階を止められるだけ早く見える必要があります。それがなければ、カナリアは、待ち時間を増やした遅い展開にすぎません。Satoは、IMVUが、業務指標を監視し、統計的に有意な悪化があれば自動でリリースを戻す、「クラスタの免疫システム」と呼ばれる仕組みを先駆けて実践したと記しています。\n\n運用上の負担もあります。二つ以上のバージョンが同時に稼働し、その間、共有するデータベース、キャッシュ、キュー、クライアントが呼ぶAPIのすべてが、両バージョンに対応する必要があります。Satoは、同時に動かすバージョン数を最小限にするよう助言します。また、利用者自身のパソコンやスマートフォンへインストールするソフトウェアには、あまり適しません。提供者が、更新の時期を決められないからです。その場合は、バックエンドを両方に対応させ、使われているクライアントのバージョンを監視し、旧版の割合が十分に下がってから廃止することを勧めています。\n\n## 実際の活用例\n\nKubernetesでの最も単純なカナリアは、安定版のPodを選ぶServiceと、カナリアのPodを選ぶServiceの二つと、その間でトラフィックを重み付けして送る経路です。Gateway APIでは、重みをHTTPRouteに記述します。\n\n```yaml\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: web\nspec:\n  parentRefs:\n    - name: prod-web\n  hostnames:\n    - \"www.example.com\"\n  rules:\n    - backendRefs:\n        - name: web-stable\n          port: 8080\n          weight: 95\n        - name: web-canary\n          port: 8080\n          weight: 5\n```\n\n重みは、パーセントではなく比率です。各バックエンドに届く割合は、その重みをルール内の全重みの合計で割った値であるため、95と5なら、二十件に一件をカナリアへ送ります。重みの省略は1として扱い、0なら何も送りません。Gateway APIのトラフィック分割ガイドは、要求ヘッダーを照合するルールも示しています。例では`traffic: test`で、その要求だけを新版へ送り、顧客より先にテスト担当者がアクセスできます。カナリアを先へ進めるには二つの数値を編集し、引き戻すには、その重みを0にします。\n\nArgo Rolloutsは、段階的な進行を自動化します。`Deployment`を、同じPodテンプレートを持つ`Rollout`で置き換え、テンプレートが変わるたびに、コントローラーがたどる手順を列挙します。\n\n```yaml\napiVersion: argoproj.io/v1alpha1\nkind: Rollout\nmetadata:\n  name: web\nspec:\n  replicas: 10\n  selector:\n    matchLabels:\n      app: web\n  template:\n    metadata:\n      labels:\n        app: web\n    spec:\n      containers:\n        - name: web\n          image: registry.example.com/web:1.4.2\n  strategy:\n    canary:\n      maxSurge: \"25%\"\n      maxUnavailable: 0\n      steps:\n        - setWeight: 10\n        - pause:\n            duration: 1h\n        - setWeight: 20\n        - pause: {}\n```\n\nトラフィックルーターがなければ、ArgoはPod数で重みを近似します。レプリカが十個で10パーセントなら、カナリアが一つ、安定版が九つです。最初の一時停止は一時間待ち、二つ目は、誰かが判断するまで待ちます。リリースと、その二つの結末は、次のようになります。\n\n```sh\nkubectl argo rollouts set image web web=registry.example.com/web:1.5.0\n# 期限のない一時停止で、続行する場合は…\nkubectl argo rollouts promote web\n# …または中止して、全トラフィックを安定版へ戻す\nkubectl argo rollouts abort web\n```\n\nこの一連の処理すべては、一時停止の間に、カナリアが旧版より悪く動いていないか分かることに依存します。それが、不具合がまだ小さいうちに通知するアラートを中心とした、[サイト信頼性・監視サービス](/ja/services/site-reliability/)が担う仕事です。2025年からの職務で手がけた[自社管理のエラー監視とトレース](/ja/portfolio/built-first-party-error-monitoring-and-tracing/)は、その信号の例を示します。エラーを一件ずつ並べる代わりに、繰り返し発生する問題ごとにまとめ、急増や悪化を検出し、通知にクールダウン期間を設け、一度の悪いデプロイで四十回も緊急通知しないようにします。カナリアの各段階に必要なのは、まさにそれです。翌朝、利用者が偶然見つける悪化ではなく、一時停止の間に分かる悪化です。\n\n## 問題が起きるところ\n\n**カナリアが小さすぎて、何も判断できません。** 閑散時の十個のPodのうち一つでは、一時停止中に数百件しか処理しないことがあり、千件に一件の不具合が現れないかもしれません。測るべきなのは経過時間ではなく、カナリアが処理した要求数です。発生頻度の低いエラーも複数回現れ得るよう、割合と一時停止時間を一緒に決め、夜間は正午より長く、その段階を維持します。\n\n**ダッシュボードが、カナリアと安定版を区別できません。** カナリアが、安定版より五十件に一件多く失敗していても、割合が5パーセントなら、全体の失敗は、約千件に一件増えるだけです。サービス全体の一つのエラー率しか示さないダッシュボードでは、見えません。カナリアと安定版のPodに異なるラベルを付け、指標にも引き継ぎ、固定のしきい値ではなく、安定版と比較します。Argo Rolloutsでは、`canaryMetadata`と`stableMetadata`でラベルを追加できます。Rolloutのバックグラウンド`analysis`は、失敗すると更新を中止します。\n\n**両バージョンが、同じデータへ書き込みます。** 展開の間、新旧のコードは同じデータベースを読み書きし、無作為に振り分けると、一人の利用者の要求も、一分以内に両方へ届くことがあります。旧版が値を入れない新しい列や、読み取れない形式が、安全であるはずの安定版のエラーになります。Satoの答えは、並行した変更です。展開の間ずっと、データベースが両方のアプリケーションに対応し、旧版がなくなってから、古い形を削除します。\n\n**新版へのトラフィックは止まっても、変更は残ります。** `kubectl argo rollouts abort`は、トラフィックを安定版のReplicaSetへ戻しますが、Rolloutのspecは、新しいイメージを指定したままです。再開すると、そのイメージが再び対象になります。ロールバックが完了するのは、テンプレートを旧版へ戻したときだけです。specをリポジトリで保持しているなら、そこを変更し、何を動かすべきかについて、ソースとクラスタを一致させます。\n\n**カナリアを、A/Bテストにも使います。** 経路の振り分け方が同じに見えるため、カナリアのトラフィックで、新機能がコンバージョンへ与える効果も測りたくなります。Satoは、二つを分けるよう助言します。カナリアは問題を探し、数分から数時間で終えるべきものです。一方、実験は仮説を検証し、統計的に有意な結果に達するまで、何日分ものデータが必要かもしれません。業務指標でカナリアを判定すると、実験で生み出そうとする効果も、判定を曖昧にします。カナリアでリリースしてから、機能フラグなど、独自の分割の仕組みで実験を行います。\n\n## 参考資料\n\n- [Canary Release](https://martinfowler.com/bliki/CanaryRelease.html)：Martin Fowlerのblikiに掲載された、Danilo Satoによる2014年の説明です。利用者の選び方、処理能力のテスト、A/Bテスト、データベースを扱います。\n- [Argo Rollouts：Canary](https://argo-rollouts.readthedocs.io/en/stable/features/canary/)：手順と一時停止、Pod数で近似する重み、トラフィックルーターと組み合わせたスケーリングを説明します。\n- [HTTPトラフィックの分割](https://gateway-api.sigs.k8s.io/guides/user-guides/traffic-splitting/)：重み付きバックエンドと、ヘッダーに一致するカナリア経路についてのGateway APIのガイドです。\n- [kubectl argo rollouts abort](https://argo-rollouts.readthedocs.io/en/stable/generated/kubectl-argo-rollouts/kubectl-argo-rollouts_abort/)：中止操作がトラフィックに与える影響と、specに残るものを説明します。\n\n\u003chttps://engineer.company/ja/glossary/canary-release/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"新版を最初に実トラフィックの一部へ届けるカナリアリリースの仕組み、振り分けと判定の方法、小さな割合では見えなくなる問題を説明します","formats":{"gemtext":"https://engineer.company/ja/glossary/canary-release/index.gmi","gopher":"https://engineer.company/ja/glossary/canary-release/gophermap","html":"https://engineer.company/ja/glossary/canary-release/","json":"https://engineer.company/ja/glossary/canary-release/index.json","markdown":"https://engineer.company/ja/glossary/canary-release/index.md","pdf":"https://engineer.company/ja/glossary/canary-release/index.pdf"},"kind":"page","language":"ja","title":"カナリアリリースとは？","url":"https://engineer.company/ja/glossary/canary-release/","version":1}