Репозиторий Git#
Automation Controller поддерживает использование репозиториев Git в качестве источников кода проектов. Основной параметр, который при этом должен быть указан – URL репозитория в VCS. В каталоге для хранения проектов создается подкаталог с локальной копией указанного репозитория.
URL репозитория в зависимости от используемого протокола подключения может иметь следующий вид:
HTTPS:
https://example.org/project.git
SSH
ssh://git@example.org/project.git
GIT
git://example.org/project.git
Примечание
Поддержка протоколов и особенности их использования определяются возможностями сервиса, в котором размещен репозиторий.
Дополнительные настройки#
Для репозитория Git можно указать дополнительные параметры системы управления исходными данными.
Название ветки, название тега или хеш коммита#
По умолчанию используется последний коммит из основной ветки репозитория. Эта настройка позволяет использовать другие версии кода:
Название ветки.
Используется версия кода из последнего коммита в указанной ветке.
Например, если в репозитории основная ветка называется
main
, а ветка с экспериментальными возможностями называетсяdevelopment
, для использования кода из веткиdevelopment
необходимо указать ее название в свойствах источника.Название тега.
Используется версия кода, отмеченная указанным тегом. Например, чтобы использовать коллекции версии
1.7.0
, соответствующее значение следует указать в настройках источника.Хеш коммита.
Используется версия кода из коммита с указанным хешем. Хеш коммита может быть указан полностью или частично (первые несколько символов).
Для использования коммита с хешем
d7e82ab6ebff598b928edd356803758a3f3435ce
допускается указать значениеd7e82ab6
.Произвольная ссылка на версию кода в локальной копии репозитория.
Важно
Некоторые хеши коммитов и ссылки могут быть недоступны без указания спецификации (refspec) для измененной ссылки.
Спецификация (refspec)#
Эта настройка используется для управления ссылками в локальной копии репозитория на версии кода в удаленном репозитории.
Например, для получения из внешнего репозитория всех возможных ссылок в настройках спецификации необходимо указать следующую строку:
refs/*:refs/remotes/origin/*
Примечание
Для удаленного источника используется название origin
.
Подробности использования спецификаций ссылок см. в документации Git.
Полномочия#
Эта настройка позволяет указать полномочия, которые следует использовать для доступа к удаленному репозиторию. Для выбора доступны полномочия типа «Управление версиями».
Настройки управления версиями кода#
В настройках Automation Controller можно указать дополнительные параметры, управляющие поведением при работе с репозиторием.
Очистить
Перед выполнением обновления удаляются все сделанные изменения в локальной копии репозитория.
Удалить
При обновлении локальная копия репозитория удаляется полностью, после чего загружается заново.
Примечание
В зависимости от размера репозитория и скорости соединения процесс загрузки может занять длительное время.
Отслеживание подмодулей
Если эта настройка включена, отслеживается состояние не только основного репозитория, но и имеющихся подмодулей. Использование этой настройки эквивалентно выполнению команд
git fetch
иgit clone
с параметром--recurse-submodules
.Подробности об использовании подмодулей см. в документации Git.
Обновить версию при запуске
Если эта настройка включена, перед запуском любого задания, использующего код из этого источника, он будет автоматически обновлен.
Разрешить переопределение ветки
Если эта настройка включена, в шаблоне задания разрешается выбрать ветку или версию кода, отличную от заданной в свойствах проекта.