Коллекции

Окно Коллекции (Collections) служит центральной точкой для работы с коллекциями Ansible, доступными в Private Automation Hub, с помощью следующих операций:

• просмотр опубликованных коллекций и их версий;

• изучение доступных ролей, модулей и расширений.

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

Описание окна

Внешний вид окна Коллекции (Collections) представлен на схеме:

Таблица коллекций состоит из столбцов согласно настройке с помощью кнопки Настроить столбцы (Manage columns). Полный список столбцов:

• флаги для выбора нескольких записей;

• Название (Name) – ссылка на окно просмотра сведений о коллекции;

• Предоставлено (Provided by) – название организации или учетной записи пользователя, опубликовавших коллекцию;

• Репозиторий (Repository) – ссылка на окно просмотра сведений о репозитории, в котором опубликована коллекция;

• Пространство имен (Namespace) – ссылка на окно просмотра сведений о пространстве имен, в которое загружена коллекция;

• Описание (Description) – описание коллекции;

• Модули (Modules) – количество модулей в коллекции;

• Роли (Roles) – количество ролей в коллекции;

• Расширения (Plugins) – количество расширений в коллекции;

• Зависимости (Dependencies) – количество зависимостей коллекции;

• Обновлено (Updated) – дата и время последнего обновления коллекции;

• Версия (Version) – версия коллекции;

• Подписанное состояние (Signed state) – статус подписи коллекции, показывающий, была ли коллекция подписана для подтверждения ее подлинности и целостности;

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

  • загрузка новой версии коллекции;

  • отмена коллекции как устаревшей;

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

  • удаление коллекции из репозитория;

  • удаление коллекции из системы.

Просмотр информации о коллекции

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

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

• Подробности (Details) – подробные сведения о коллекции;

• Установить (Install) – инструкция по установке коллекции с использованием утилиты ansible-galaxy;

• Документация (Documentation) – документация коллекции, входящих в нее ролей и модулей;

• Содержимое (Contents) – краткая информация о модулях и ролях, предоставляемых коллекцией;

• Журнал импорта (Import log) – журнал импорта коллекции в Private Automation Hub;

• Зависимости (Dependencies) – список зависимостей коллекции;

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

Загрузка коллекции

Для загрузки в Private Automation Hub версии коллекции выполните следующие действия:

1. В окне Коллекции (Collections) нажмите кнопку Загрузить коллекцию (Upload collection).

2. В открывшемся окне заполните форму:

   • Файл коллекций (Collection file) – файл в формате .tar.gz, сформированный с помощью команды ansible-galaxy build.

   • Переключатель доступных для выбора репозиториев:

     • Тестовые репозитории (Staging Repos) – для выбора будут доступны только промежуточные репозитории. Загруженная версия коллекции будет ожидать согласования.

     • Хранилища без конвейера (Repositories without pipeline) – для выбора будут доступны все репозитории, кроме имеющих метки pipeline: approved и pipeline: rejected.

       Важно

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

3. Нажмите кнопку Загрузить коллекцию (Upload collection).

Удаление коллекции или ее версии

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

1. В окне Коллекции (Collections) нажмите на название коллекции, версию которой необходимо удалить.

2. В окне просмотра сведений о коллекции выберите в выпадающем списке версию, которую хотите удалить.

3. Нажмите кнопку ⋮ и в открывшемся меню выберите соответствующий пункт:

   • Удалить всю коллекцию из системы (Delete entire collection from system) – удаление всех версий коллекции из Private Automation Hub.

   • Удалить всю коллекцию из репозитория (Delete entire collection from repository) – удаление записи о коллекции из репозитория.

   • Удалить версию из системы (Delete version from system) – удаление из Private Automation Hub только выбранной версии коллекции.

   • Удалить версию из репозитория (Delete version from repository) – удаление из репозитория записи только о выбранной версии коллекции.

4. Подтвердите удаление и нажмите кнопку Удалить коллекцию (Delete collections).

Отмена коллекции как устаревшей

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

1. В окне Коллекции (Collections) нажмите на название коллекции, которую необходимо отменить.

2. Нажмите кнопку ⋮ и в открывшемся меню выберите пункт Отменить коллекцию как устаревшие (Deprecate collection).

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

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

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

3. Подтвердите устаревание коллекции и нажмите кнопку Отменить коллекцию как устаревшие (Deprecate collection).

Отмена устаревания коллекции

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

1. Перейдите в окно Репозитории (Repositories).

2. Нажмите на название репозитория в котором опубликована коллекция, устаревание которой необходимо отменить.

3. Перейдите во вкладку Версии (Versions).

4. Нажмите на номер последней версии.

5. Перейдите во вкладку Коллекции (Collections).

6. Нажмите на название коллекции, устаревание которой необходимо отменить.

7. Нажмите кнопку ⋮ и в открывшемся меню выберите пункт Отменить устаревание коллекции (Undeprecate collection).

8. Подтвердите отмену устаревания коллекции и нажмите кнопку Отменить устаревание коллекций (Undeprecate collection).

Копирование в другие репозитории

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

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

2. В окне просмотра сведений о коллекции выберите в выпадающем списке необходимую версию.

3. Нажмите кнопку ⋮ и в открывшемся меню выберите пункт Скопировать версию в репозитории (Copy version to repositories).

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

Загрузка новой версии

Чтобы загрузить в Private Automation Hub новую версию коллекции, выполните следующие действия:

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

2. Нажмите кнопку ⋮ и в открывшемся меню выберите пункт Загрузить новую версию (Upload new version).

3. В открывшемся окне заполните форму:

   • Файл коллекций (Collection file) – файл в формате .tar.gz, сформированный с помощью команды ansible-galaxy build.

   • Переключатель доступных для выбора репозиториев:

     • Тестовые репозитории (Staging Repos) – для выбора будут доступны только промежуточные репозитории. Загруженная версия коллекции будет ожидать согласования.

     • Хранилища без конвейера (Repositories without pipeline) – для выбора будут доступны все репозитории, кроме имеющих метки pipeline: approved и pipeline: rejected.

       Важно

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

4. Нажмите кнопку Загрузить коллекцию (Upload collection).