Репозитории#

Окно Репозитории (Repositories) позволяет выполнять следующие действия:

Для перехода в окно Репозитории (Repositories) выберите на панели навигации Коллекции ‣ Репозитории (Collections ‣ Repositories).

../../../../_images/repositories-index.png

Таблица репозиториев состоит из следующих колонок:

  • Название репозитория (Repository name) – название репозитория. При нажатии на ссылку происходит переход в окно просмотра подробной информации о репозитории.

  • Метки (Labels) – метки, которыми отмечен репозиторий.

  • Приватный (Private) – если репозиторий приватный, доступ к нему имеют только аутентифицированные пользователи.

  • Состояние синхронизации (Sync status) – количество времени с момента последней синхронизации репозитория с внешним репозиторием.

  • Дата создания (Created date) – количество времени с момента создания репозитория.

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

Просмотр#

Для получения подробных сведений о репозитории нажмите на ссылку с его названием в таблице репозиториев. Окно просмотра сведений о репозитории состоит из следующих вкладок:

  • Подробности (Details) – общие сведения о репозитории: название, описание, количество версий, сохраненное в Private Automation Hub, URL репозитория и так далее.

  • Доступ – пользователи-владельцы и группы-владельцы репозитория.

  • Версии коллекции (Collections versions) – список коллекций с указанием версий, загруженных в Private Automation Hub.

  • Версии – версии репозитория, хранящегося в Private Automation Hub.

    Таблица версий состоит из следующих колонок:

    • Номер версии (Version number) – номер версии репозитория.

    • Дата создания (Created date) – количество времени с момента создания версии.

    • Кнопка , позволяющая вернуть состояние репозитория к выбранной версии.

Создание репозитория#

Для создания репозитория выполните следующие действия:

  1. В окне Репозитории (Repositories) нажмите кнопку Добавить репозиторий (Add repository).

  2. Заполните форму Добавить новый репозиторий (Add new repository):

    • Название (Name) – название репозитория в Private Automation Hub.

      Важно

      Будьте внимательны при выборе названия – его нельзя будет изменить.

    • Описание (Descrption) – краткое описание репозитория, например, для каких целей он создается.

    • Сохраненное количество версий (Retained number of versions) – количество версий репозитория, которое будет храниться в Private Automation Hub. При создании новой версии самая старая будет удаляться автоматически.

    • Создать дистрибутив (Create a distribution) – если этот флаг выключен, пользователи Private Automation Hub не смогут синхронизировать, загружать и искать содержимое, хранящееся в репозитории.

    • Конвейер задач (Pipeline) – порядок попадания содержимого в репозиторий:

      • Ничего (None) – для загрузки коллекций пользователям требуются привилегии на изменение содержимого.

      • Согласовано (Approved) – коллекции попадают в репозиторий после согласования. Публикация коллекций напрямую в этот репозиторий отключена.

      • Промежуточный (Staging) – хранящиеся в репозитории коллекции требуют согласования, чтобы попасть на страницу поиска. Загружать коллекции в этот репозиторий могут любые пользователи, имеющие привилегии на загрузку содержимого в пространства имен.

    • Скрыть от поиска (Hide from search) – если этот флаг включен, хранящиеся в репозитории коллекции не будут выводиться в результатах поиска.

    • Сделать приватным (Make private)

    • Удаленный (Remote) – внешний репозиторий, из которого при синхронизации загружается содержимое.

  3. Нажмите кнопку Сохранить (Save).

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

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

  1. В таблице со списком репозиториев нажмите на ссылку с названием нужной записи.

  2. Выберите вкладку Доступ (Access).

  3. Чтобы сделать владельцем репозитория пользователя или группу, нажмите кнопку Выбрать пользователя (Select a user) или Выбрать группу (Select a group) соответственно.

  4. В открывшемся окне выберите нужного пользователя или группу и нажмите кнопку Далее (Next).

  5. Во вкладке Выбрать роль (роли) (Select role(s)) включите флаг роли galaxy.ansible_repository_owner и нажмите кнопку Далее (Next).

  6. Во вкладке Предварительный просмотр (Preview) проверьте корректность настроек и нажмите кнопку Добавить (Add).

Настройка CLI на работу с репозиторием#

Чтобы настроить инструменты командной строки Ansible на работу с репозиторием, выполните следующие действия:

  1. В таблице со списком репозиториев нажмите на ссылку с названием нужной записи.

  2. Нажмите кнопку Скопировать конфигурацию CLI (Copy CLI configuration). Необходимые настройки будут автоматически скопированы в буфер обмена.

  3. Добавьте строки из буфера обмена в конфигурационный файл ansible.cfg.

Синхронизация с внешним репозиторием#

Чтобы синхронизировать содержимое репозитория Private Automation Hub с внешним репозиторием, выполните следующие действия:

  1. В таблице со списком репозиториев нажмите на ссылку с названием нужной записи.

  2. Нажмите кнопку Синхронизация (Sync).

  3. В открывшемся окне укажите настройки синхронизации:

    • Зеркало (Mirror) – если этот флаг включен, Private Automation Hub выполняет с версиями коллекций следующие действия:

      • удаляет версии, отсутствующие в источнике;

      • загружает из внешнего источника версии, которых нет в репозитории;

      • отмечает как устаревшие версии, отмеченные как устаревшие в источнике;

      • отмечает как актуальные версии, отмеченные как актуальные в источнике.

    • Оптимизировать (Optimize) – если этот флаг включен, загрузка содержимого из внешнего репозитория будет выполняться только в том случае, если внешний репозиторий подтвердит наличие изменений.

  4. Нажмите кнопку Синхронизация.

Управление версиями репозитория#

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

  1. В таблице со списком репозиториев нажмите на ссылку с названием нужной записи.

  2. Выберите вкладку Версии (Version).

  3. В таблице версий нажмите кнопку в строке с нужной записью и в открывшемся меню выберите Вернуть к этой версии (Revert to this version).

Удаление репозитория#

Предупреждение

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

Для удаления репозитория выполните следующие действия:

  1. В таблице со списком репозиториев нажмите на ссылку с названием нужной записи.

  2. Нажмите кнопку Удалить.

  3. Подтвердите удаление.