Конфигурация параметров организации в виде кода в SourceCraft
Вы можете управлять общими правилами ревью кода, политиками веток и пользовательскими полями задач для всех репозиториев организации, а также политиками доступа организации с помощью специального репозитория с названием .sourcecraft. Это обеспечивает единые стандарты разработки и упрощает администрирование.
При создании репозитория .sourcecraft все конфигурационные файлы из него автоматически применяются ко всем репозиториям организации. Репозиторий может быть приватным — конфигурации все равно будут работать для всех репозиториев организации.
Конфигурационные файлы
В репозитории .sourcecraft поддерживаются следующие конфигурационные файлы:
.sourcecraft/review.yaml— правила ревью кода..sourcecraft/branches.yaml— политики защиты веток..sourcecraft/issues.yaml— пользовательские поля задач..sourcecraft/policies.yaml— политики доступа организации.
Для правил ревью кода, политик веток и пользовательских полей задач синтаксис настроек на уровне организации идентичен синтаксису настроек на уровне репозитория.
Принципы применения конфигураций
Изменения конфигурации применяются сразу после внесения изменений в главную ветку репозитория .sourcecraft, например main или master. Изменения в других ветках не применяются — это позволяет работать над изменениями конфигурации в отдельных ветках.
При обнаружении ошибок в конфигурациях слияние веток отклоняется с подробным описанием всех проблем.
Правила ревью кода и политики веток
Отдельные репозитории могут переопределять правила ревью кода и политики веток, но только в сторону усиления требований. Например, если на уровне организации требуется 2 одобрения предложения изменений, конкретный репозиторий может потребовать 3 одобрения, но не может уменьшить это количество до 1.
Пользовательские параметры задач
Конфигурация репозитория имеет приоритет над конфигурацией организации. Если в обеих конфигурациях указан объект с одинаковым slug, используются параметры из репозитория. Списки значений enum из конфигурации репозитория заменяют организационные списки целиком.
На странице задачи сначала отображаются поля организации, а затем поля репозитория. Порядок внутри каждой группы соответствует порядку в соответствующем файле .sourcecraft/issues.yaml.
Полезные ссылки
- Настроить правила ревью кода и политики веток на уровне организации в SourceCraft
- Настроить политику доступа в организации SourceCraft
- Настроить правила ревью кода в репозитории SourceCraft
- Настроить политику веток в репозитории SourceCraft
- Настроить пользовательские поля задач в SourceCraft
- Правила ревью кода в SourceCraft
- Политики веток в SourceCraft