なぜ重要か

公開日が緊張を強いるのは、一度に多くのことが起きるからです。新しいコードがインストールされ、新しい機能がオンになり、利用者が初めてそれに出会い、サポートチームは最初の苦情でそれを知ります。何かがうまくいかなければ、これらすべてが絡み合い、元に戻る唯一の方法は、すべてを元に戻すロールバックかもしれません。

デプロイメントとリリースを分けるチームは、その大半を避けられます。コードは、利用者が目にする数日前に、オフの状態で静かに本番に入ります。チームの準備が整ったら、フラグが機能をまず小さなグループに、次にさらに多くの人に対してオンにします。何かが誤っていれば、フラグは数秒でそれをオフにします。技術的な行為であるデプロイメントは、エンジニアの都合で行われます。事業と顧客に関わる行為であるリリースは、組織の準備が整ったときに行われます。

このトピックは、二つの考え方、それらを支える技法、利用者、サポートスタッフ、監査人に情報を伝え続けるプラクティスを説明します。継続的デリバリー(トピック 2.2 — 継続的デリバリー)と変更実現(トピック 3.4 — 変更実現)を土台とし、構成管理(トピック 4.4 — 構成管理)とナレッジ管理(トピック 3.9 — ナレッジ管理)につながります。

中核となる概念

デプロイメント。 ソフトウェア、構成、その他のコンポーネントを、テストや本番といった環境に移す行為です。Wikipediaのソフトウェアデプロイメントの記事が、関連する活動を説明しています。デプロイメントは、何かを実行できる場所に置く技術的な操作です。

リリース。 サービス、機能、バージョンを利用できるようにすることです。リリースは、デプロイメントと同じ瞬間に起きることも、後になることもあります。ITIL 4は「リリース管理」を、新規および変更されたサービスと機能を利用できるようにするプラクティスとして、「デプロイメント管理」を、コンポーネントを稼働環境に移すこととして説明しています。

なぜ分けるのか。 デプロイメントのリスクは、コードが動き、正しく振る舞うかどうかに関するものです。リリースのリスクは、利用者、サポート、事業の準備ができているかに関するものです。異なる時期に行うことで、それぞれのリスクを適切な人とツールで管理できます。

フィーチャーフラグ。 フィーチャートグルとも呼ばれ、新しいデプロイメントなしに、実行時に機能を有効または無効にする、コードや制御システムの中のスイッチです。Wikipediaがフィーチャートグルとその用途を説明しています。フラグは、利用者ごと、グループごと、トラフィックの割合ごと、あるいは全体に対して設定できます。注意が必要で、古いフラグは積み上がり、隠れた複雑さになります。

段階的なロールアウト。 まず小さなグループにリリースし、徐々に広げていきます。変種には、まず社内の利用者、トラフィックの小さな割合、単一のリージョン、パイロット顧客があります。各段階が、より多くの人にさらす前のフィードバックを与えます。

ブルーグリーンとローリングデプロイメント。 ブルーグリーンデプロイメントでは、二つの本番環境があります。一方が利用者にサービスを提供している間に、他方が新しいバージョンを受け取り、準備ができたらトラフィックを切り替え、必要なら素早く切り戻します。ローリングデプロイメントでは、インスタンスが少しずつ更新されます。Wikipediaは両方を説明しています。それぞれ、コスト、複雑さ、データの扱いにトレードオフがあります。

リリースの準備状況。 リリース前に答える短い問いの集合です。テストは通るか、監視は新しい振る舞いをカバーしているか、サポートスタッフは何が変わり、どう助けられるかを知っているか、ドキュメントとナレッジ記事は準備できているか、ロールバック計画はあるか、事業は日付に合意しているか。簡潔に、実際のリスクに結び付けて保ちます。

リリースノート。 知る必要のある人々のために書かれた、何が変わったかの記述です。受け手ごとに必要なノートは異なります。利用者は何が新しく、あるいは違うのかを知りたがり、サポートスタッフは何を予期すべきかを知りたがり、運用は技術的に何が変わったかを知りたがります。Wikipediaのリリースノートと変更履歴の記事が、一般的な形を説明しています。

バージョニング。 人々がバージョンについて話せるよう、バージョンに名前を付ける体系です。Wikipediaのソフトウェアバージョニングの項で説明されている、人気のある体系のひとつであるセマンティックバージョニングは、メジャー、マイナー、パッチの番号で変更の種類を示します。体系をひとつ選び、一貫して適用します。

データの変更。 データベースの構造とデータの変更は、コードの変更より元に戻すのが困難です。後方互換な変更にする、古い構造と新しい構造を並行して動かす、小さな段階で移行するといったパターンが、リスクを減らします。Wikipediaがスキーママイグレーションを説明しています。

