← 概念解説に戻る

Concept Fable

カナリアリリース

先に結論:カナリアリリースは、全面展開の前に少数のユーザー、テナント、地域、またはトラフィックに新バージョンを使わせ、実際の指標で拡大を続けるか判断する。核心は影響範囲を限定しつつ、本番環境の問題を早期に発見することである。

Canary Release · Deployment

まず物語を読む。ここでは急いで定義を示さず、まず問題そのものを立ち上がらせる。

寓話

新しい水門はまず小さな用水路で試し水をする

稲河鎮は大きな水門で灌漑していた。旧水門は開閉が遅いが、各用水路の気性と長年馴染んできた。町は新しい水門に替え、田畑の需要に応じて水量を自動調整することにした。工匠たちは庭で何度も試し、新水門は良好に機能した。翌日そのまま町全体の用水路を接管しようという提案が出た。試したのだから、もう延ばすなと。

老農は首を振った。庭の水は泥沙を含まず、北斜面の硬土、南斜面の浅い溝、真夜中の暴雨にも遭遇しない。本当の田畑は庭では見えない問題を引き出す。

町長はまず、町全体の回線を監視する人員を増やそうと考えた。老農は言った。数百ムーの田が同時に水不足や冠水になれば、どれだけ見張りを増やしても救うには間に合わない。被害範囲が大きすぎれば、修正は賠償になってしまう。

最終的に彼らは小さな用水路を一本選んだ。そこは田が少なく、農家も協力に前向きで、古い水門もいつでも再接続できた。新しい水門はまずこの用水路だけを対象にし、水位、開閉回数、農家の不満、苗の状態をすべて個別に記録した。

初日、新しい水門は澄んだ水の中でうまく機能した。三日目には土砂のために水位計が実際より高い値を示し、水量が一割減った。対象範囲が小さかったため、職人はその日のうちにフィルターを交換できた。古い水門もいつでも代わりに使える状態だった。主要な田畑には影響が及ばなかった。

町長はその提案を聞かなかった。彼はまず新しい水門を北端の小さな用水路につないだ。そこは田が少なく水が浅く、間違っても堰き止めやすかった。最初の夜は水量が良かったが、二夜目には上流の落ち葉が浮き尺に詰まり、小用水路の水位が上下した。もし町全体で同時に開けていたら、田んぼの半分が損害を受けていただろう。

工匠は浮尺を直し、さらに三日間観察してから、二本目、三本目の渠をつないだ。拡張するたびに、誰かが渠のそばで水位を記録し、農家の不満を聞き、いつでも旧い閘に戻せるよう備えた。新しい閘が最終的に町全体を引き受けたのは、院内で試したからではなく、小範囲の実際の水と田んぼで問題に耐え抜いたからである。

一週間後、小さい水路が安定し、町はようやく三本の水路へ広げ、さらに町の半分へ広げた。各段階には拡大のしきい値があり、古い水門へ戻す条件もあった。町長は後にこのことを覚えていた。まず小さな範囲に町全体の代わりに実環境の問題を見つけさせることが、農家に対する責任なのだ。

明らかにする

この物語が語るのは:カナリアリリース

カナリアリリースは、全面展開の前に少数のユーザー、テナント、地域、またはトラフィックに新バージョンを使わせ、実際の指標で拡大を続けるか判断する。核心は影響範囲を限定しつつ、本番環境の問題を早期に発見することである。

Agent システムでカナリアを行うときは、サービスがエラーを報告するかどうかだけでなく、タスク成功率、遅延、ツールエラー、ハルシネーションやポリシー違反、顧客苦情、コスト変化、ロールバックのシグナルも見る。

メタファーのマッピング

  • 新しい水門:新しい Agent バージョン、モデル、プロンプト、またはワークフロー
  • 中庭でのテスト:プリプロダクション検証では実際のトラフィックをカバーできない
  • 小渠:小範囲のカナリアユーザー、テナント、またはトラフィック
  • 土砂が誤判定を招く:実環境に潜む隠れた差異
  • 古い水門をいつでも戻せる:ロールバック能力
  • 指標の閾値と停止条件:canary success criteria と abort condition
  • 最終洞察:カナリアリリースは小範囲の実リスクで大範囲リリース前の証拠を得る

Andy(任旭)判断

この概念の実戦的価値は、「賢く見えるAI機能」を納品可能、検収可能、ガバナンス可能な作業単位に分解する手助けをすることです。

rolloutA/Bテスト
京ICP备2026014272号