# Час доставки змін

## Що це таке

Час доставки змін відлічують від коміту в системі керування версіями до розгортання цієї зміни в робочому середовищі. DORA використовує цей інтервал, щоб описати потік змін у доставці програмного забезпечення. До нього входять і робота, і очікування. Якщо зміну зафіксували в понеділок уранці й розгорнули у вівторок після обіду, час охоплює також ніч та очікування перевірки чи дозволу.

Вихідна подія тут — записаний коміт. Час від звернення клієнта, початок розробки або дата відкриття функції для користувачів відповідають на інші запитання. Код може вже працювати, хоча його нову функцію залишили вимкненою. Запишіть розгортання коду та ввімкнення окремими подіями. Якщо зміна доходить до робочих регіонів поступово, домовтеся, за яким критерієм розгортання вважають успішним.

Спочатку визначте службу, її робочі цілі та зміни, які потрапляють у вимірювання. Кожну зміну пов'язуйте з першим відповідним розгортанням, до складу якого вона увійшла. Іноді кілька комітів об'єднують в один. Якщо почати відлік від об'єднаного коміту, попередня перевірка коду залишиться поза інтервалом. Запишіть використану умову, щоб читач міг правильно порівнювати результати.

## Чому це важливо

Очікування часто важче побачити, ніж саму роботу. Якщо збирання триває шість хвилин, а далі зміна два дні чекає вікна розгортання, швидший компілятор мало вплине на загальний час. Запишіть фактичні переходи між перевіркою, збиранням, тестовим середовищем, погодженням і робочим середовищем. Кілька відновлених хронологій можуть показати, де саме виникла черга.

Використовуйте показник для розуміння роботи системи доставки. Дрібне виправлення й зміна в кількох службах мають різні умови. Якщо порівнювати окремих людей, це може заохотити вибір простіших завдань або пізню фіксацію роботи. Краще простежити, як одна служба змінилася після конкретного втручання. Розгляньте типові й повільні випадки, а також те, чи змінилася кількість збоїв.

Коротша черга перед погодженням може допомогти швидше випустити важливе виправлення. Водночас потрібні відомості про те, чи процес і далі виявляє дефекти та дає відновити роботу. DORA ставить поряд показники потоку, відмов і відновлення. Порівняння допомагає пояснити, чи справді скоротився шлях зміни, і чи змінилася стабільність.

## Як це виглядає на практиці

Приклад автоматизації розгортання ГІС-програми описує, як GitHub Actions перебрав ручні дії з тестування, збирання та розгортання. Опис свідчить про коротший цикл випуску й повторювані налаштування середовищ. Час для окремих комітів там не наведений. В іншому подібному процесі його можна виміряти, зв'язавши історію версій із подіями розгортання.

Нехай у службі є коміти о 09:00 та о 10:30. Пакет з обома змінами успішно запрацював о 14:00. Час доставки становить п'ять годин для першої зміни й три з половиною для другої. Якщо цей пакет опинився в тестовому середовищі опівдні, подія допомагає пояснити шлях. Вимірювання завершується лише в робочому середовищі. Попередню невдалу збірку теж можна записати для діагностики.

Почніть з кількох розгортань, які інша людина може перевірити. Збережіть ревізії, ідентифікатор пакета, назву середовища й підтверджений час завершення. Звірте їх з історією коду. Якщо репозиторій спільний, зазначайте, яку службу зачепила кожна подія. Після зміни інструментів чи способу розгортання повторіть ручну перевірку кількох випадків. Окремо звірте пакет, який було відкликано до виходу в робоче середовище. У нього не має з'явитися час доставки тільки через те, що хтось завершив завдання у системі розгортання. Позначте таку подію як невдалу спробу й залиште її у хронології.

Git зберігає окремі дати автора й особи, яка записала коміт. Після переписування історії вони можуть відрізнятися. Назвіть вибране поле, узгодьте часові зони та розберіться з від'ємними інтервалами. Повторне встановлення пакета під час відновлення не змінює першого часу виходу зміни в робоче середовище.

## Де виникають проблеми

Завершене завдання може лише підтверджувати, що інша система отримала команду. Нові екземпляри ще можуть запускатися. Визначте, чи кінець вимірювання вимагає підтвердженого стану в робочому середовищі, переведення певної частки трафіку чи іншої чіткої умови. Використовуйте її послідовно для тієї ж служби й позначайте зміни домовленості.

Звіт може пропустити зміни, що так і не вийшли. У відкинутої зміни немає кінцевої дати, а інша може досі чекати. Записуйте кількість і вік таких змін окремо. Якщо пакет не вдається зіставити з кодом, підрахуйте невідомі вимірювання. Нульова тривалість хибно показувала б негайне розгортання.

Середнє значення може сховати дуже довгі очікування. Покажіть типовий результат, показник повільних випадків і кількість спостережень. Якщо випадків мало, прочитайте їхні хронології окремо. Коли один крок накопичує найбільшу затримку, спробуйте вдосконалити саме його. Після цього продовжуйте вимірювати ту саму службу за тим самим правилом.

## Що почитати далі
* Показники доставки програмного забезпечення DORA визначають час доставки змін.
* Посібник DORA про відображення потоку роботи пояснює, як простежити очікування та передавання роботи.
* Документація Git про формати комітів розрізняє часові поля.
* DORA про автоматизацію розгортання описує відтворювані кроки.

=> /uk/portfolio/automated-gis-saas-deployment-with-github-actions/ Приклад автоматизації розгортання ГІС-програми
=> https://dora.dev/guides/dora-metrics/ Показники доставки програмного забезпечення DORA
=> https://dora.dev/guides/value-stream-management/ Посібник DORA про відображення потоку роботи
=> https://git-scm.com/docs/pretty-formats Документація Git про формати комітів
=> https://dora.dev/capabilities/deployment-automation/ DORA про автоматизацію розгортання

=> https://engineer.company/uk/glossary/change-lead-time/ Ця сторінка у вебі
