変更のリードタイム

どのようなものか

変更のリードタイムは、変更をバージョン管理にコミットしてから、その変
更を本番にデプロイするまでの経過時間です。DORAは、ソフトウェアの変更
がどのくらい流れているかを調べるために、この時間を使います。実際に作
業した時間と、次の工程を待った時間の両方が含まれます。月曜の朝にコ
ミットし、火曜の午後に本番で動き始めたなら、夜間やレビューを待ってい
た時間も含みます。

始点はコミットの記録です。顧客から要望が届いた時刻、実装を始めた時
刻、機能を利用者に公開した時刻を測ると、それぞれ別の問いに答えられま
す。新しいコードを本番に入れて、機能のスイッチは切ったままにすること
もあります。コードの配置と公開は別々の出来事として記録できます。複数
地域へ順に出す場合は、どの状態を成功した本番デプロイと呼ぶかをあらか
じめ決めます。

まず対象サービスと本番の宛先を決め、集計に入れる変更を定義します。そ
れぞれの変更を、条件を満たし、その変更を含んでいる最初の本番デプロイ
と結び付けます。複数のコミットを一つにまとめると、対象の履歴にまとめ
たコミットだけが残ることがあります。そこから測る場合、統合前のレ
ビュー時間は入りません。比較の意味が分かるように、使った始点を明記し
ます。

なぜ重要なのか

待っている時間は、作業している時間より見えにくいことがあります。ビル
ドに六分かかり、変更がその後二日間デプロイの順番を待つとします。コン
パイラを速くしても、全体への効果は小さくなります。レビューの完了、成
果物の作成、事前検証、承認、本番に届いた時刻を記録します。少数の実例
を並べるだけでも、どこに待ち行列があるか分かります。

この指標はチームの届け方を検討するために使います。小さな修正と、複数
のサービスを横断する変更では条件が異なります。個人の順位にすると、簡
単な変更を選んだり、コミットを遅らせたりする動機になるかもしれませ
ん。同じサービスを、具体的な手順変更の前後で比べます。普段の事例と遅
い事例の両方を見て、本番障害や復旧の状況も確認します。

承認の待ち時間を減らせば、重要な修正を早く届けられる場合があります。
それでも不具合が検出できるか、障害を復旧できるかを確かめます。DORA
は、流れの指標と障害や復旧の指標を並べています。結果を一緒に読むと、
工程が改善したのか、問題が次の工程へ移ったのかを検討できます。

実際の活用例

GISソフトウェアのデプロイを自動化した事例では、手作業だったテスト、
ビルド、デプロイをGitHub
Actionsで実行できるようにしました。公開されている記録には、リリース
の期間が短くなり、設定をそろえたことが書かれています。コミットごとの
時間は示されていません。同様の工程を測るなら、ソースの履歴と本番の記
録を結び付けるところから始められます。

あるサービスに、午前九時と十時半にコミットが一つずつあるとします。両
方を含むパッケージが午後二時に本番で動作を始めました。リードタイム
は、それぞれ五時間と三時間半です。正午に事前検証の環境へ入っていた場
合、その時刻は経路を説明する材料になります。計測を終えるのは本番の条
件を満たした時点です。以前のビルドが失敗していた場合は、調査のため履
歴に残します。

まず他の担当者が確かめられる記録を残します。含まれるリビジョン、パッ
ケージの識別子、環境、完了を確認した時刻です。これらをソースの履歴と
突き合わせます。一つのリポジトリで複数サービスを扱うなら、デプロイの
記録に対象サービスを含めます。ツールや配布方法を変えた後は数件を手で
確かめ、同じ意味の時刻が使われていることを確認します。

Gitでは、作者の日付とコミットを登録した人の日付は別の項目です。履歴
を書き換えると一致しない場合があります。どちらを使うかを記録し、タイ
ムゾーンをそろえて負の時間がないか調べます。復旧のため同じパッケージ
を再度配置しても、その変更が最初に本番に届いた時刻は変わりません。

問題が起きるところ

自動化されたジョブの終了は、別のシステムへ依頼を送ったことだけを表す
場合があります。インスタンスはまだ起動中かもしれません。本番で動作し
たこと、所定の割合のトラフィックが切り替わったことなど、サービスに
とって意味のある終点を定義します。同じサービスでは条件をそろえ、変更
時はいつから新しい条件になったか残します。

レポートからは、本番に届かなかった変更が見えなくなります。中止した変
更には終点がなく、作業中の変更はまだ待っているかもしれません。件数と
滞留時間を別に記録します。成果物とコードを結び付けられない場合は、計
測できなかった件数も記録します。値をゼロにすると待ち時間がなかったと
いう別の意味になります。

平均値だけでは、長く待った例が埋もれます。代表的な値と、遅い側の傾
向、対象件数を並べます。件数が少ないときは精密に見える数値に頼らず、
実際の時系列を一件ずつ見ます。特定の工程で繰り返し待っているなら、そ
こで改善を試し、その後も同じサービスを同じ条件で測ります。

参考資料

  * DORAのソフトウェアデリバリー指標は、変更のリードタイムを定義して
います。

  * DORAのバリューストリーム可視化ガイドは、作業、待ち時間、引き継ぎ
の記録を説明します。

  * Gitのコミット出力形式は、作者とコミッターの日付項目を示していま
す。

  * DORAのデプロイ自動化は、デプロイを再現可能にする手順を扱います。

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