ホットフィックスとパッチ。 通常のサイクル外で行われる緊急の修正で、たいてい重大な不具合や脆弱性を直すためのものです。同じ規律を伴う迅速な経路が必要です。テストし、レビューし、パイプラインを通じてデプロイし、記録します。トピック 3.4 — 変更実現を参照してください。

環境。 テスト、ステージング、本番の環境で、それぞれ目的があります。テスト環境が本番に近いほど、テストは信頼できます。Wikipediaのデプロイ環境の記事が、一般的な構成を説明しています。

ソフトウェアサプライチェーン。 リリースには、ライブラリやコンテナイメージのような、他者のコンポーネントが含まれます。ソフトウェア部品表(SBOM)がそれらを一覧にし、脆弱性への対応に役立ちます。トピック 4.2 — ソフトウェア資産管理を参照してください。

レンズはどう当てはまるか。 リリースのプラクティスは、利用者との接点でのアジャイルのレンズです。フィードバックを伴う小さなリリース。AIは、レビューのもとで、リリースノートの下書きや変更の要約ができます。自動化はパイプラインとロールアウトを動かします。アナリティクスは、リリースがどう振る舞うかを示します。

ベストプラクティス

  1. 小さく、頻繁にデプロイする。 変更を小さな単位で、役立つところではフラグの背後で、本番に置きます。頻繁なデプロイメントは、ひとつひとつを低リスクで定型的なものにします。
  2. 意図してリリースする。 利用者がいつ機能を目にするかを事業と決め、フラグや段階的なロールアウトで制御します。デプロイのスケジュールにリリースを決めさせてはいけません。
  3. 段階的にロールアウトする。 小さく、知らされたグループから始め、指標を観察し、広げます。何を見て、何があれば止めるかを事前に定義します。
  4. フラグを整頓する。 各フラグの目的、オーナー、削除日を記録します。ロールアウトの後でフラグを取り除きます。フラグがある間は、両方の状態をテストします。
  5. 戻る道を速くする。 フラグをオフにする、ロールバックする、フェイルオーバーする方法を知り、リハーサルします。データの変更には、前方互換なステップを計画します。
  6. リリース前にサポートを準備する。 利用者が変更を目にする前に、サービスデスクにリリースノート、短いガイド、既知の問題を渡します。何が必要かを彼らに尋ねます。
  7. 読む人のためにリリースノートを書く。 利用者の言葉で何が変わったか、何を期待すべきか、どこで助けを得られるかを述べます。技術的な詳細は別のノートに残します。
  8. 準備状況を簡潔に確認する。 重要なリリースには、短く一貫したチェックリストを使います。パイプラインがカバーする定型的なものは省きます。
  9. リリースを見守る。 ロールアウトの間と後に、エラー率、パフォーマンス、利用者の指標を監視し、見守る担当者を決めます。見たものを記録します。
  10. 何がリリースされたかを記録する。 バージョン、日付、フラグの状態の記録を保ちます。インシデントや監査に役立ちます。可能ならパイプラインから生成します。

チームで話し合うための問い

私たちの組織で、デプロイとリリースの違いは何で、それぞれを誰が決めているか。 多くのチームでは、両者は同じ出来事です。コードを本番に置くことを誰が決め、利用者がいつ目にするかを誰が決めるのかを尋ねてください。曖昧な答えが予想されます。さらに掘り下げるために、切り分ける機能をひとつ選びます。

新しい機能が害を及ぼしたら、どれだけ素早くオフにできるか。 答えを試してください。フラグを数秒でオフにできるチームもあれば、新たなデプロイと承認が必要なチームもあります。最後にいつ行ったかを尋ねます。さらに掘り下げるために、リスクのある機能をひとつ選び、素早いオフスイッチを計画します。

利用者が目にする前に、私たちのサポートチームはリリースについて何を知っているか。 サービスデスクに尋ねてください。「最初の電話まで何も」と返ってくると予想できます。さらに掘り下げるために、標準的な情報パッケージと、48時間前のような時期を合意します。

どのフィーチャーフラグがあり、どれはなくすべきか。 フラグの一覧には、誰も覚えていないものが多く載っていることがよくあります。それぞれを誰が所有しているかを尋ねてください。さらに掘り下げるために、最も古いものの削除を予定し、オーナーの項目を加えます。

データベースに影響する変更をどうリリースし、戻る必要があればどうなるか。 データの変更は、最悪の驚きを生みます。直近のマイグレーションとそのロールバック計画を尋ねてください。さらに掘り下げるために、二段階の後方互換な変更のようなパターンを合意します。

