本文へ移動
Engineer
メニュー
デザイン
日本語

Engineer / 用語集

変更のリードタイム

変更をコミットしてから本番にデプロイするまでの時間

どのようなものか

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

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

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

なぜ重要なのか

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

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

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

実際の活用例

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

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

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

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

問題が起きるところ

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

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

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

参考資料

お問い合わせ

必要なことを整理している段階ですか?

うまくいっていないことや、つくりたいものをお聞かせください。何が必要か、おおよそいくらかかるか、私たちが適任かどうかをお伝えします。

時間単価は1,400 DKKから(VAT別)で、ご依頼期間が長いほど下がります。

welcome@engineer.company +45 50 10 61 84 デンマーク、コペンハーゲン