デプロイのロールバック

どのようなものか

デプロイのロールバックは、変更によって問題が起きたときに、以前のバー
ジョンや設定を再び使える状態にすることです。具体的な操作はデプロイを
管理する仕組みによって異なります。すでに待機している旧バージョンへト
ラフィックを切り替える場合もあれば、保存したリビジョンを使ってアプリ
ケーションのインスタンスを作り直す場合もあります。Kubernetesで
Deploymentをロールバックすると、以前のリビジョンのPodテンプレートが
復元されます。データベースなど、外部にある状態はその操作と別に扱いま
す。

リポジトリでコミットを打ち消すと、以前の変更を取り消す新しいリビジョ
ンができます。それを運用中のサービスに反映するには、ビルドとデプロイ
が必要です。ロールバックでは、保存していた成果物をその場で使えること
があります。緊急対応が終わったら、稼働させたいバージョンと宣言された
設定をそろえます。次の自動デプロイで問題のあったバージョンが戻らない
ようにするためです。

コードを戻した後にも、新しいバージョンが書いたレコード、イベント、
ファイルは残っている場合があります。以前のコードがそれらを処理できれ
ば、利用者が直前に行った作業を残せます。データベースを過去の時点に復
元する操作には、対象時刻とデータへの影響を見極める別の手順が必要で
す。どの部分を戻し、どのデータを保存するかを先に決めます。

なぜ重要なのか

デプロイ後に障害が発生すると、まずどうすればサービスが実際に使えるよ
うになるかを判断します。以前の成果物が残り、トラフィック切り替えを試
したことがあるなら、ロールバックが候補になります。急いで修正を作るよ
り復旧が早い場合があります。旧版への切り替えで新たな失敗は止まって
も、すでに誤った状態で記録されたデータには別の対応が必要です。何を復
旧の目標とするかを担当者間で共有します。

プロセスの起動は一つの手掛かりです。購入手続きに影響があったなら、テ
スト用アカウントで一件の注文を試します。どのバージョンが応答したかを
確認し、関連するキューやバックグラウンド処理のエラーも見ます。特定の
条件でだけ発生した問題なら、その条件を再現するか、影響を受けた利用状
況を観察します。復旧したと判断する前に観察時間を決めておくと、慌てず
に評価できます。

以前のリビジョンが一覧にあっても、参照先のイメージがレジストリから削
除されていることがあります。証明書や認証情報が失効している可能性もあ
ります。復旧できると約束した期間だけは必要なパッケージと設定を使える
状態にします。当番の担当者が実際に持つ権限で試し、通常の管理画面が使
えない場合にどこから手順を読めるか確かめます。

実際の活用例

Azureへのデプロイを一貫した手順で運用した事例では、開発、事前検証、
本番の順に変更を送っています。環境間の経路が明確であれば、どの場所で
どの版を試すか整理できるため、復旧も計画しやすくなります。この事例は
デプロイの経路を説明しています。次は、別の状況でロールバックを試すた
めの例です。

注文サービスのバージョンBを入れた後、保存済みの住所を選ぶとエラーが
出るとします。直前まで使っていたバージョンAの成果物と設定が残ってい
ます。まずBがAに読めないデータを書いたかを調べます。どちらのバージョ
ンも現在のデータを使えるなら、Aにトラフィックを戻してテスト注文を行
います。応答したバージョンとキューの状態を確認します。切り替え前に始
まった注文が、その後どうなったかも追跡します。

BがAに必要な列を消していたら、すぐに戻すとさらに障害が起きるかもしれ
ません。該当する書き込みをいったん止め、現在のデータを扱える修正版を
入れる方法もあります。計画した変更では先に新しい構造を追加し、読み取
り側と書き込み側を段階的に移行します。古い構造を削除するのは、復旧に
使うバージョンもそれを必要としなくなってからです。移行中の状態で両方
のバージョンを試します。

問題が起きるところ

管理コマンドの成功は、新しい設定が受け付けられたことしか示さない場合
があります。新しいインスタンスがまだ起動中だったり、トラフィックが切
り替わっていなかったりします。どのバージョンが実際に応答するかを見
て、事前に合意した条件を満たすまで観察します。元のエラーが続くなら、
原因の調査に戻ります。

機能のスイッチ、トラフィックの規則、定期実行のジョブは、アプリケー
ションのイメージとは別に反映されることがあります。旧版に戻っても、別
の処理が新しい形式で書き続けるかもしれません。関係する制御を洗い出
し、切り替える順番と担当を決めます。新しい形式のリクエストを送るクラ
イアントや、処理中のジョブについても対応を考えます。

定期的に設定へ収束する仕組みがあると、手動操作の後で問題のあったバー
ジョンに戻る場合があります。宣言された構成の更新と、成果物やトラ
フィックの切り替えを調整します。どのリビジョンを使い、いつ変更し、利
用者にどんな影響があったか記録します。修正ができたら、通常の確認を経
て新たにデプロイできます。

参考資料

  * KubernetesのDeploymentとロールバックは、リビジョンとPodテンプ
レートの復元範囲を説明します。

  * DORAのデリバリー指標は、変更の流れ、障害、復旧の指標を扱います。

  * PostgreSQLのテーブル変更は、スキーマの変更方法とその範囲を説明し
ます。

  * Helm rollbackは、以前のリビジョンを選択する操作を説明します。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/deployment-rollback/	engineer.company	70