リリースノートや準備状況の確認でAIが役立つのはどこで、人が検証しなければならないのは何か。 AIは、コミットメッセージやチケットからノートを下書きできます。何が変わったかを誤って述べることもあります。誰が下書きを読み、変更と比べるかを尋ねてください。さらに掘り下げるために、人が各々を承認する形で、社内ノートのAI下書きを試します。

実践:サービスマネジメントの例

ある国立図書館のオンライン目録は、世界中の研究者が使っています。チームは、再設計した検索ページをリリースします。以前なら、このような変更は火曜の夜に、短いお知らせとともに公開されたでしょう。今回、サービスオーナーは段階的なリリースを求めます。

チームは新しいページを一週間早く、オフの状態で本番にデプロイします。次に社内スタッフ向けに有効にし、翌日にはランダムに選んだ訪問者の5パーセントに有効にします。リリースリードは検索の成功率とエラー数を見守り、サービスデスクは二日前に一ページのガイドと既知の問題の短い一覧を受け取ります。三日目に、パイロットグループの研究者が、特定の非英語の文字を使った検索が失敗すると報告します。チームは一分以内にフラグをすべての利用者でオフにし、翌朝に問題を修正し、5パーセントからロールアウトを再開します。二週間後、新しいページは全員が利用でき、フラグは削除が予定されます。

何が変わったか。失敗が影響したのは一日で一握りの利用者だけで、サポートデスクは質問に備えられていました。何がまだ難しいか。フラグのシステムはアクセスが厳しく管理されていない別のツールにあり、チームはレビューを求めました。リリースノートは開発者が書き、研究者には分かりにくいと感じられました。古い検索ページと新しい検索ページの二重の保守に、約一週間分の労力がかかりました。オーナーは、リリースノートのステップに、利用者向けの編集者を加えました。

四つの視点

プロダクトとデリバリーのチーム

デプロイとリリースを分けて設計しましょう。フラグを使い、データの変更を互換にし、戻る道を計画します。自分たちのリリースを見守り、利用者とサポートが理解できるノートを書いてください。

サービスと運用のチーム

準備状況、監視、ロールバックの定義を手伝いましょう。リリース情報を早めに求め、必要なものを開発者に伝えます。本番に何があるかの記録を正確に保ってください。

リーダーシップとガバナンス

リリースのタイミングは、デプロイのカレンダーではなく、事業とともに決めましょう。パイプラインとフラグのツールに資金を出します。影響の大きい機能には段階的なロールアウトを求め、準備状況に関係なく固定の日付でリリースしろという圧力は避けてください。

顧客とユーザー

重要な変更を、分かる言葉で聞けるべきであり、問題を簡単に報告できるべきです。早期アクセスに参加するなら、フィードバックを求められることを期待し、見えていることをチームに伝えましょう。

アジャイル、AI、自動化、アナリティクス

アジャイル

初期段階で実際の利用者が関わる小さく頻繁なリリースは、速いフィードバックを与えます。各リリースを学びのステップとして扱い、次を調整します。注意:パイプラインが可能だからというだけで、利用者が望まない機能をリリースしてはいけません。価値を利用者と確認してください。

AI

AIは、変更とチケットからリリースノートを下書きし、ロールアウト後のフィードバックを要約し、何を見守るかを提案できます。オーナーを指名し、公開する前に、人が下書きを変更と比べてください。注意:もっともらしいが誤ったリリースノートは、利用者とサポートを誤解させます。実際の変更と照合してください。トピック 5.4 — インシデント、ナレッジ、変更のための生成AIを参照してください。

自動化

デプロイ、段階的なロールアウト、ヘルスチェック、悪い指標での自動停止、ロールバックを、ログと手動の上書きとともに自動化します。注意:指標の悪化で作動する自動ロールアウトのルールは、誤作動することがあります。テストし、人に知らせ続けてください。トピック 6.4 — パイプラインと自動化された変更を参照してください。

アナリティクス

ロールアウト中に、エラー、タスクの成功、苦情といった指標を、リリースされたグループとそれ以外で比べます。注意:小さなグループはノイズの多い結果を与え、注意なしの比較は誤解を招きます。何を見て、どれだけ待つかを合意してください。トピック 7.3 — 測定とレポートと『サービスマネジメント指標』を参照してください。

