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

Примечание

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

Дополнительные настройки

Для репозитория Git можно указать дополнительные параметры системы управления исходными данными.

Название ветки, название тега или хеш коммита

По умолчанию используется последний коммит из основной ветки репозитория. Эта настройка позволяет использовать другие версии кода:

• Название ветки.

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

  Например, если в репозитории основная ветка называется main, а ветка с экспериментальными возможностями называется development, для использования кода из ветки development необходимо указать ее название в свойствах источника.

• Название тега.

  Используется версия кода, отмеченная указанным тегом.

  Номера версий коллекций Ansible в Automation Hub указываются в названиях тегов. Чтобы использовать коллекцию astra.nginx версии 1.7.0, соответствующее значение следует указать в настройках источника.

• Хеш коммита.

  Используется версия кода из коммита с указанным хешем. Хеш коммита может быть указан полностью или частично (первые несколько символов).

  Для использования коммита с хешем d7e82ab6ebff598b928edd356803758a3f3435ce допускается указать значение d7e82ab6.

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

Важно

Некоторые хеши коммитов и ссылки могут быть недоступны без указания спецификации (refspec) для измененной ссылки.

Спецификация (refspec)

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

Например, для получения из внешнего репозитория всех возможных ссылок в настройках спецификации необходимо указать следующую строку:

refs/*:refs/remotes/origin/*

Примечание

Для удаленного источника используется название origin.

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

Полномочия

Эта настройка позволяет указать полномочия, которые следует использовать для доступа к удаленному репозиторию. Для выбора доступны полномочия типа «Управление версиями».

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

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

• Очистить

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

• Удалить

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

  Примечание

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

• Отслеживание подмодулей

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

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

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

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

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

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