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

  • Обновить версию при запуске

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

  • Разрешить переопределение ветки

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