Репозиторий Git

Репозиторий 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)#

Эта настройка устанавливает связь между объектом в удаленном и локальном репозиториях.

Например, чтобы настроить Git на получение содержимого удаленной ветки release-1.0 в локальную ветку stable, используйте следующую спецификацию:

refs/heads/release-1.0:refs/heads/stable

Важно

Automation Controller использует для работы с удаленными репозиториями Git название origin.

Подробности использования спецификаций ссылок см. в документации Git.

Полномочия#

Эта настройка позволяет указать полномочия типа Система управления версиями (Source Control), которые Automation Controller будет использовать для доступа к репозиторию.

Для создания полномочий через веб-интерфейс воспользуйтесь инструкцией.

Настройки управления версиями кода#

В настройках Automation Controller можно указать дополнительные параметры, управляющие поведением при работе с репозиторием.

  • Стереть (Clean)

    Перед выполнением обновления удаляются все сделанные изменения в локальной копии репозитория.

  • Удалить (Delete)

    При обновлении локальная копия репозитория удаляется полностью, после чего загружается заново.

    Примечание

    В зависимости от размера репозитория и скорости соединения процесс загрузки может занять длительное время.

  • Отслеживать подмодули (Track submodules)

    Если эта настройка включена, отслеживается состояние не только основного репозитория, но и имеющихся подмодулей. Использование этой настройки эквивалентно выполнению команд git fetch и git clone с параметром --recurse-submodules.

    Подробности об использовании подмодулей см. в документации Git.

  • Обновить ревизию при запуске (Update revision on launch)

    Если эта настройка включена, перед запуском любого задания, использующего код из этого источника, он будет автоматически обновлен.

  • Разрешить переопределение ветви (Allow branch override)

    Если эта настройка включена, в шаблоне задания разрешается выбрать ветку или версию кода, отличную от заданной в свойствах проекта.