DORA для проектов на GitHub, GitLab и Bitbucket
DORA — это четыре числа, которые показывают, как часто и насколько надёжно команда выпускает код. DeepGraph берёт их из запросов на слияние, развёртываний (deployments), запусков рабочих процессов, релизов и тегов ваших проектов на GitHub, из запросов на слияние, развёртываний, релизов и тегов ваших проектов на GitLab, а также из запросов на слияние, конвейеров, развёртываний и тегов ваших проектов на Bitbucket, поэтому вы видите их рядом с коммитами, которые за ними стоят.
Как это работает
- Подключите GitHub. Войдите через GitHub и установите приложение DeepGraph GitHub App на выбранные проекты.
- Разрешите доступ. Приложение просит читать запросы на слияние, развёртывания и запуски рабочих процессов.
- Или подключите GitLab. Войдите через GitLab. В каждом проекте нужна как минимум роль Reporter.
- Или подключите Bitbucket. Войдите через Bitbucket. Если режим DORA попросит, подключите его снова в разделе «Настройки → Подключения», чтобы DeepGraph мог читать запросы на слияние и конвейеры.
- Откройте отчёт. Вверху переключитесь с Code на DORA.
- Проверьте, что учитывается. Плашки рядом с датами показывают, куда развёртываются ваши проекты. DeepGraph сам выбирает рабочую среду, а вы можете это изменить.
Что вы увидите
Deploys — развёртывания
Сколько раз новый код попал в рабочую среду за выбранные даты. Это показывает, как часто команда выпускает изменения.
Lead time — время до выпуска
Сколько времени изменение идёт от первого коммита до рабочей среды. Число показывает, сколько обычно занимает этот путь. Чем оно меньше, тем раньше работа доходит до людей.
Failed deploys — неудачные развёртывания
Доля развёртываний, которые закончились сбоем в рабочей среде. Сбой, который повторяли, пока не получилось, считается один раз.
Time to restore — время восстановления
Сколько времени проходит после неудачного развёртывания до следующего успешного. Число показывает, сколько обычно занимает исправление.
Наведите на каждое название, чтобы прочитать, что оно означает. Под числами график показывает каждый день, неделю или месяц: успешные развёртывания поднимаются над линией, неудачные свисают под ней. Прочерк означает, что считать пока нечего, а не ноль.
Для людей и команд
DORA работает для папки, проекта, человека или команды. Числа человека учитывают развёртывания, в которые попали его принятые запросы на слияние, а команда учитывает всех, кто в ней состоит. В режиме DORA список людей показывает развёртывания каждого человека и каждой команды во времени и их четыре числа, и сортировать можно по любому из них. Используйте это, чтобы видеть, как движется работа, а не чтобы составлять рейтинг людей.
Что считать рабочей средой
Плашки показывают развёртывания, рабочие процессы, релизы, теги и запросы на слияние, принятые в ветку, и у каждой — число развёртываний. Закрашенная плашка считается рабочей средой.
В первой догадке DeepGraph пропускает названия, похожие на staging, test или preview. Сначала он выбирает развёртывания и рабочие процессы развёртывания, затем релизы, затем теги. Если ничего из этого нет, учитываются запросы на слияние, принятые в основную ветку.
В своём проекте или папке нажмите на плашку, чтобы учитывать её или нет, или откройте шестерёнку, чтобы увидеть все варианты. Выбор папки действует на все проекты в ней, и в любой момент можно вернуться к догадке DeepGraph. Любой другой человек может нажать на плашку, чтобы посмотреть только на одно место. При этом ничего не сохраняется.
DORA для каждого окружения
DORA — это не только рабочая среда. У каждого места, куда развёртывается проект, есть своя плашка со своими развёртываниями: среда развёртывания, рабочий процесс, релизы, теги или ветка, в которую сливаются запросы на слияние. Учитывайте только тестовую среду или один рабочий процесс, и четыре числа покажут только это место. В своём проекте выбор сохраняется. Любой другой человек может посмотреть на одно место, ничего не сохраняя.
Чего DORA не делает
- Работает с подключёнными проектами на GitHub, gitlab.com и bitbucket.org. У GitLab на собственных серверах, Bitbucket Data Center, проектов на компьютере и публичных проектов, добавленных по ссылке, режима DORA нет.
- На GitLab не читает конвейеры: учитываются развёртывания, релизы, теги и принятые запросы на слияние.
- У Bitbucket нет релизов: учитываются конвейеры, развёртывания, теги и принятые запросы на слияние. Развёртывания, которые делают инструменты вне Bitbucket Pipelines, видны только как теги и слияния.
- Для неудачных развёртываний и времени восстановления нужно место, которое записывает сбои, например развёртывания GitHub, GitLab или Bitbucket, запуски рабочих процессов на GitHub или конвейеры на Bitbucket. Релизы, теги и принятые запросы на слияние сообщают только о том, что что-то вышло.
- Не читает инциденты из таких инструментов, как PagerDuty или Jira. Неудачное развёртывание — это то, которое GitHub, GitLab или Bitbucket отметили как неудачное, а время восстановления длится до следующего успешного развёртывания в том же месте.
- Первые развёртывания могут появиться не сразу после подключения.
Вопросы
Почему вкладка DORA пуста?
Наведите на вкладку, чтобы узнать причину. Возможно, нужно подключить GitHub, GitLab или Bitbucket, или DeepGraph ещё не прочитал ни одного запроса на слияние или развёртывания. См. вопросы и ответы.
Нужно ли менять то, как мы развёртываем код?
Нет. DeepGraph читает то, что GitHub, GitLab или Bitbucket уже записывают. Вы только выбираете, какие места считать рабочей средой.
Что означают эти четыре числа в целом?
Прочитайте что измеряет DORA, простыми словами.
Начните
Подключите проект на GitHub, GitLab или Bitbucket по руководству по началу работы или посмотрите тарифы и цены. DORA стоит рядом с обзором проектов и командами. См. все возможности.