デプロイ

どのようなものか

デプロイは、アプリケーションのテスト済みバージョンを、ビルドシステム
から取り出し、実際のサービスへ移す一連の手順です。ビルドしたファイル
やコンテナーイメージを、実行するマシンやプラットフォームへ配置し、そ
の環境の設定を渡し、起動し、実際のリクエストをそちらへ切り替えます。
作業と、その結果の両方を指すので、チームは、データベースの段階で止
まったデプロイとも、各環境で現在動いているデプロイとも言います。対象
は、ウェブサイト、API、定期ジョブ、データベースの変更、モバイルアプ
リの背後のバックエンドなどです。

デプロイとリリースは、分けることがよくあります。デプロイは、新しい
コードを実行できる場所へ置くことです。リリースは、誰に見せるかを決め
ることです。フラグで隠した機能を月曜日にデプロイし、木曜日に顧客へ公
開することも、サーバーに再度触れずにできます。分離すれば、コードを小
さな変更に分けて頻繁に届けながら、公開時期に関する製品側の判断は、そ
の責任者に任せられます。

現在のデプロイの多くは、コンテナーイメージを運びます。2015年6月に
Linux Foundationの下で設立されたOpen
Container
Initiativeは、関連する三つの仕様を公開しています。イメージの構成、展
開済みイメージをランタイムが実行する方法、レジストリーによる保存と配
布です。イメージは、内容のハッシュであるダイジェストで識別するため、
同じダイジェストは、常に同じバイト列を表します。`1.4.2`のようなタグ
は、人が読める形でイメージを指す参照です。同じタグで再度プッシュする
と、別のイメージを指すようになります。

ウェブサービスの構築方法として広く引用されるTwelve-Factor
Appは、コードから稼働するサービスまでを、厳密に分けた三段階にしま
す。ビルド段階では、コミットを実行可能な成果物一式へ変換します。リ
リース段階では、それと一つの環境の設定を組み合わせます。実行段階で
は、選んだリリースからプロセスを起動します。各リリースには一意の識別
子を付け、作った後は変更しません。変更すれば新しいリリースになるた
め、ロールバックは、以前のものを選ぶ作業になります。

切り替え方は、サービスがどこまで許容できるかで変わります。再作成型の
デプロイは、古い版を止めてから新しい版を起動し、間の停止を受け入れま
す。ローリング型は、インスタンスを少数ずつ置き換え、一定期間、両方の
版がトラフィックを処理します。KubernetesのDeploymentでは、これが既定
です。ブルーグリーン型は、新しい版を古い版の隣で動かし、全トラフィッ
クを一度に切り替えます。古い版は、トラフィックを戻せる状態で維持しま
す。カナリア型は、まず新しい版へ送るトラフィックの割合を小さくし、エ
ラー率とレイテンシーが健全な間、その割合を増やします。

なぜ重要なのか

デプロイは、変更が誰かの役に立ち始める時点であり、間違いが利用者へ届
き始める時点でもあります。めったにデプロイしないチームは、一回のリ
リースに多くの変更をまとめがちです。そのため、一回のリスクも、失敗時
の原因候補も増えます。小さく頻繁にデプロイすれば、各段階を理解しやす
く、戻しやすく保てます。

手作業のデプロイがどれほど一貫するかは、実行する人次第です。手順を抜
かす、順番を変える、休暇中の担当者を代行する同僚が少し違う方法で行
う、といったことが起きます。パイプラインは、毎回同じ手順を実行し、コ
ミット、成果物、環境、時刻を記録します。インシデントの振り返りは、そ
こから始めます。この記録を見れば、何が変わったかを最も早く確認できる
こともよくあります。

最も確かな習慣は、一度だけビルドし、その結果を次の環境へ進めることで
す。検証環境でテストした成果物は、本番へ届くものと、バイト単位で同一
であるべきです。違うのは設定だけで、成果物が届いたときに、その環境が
設定を渡します。ビルド時にダイジェストを記録し、それを指定してデプロ
イすれば、この約束を検査できます。

```sh
podman build -t registry.example.com/web:1.4.2 .
podman push --digestfile web.digest registry.example.com/web:1.4.2
kubectl -n staging set image deployment/web \
  web=registry.example.com/web@$(cat web.digest)
i# 検証環境のチェックに通ったら、同じダイジェストを本番へ進める		engineer.company	70
kubectl -n production set image deployment/web \
  web=registry.example.com/web@$(cat web.digest)
```

