Репозиторий 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/heads/*
) и его представление в локальном репозитории (например, refs/heads/origin/*
).
Например, чтобы настроить Git на получение содержимого удаленной ветки release-1.0
в локальную ветку stable
, используйте следующую спецификацию:
refs/heads/release-1.0:refs/heads/origin/stable
Важно
Automation Controller использует для работы с удаленными репозиториями Git название origin
.
Подробности использования спецификаций ссылок см. в документации Git.
Полномочия#
Эта настройка позволяет указать полномочия типа Система управления версиями (Source Control), которые Automation Controller будет использовать для доступа к репозиторию.
Для создания полномочий через веб-интерфейс воспользуйтесь инструкцией.
Настройки управления версиями кода#
В настройках Automation Controller можно указать дополнительные параметры, управляющие поведением при работе с репозиторием.
Очистить
Перед выполнением обновления удаляются все сделанные изменения в локальной копии репозитория.
Удалить
При обновлении локальная копия репозитория удаляется полностью, после чего загружается заново.
Примечание
В зависимости от размера репозитория и скорости соединения процесс загрузки может занять длительное время.
Отслеживание подмодулей
Если эта настройка включена, отслеживается состояние не только основного репозитория, но и имеющихся подмодулей. Использование этой настройки эквивалентно выполнению команд
git fetch
иgit clone
с параметром--recurse-submodules
.Подробности об использовании подмодулей см. в документации Git.
Обновить версию при запуске
Если эта настройка включена, перед запуском любого задания, использующего код из этого источника, он будет автоматически обновлен.
Разрешить переопределение ветки
Если эта настройка включена, в шаблоне задания разрешается выбрать ветку или версию кода, отличную от заданной в свойствах проекта.