Репозитории

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

• просматривать сведения о существующих репозиториях;

• создавать новые репозитории;

• изменять настройки существующих репозиториев;

• управлять доступом к репозиториям;

• получать настройки для использования репозитория утилитами Ansible;

• синхронизировать содержимое репозиториев Private Automation Hub с внешними репозиториями;

• управлять версиями репозиториев;

• удалять репозитории.

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

Таблица репозиториев

Внешний вид окна Репозитории (Repositories) представлен на схеме:

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

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

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

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

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

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

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

  • редактирование репозитория;

  • синхронизация репозитория;

  • копирование настроек CLI;

  • удаление репозитория.

Просмотр

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

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

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

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

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

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

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

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

• Распределения (Distributions) – список точек распространения содержимого репозитория, а также краткая инструкция по настройке ansible-galaxy для их использования.

• Командный доступ (Team Access) – таблица команд и назначенных им ролей.

• Доступ пользователей (User Access) – таблица пользователей и назначенных им ролей.

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

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

1. В окне Репозитории (Repositories) нажмите кнопку Создать репозиторий (Create repository).

2. Заполните форму Создать репозиторий (Create repository):

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

     Важно

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

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

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

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

     Примечание

     В свойствах защищенных репозиториев aa-certified, validated, community и published эта настройка по умолчанию включена, и выключить ее нельзя.

     В свойствах защищенных репозиториев rejected и staging эта настройка по умолчанию выключена, и включить ее нельзя.

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

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

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

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

   • Метки (Labels) – метки репозитория.

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

   • Сделать приватным (Make private) – если этот флаг включен, содержимое репозитория смогут использовать только его пользователи-владельцы.

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

3. Нажмите кнопку Создать репозиторий (Create repository).

Изменение репозитория

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

1. В окне Репозитории (Repositories) нажмите на название репозитория, свойства которого необходимо изменить.

2. В окне свойств выбранного репозитория нажмите кнопку Редактировать репозиторий (Edit repository).

3. Измените свойства репозитория.

   Важно

   Название существующего репозитория нельзя изменить. У защищенных репозиториев также недоступны для изменения некоторые другие свойства.

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

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

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

     Примечание

     В свойствах защищенных репозиториев aa-certified, validated, community и published эта настройка по умолчанию включена, и выключить ее нельзя.

     В свойствах защищенных репозиториев rejected и staging эта настройка по умолчанию выключена, и включить ее нельзя.

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

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

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

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

   • Метки (Labels) – метки репозитория.

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

   • Сделать приватным (Make private) – если этот флаг включен, содержимое репозитория смогут использовать только его пользователи-владельцы.

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

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

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

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

1. В окне Репозитории (Repositories) нажмите на название репозитория, доступ к которому необходимо настроить.

2. Выберите вкладку Командный доступ (Team Access) или Доступ пользователей (User Access).

3. Нажмите кнопку Добавить роль (Add roles).

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

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

6. Во вкладке Обзор (Review) проверьте корректность настроек и нажмите кнопку Завершить (Finish).

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

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

1. В окне Репозитории (Repositories) нажмите на название репозитория, который необходимо настроить.

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

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

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

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

1. В окне Репозитории (Repositories) нажмите на название репозитория, содержимое которого необходимо синхронизировать.

2. Нажмите кнопку ⋮ и в открывшемся меню выберите пункт Синхронизировать репозиторий (Sync repository).

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

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

     1. Удаляет версии, отсутствующие в источнике.

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

     3. Отмечает как устаревшие версии, отмеченные как устаревшие в источнике.

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

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

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

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

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

1. В окне Репозитории (Repositories) нажмите на название репозитория, который необходимо вернуть в одно из прежних состояний.

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

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

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

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

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

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

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

2. На панели инструментов нажмите кнопку ⋮ и в открывшемся меню выберите пункт Удалить репозитории (Delete repositories).

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