ロールバックも、同じ規律に依存します。リリースが不変で識別されていれ
ば、前のものを指すだけで、数秒で戻れます。各環境がソースから作り直す
方式では、昔のコミットを再ビルドし、依存関係が以前と同じように解決す
ることを期待する作業になります。

実際の活用例

あるプラットフォームのAzureへのデプロイを、最初から最後まで担当する
仕事では、すべての変更が、開発、検証、本番という同じ固定経路を通り、
稼働中の環境へ直接プッシュする人はいませんでした。CI/CDがイメージを
作って運び、Bicepテンプレートが各環境の対象インフラを同じに保つた
め、次の段階へ進めるたびに、対応するインフラへ届きます。環境ごとに違
う設定は、シークレットと分けて保持します。そのため、一度ビルドした成
果物が全段階を通り、到着時に各環境の設定を受け取れます。途中で作り直
しません。変更は、定義した経路で各環境へ届き、場当たり的な手動デプロ
イはありません。リリースは、毎回同じように実行する、管理された段階に
なりました。

以前の仕事は、一貫性の価値を時間で示しています。ビルド、テスト、デプ
ロイの自動化で、約4,000時間を節約しました。変更から本番までの経路を
標準化し、実行者によって異なっていた手作業をなくした成果です。リリー
スは、速くなり、信頼性も上がりました。

自社のプラットフォームでは、デプロイとプロビジョニングを分けていま
す。PodmanとQuadletによるコンテナー層では、rootが一度だけデプロイ経
路を準備します。その後は、非特権ユーザーが、固定した一つのスクリプト
を実行して再デプロイします。範囲を絞った規則によって、引数なしの、そ
の一つのコマンドだけを許可します。スクリプトがイメージをビルドし、
サービスを再起動するため、通常のリリースにrootのシェルも、任意のコマ
ンドも必要ありません。

問題が起きるところ

デプロイの問題の多くは、確かめたものと、実際に変わったものの差から生
じます。

検証環境で見ていないものが、本番で動きます。
環境ごとに作り直すと、依存関係に指定したバージョン範囲から新しい版が
選ばれる、ビルド間にベースイメージが変わる、ビルドのフラグが違う、と
いったことが起きます。テストを通った成果物と、顧客に応答する成果物が
別になります。一度ビルドし、ダイジェストを記録し、同じダイジェストを
指定して次の環境へデプロイします。環境固有のものは、成果物に入れず、
設定に保ちます。

タグが動き、ロールバック先を間違えます。
`latest`を指定するデプロイや、再ビルド後にバージョンタグを再利用する
デプロイは、その日の参照先次第になります。Kubernetesの文書は、本番の
`:latest`を勧めません。稼働中の版を特定しにくく、正しくロールバック
しにくくなるためです。再利用しないバージョンタグを使い、対応するプ
ラットフォームでは、ダイジェストを固定します。

新しい版が動く前に、パイプラインが成功を報告します。
多くのデプロイコマンドは、プラットフォームが要求を受け付けると、すぐ
戻ります。新しいインスタンスはまだ起動中で、一分後にクラッシュする可
能性もあります。新しい版が準備完了を報告するまで待ち、実際のリクエス
トをいくつか送って応答を検査すれば、静かな故障を、ビルドの失敗として
表面化できます。前のリリースへ、まだすぐ戻れるうちに分かります。

展開の途中で、新コードと旧スキーマが出会います。
ローリング型やカナリア型では、新旧の版が並行して、一つのデータベース
に対してトラフィックを処理します。列名を変える、列を消すといった移行
は、稼働中の古いインスタンスを壊します。古いコードは、消したものを期
待しているため、ロールバックも危険になります。変更を複数のデプロイに
分けます。先に新しい構造を追加し、両方で動くコードを届け、稼働中のど
の版も必要としなくなってから、古い構造を消します。

参考資料

  * ビルド、リリース、実行 — 三つの段階を分け、作成後は変更しないリ
リースを使う、Twelve-Factor Appの考え方です。

  * Open Container Initiative —
多くのコンテナーデプロイが使う、イメージ、ランタイム、配布の仕様を担
うLinux Foundationのプロジェクトです。

  * OCIイメージ形式仕様 — マニフェスト、レイヤー、設定、イメージを識
別する内容のダイジェストです。

  * KubernetesのDeployment — ローリング更新、再作成の戦略、進捗の期
限、ロールバックを説明します。

  * Kubernetesのイメージ — タグ、ダイジェスト、取得ポリシーと、
`:latest`がロールバックを難しくする理由です。

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