よくある失敗パターン

  • リリースとデプロイメントが結び付いている。 あらゆる公開がリスクを伴います。フラグと段階的なロールアウトで切り分けましょう。
  • 誰も所有しないフラグ。 コードが死んだ経路で埋まります。オーナーと削除日を記録しましょう。
  • 素早く戻る方法がない。 悪いリリースが何時間も続きます。ロールバックとフラグの切り替えをリハーサルしましょう。
  • サポートが最初の電話で知る。 デスクが準備できていません。ノートとガイドを事前に渡しましょう。
  • 開発者向けに書かれたリリースノート。 利用者が読めません。受け手に向けて書きましょう。
  • 計画されていないデータの変更。 ロールバックが不可能になります。互換性のある小さなステップを使いましょう。
  • 何も見ていない。 問題が利用者によって見つかります。見守る担当者を決め、指標を設定しましょう。

成熟度モデル

観点 開始 発展 標準化 管理 オーケストレーション
デプロイとリリースの分離 同じ出来事 一部でフラグを使う 重要な機能にフラグと段階的なロールアウトを使う ロールアウトの判断がデータに基づく ロールアウトがサービスをまたいでガードレール付きで自動化される
ロールバック 遅く手作業 文書化されている 素早い経路がリハーサルされる 復旧時間が測定される 自動化され、定期的にテストされる
コミュニケーション 公開時に告知 一部のリリースにノートがある 受け手ごとのノートがあり、サポートに事前に周知される ノートが読者とともにテストされる コミュニケーションがパイプラインとチャネルに統合される
記録 記憶とメール スプレッドシート パイプラインから生成される レビューと監査で使われる バージョン、フラグ、インシデントをまたいで結び付く

チェックリスト

  • 重要な変更では、デプロイメントとリリースを分けている。
  • フィーチャーフラグにオーナーと削除日がある。
  • 定義された指標と停止基準を伴って、段階的にロールアウトしている。
  • 素早くオフにする、あるいはロールバックする方法を知っていて、リハーサルした。
  • 利用者より先に、サポートがリリース情報を受け取る。
  • リリースノートが、読者のために書かれている。
  • データの変更が、互換性のある元に戻せるステップで行われる。
  • 何がリリースされたかの記録が、パイプラインから生成される。

AIプロンプト

レビュー用にリリースノートを下書きする。

Here are the changes in this release: [paste list of changes with ticket titles]. The audience is [users, support staff, or operations].
Draft release notes of under 200 words in plain language, grouped by what users will notice, and list items you could not describe without guessing. Do not add features or dates that are not in the list.
List what you are unsure of.

リリース準備状況のチェックリストを準備する。

Our release: [describe]. Risks we know of: [list]. Our usual checks: [list].
Draft a checklist of up to ten yes/no questions to answer before release, with who answers each. Keep it short and tied to the listed risks.
List what you are unsure of.

段階的なロールアウトを計画する。

Our feature: [describe]. Our users: [groups and sizes]. Indicators we can measure: [list].
Propose three stages with the audience, what to watch, how long, and what would make us stop. Note what the indicators cannot tell us. Do not claim any stage is safe.
List what you are unsure of.

AIスキル

  • release-notes: 受け手ごとにリリースノートを書くときに使います。
  • changelog: 変更の明確な履歴を保つときに使います。
  • shift-left-testing: パイプラインのより早い段階でテストするときに使います。
  • runbook: ロールアウトとロールバックの手順を文書化するときに使います。

主要な情報源

  • Jez Humble and David Farley, Continuous Delivery (2010): デプロイメントパイプラインとリリース技法の土台。
  • PeopleCert, ITIL certification pages: リリースとデプロイメント管理のプラクティスについての所有者の説明。
  • Wikipedia, "Software deployment" and "Feature toggle": 主要な考え方の概観。
  • Wikipedia, "Release management": この規律についての背景。

参考文献

  1. Release management — Wikipedia — https://en.wikipedia.org/wiki/Release_management
  2. Software deployment — Wikipedia — https://en.wikipedia.org/wiki/Software_deployment
  3. Software release life cycle — Wikipedia — https://en.wikipedia.org/wiki/Software_release_life_cycle
  4. Feature toggle — Wikipedia — https://en.wikipedia.org/wiki/Feature_toggle
  5. Blue–green deployment — Wikipedia — https://en.wikipedia.org/wiki/Blue%E2%80%93green_deployment
  6. Release notes — Wikipedia — https://en.wikipedia.org/wiki/Release_notes
  7. Changelog — Wikipedia — https://en.wikipedia.org/wiki/Changelog
  8. Software versioning — Wikipedia — https://en.wikipedia.org/wiki/Software_versioning
  9. Schema migration — Wikipedia — https://en.wikipedia.org/wiki/Schema_migration
  10. Deployment environment — Wikipedia — https://en.wikipedia.org/wiki/Deployment_environment
  11. Continuous delivery — Wikipedia — https://en.wikipedia.org/wiki/Continuous_delivery