Согласования коллекций

Согласования коллекций#

Окно Согласования коллекций (Collection Approvals) используется для согласования публикации коллекции в корпоративном каталоге контента (Private Automation Hub) с помощью следующих операций:

  • отслеживание новых версий коллекций, ожидающих согласования;

  • проведение проверок и валидации содержимого коллекций перед публикацией;

  • согласование или отклонение выпуска для контроля качества корпоративного контента.

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

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

Внешний вид окна Согласования коллекций (Collection Approvals) представлен на схеме:

../../../_images/approval-index-light.png ../../../_images/approval-index-dark.png

Окно Согласования коллекций (Collection Approvals) состоит из панели фильтрации и таблицы версий коллекций с их статусами согласования. По умолчанию в таблице выводятся только версии, ожидающие согласования. С помощью фильтра Статус (Status) можно вывести версии в любых статусах: Нуждается в пересмотре (Needs review), Согласовано (Approved), Отклонено (Rejected).

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

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

  • Пространство имен (Namespace) – название пространства имен, к которому относится коллекция.

  • Коллекция (Collection) – название коллекции.

  • Версия (Version) – ссылка с номером версии коллекции. В этом же столбце находится ссылка на загрузку архива с версией коллекции.

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

  • Статус (Status) – текущий статус версии коллекции.

  • Дата создания (Date created) – дата и время создания версии коллекции.

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

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

    • отклонение версии коллекции;

    • переход в журнал импорта.

Просмотр#

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

Загрузка кода коллекции на локальный компьютер#

Чтобы изучить исходный код коллекции, загрузите его на локальный компьютер.

  1. Нажмите на ссылку в столбце Версия (Version).

  2. Перейдите во вкладку Установить (Install).

  3. Нажмите на кнопку Загрузить архив tarball (Download tarball), чтобы сохранить архив на локальный компьютер.

  4. Создайте каталог для распаковки архива, например:

    mkdir astra-nginx-1.8.0/

  5. Распакуйте содержимое архива в созданный каталог:

    tar xf astra-nginx-1.8.0.tar.gz -C ./astra-nginx-1.8.0/

Просмотр основных сведений о версии коллекции#

Чтобы просмотреть общую информацию о версии коллекции до ее согласования, нажмите на ссылку в столбце Версия (Version).

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

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

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

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

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

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

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

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

Согласование и отклонение версий коллекции#

Чтобы согласовать версию коллекции, нажмите кнопку Согласовать и подписать коллекцию (Approve and sign collection) в соответствующей строке и подтвердите согласование. Версия коллекции будет перемещена в соответствующий репозиторий. Если в настройках репозитория включено создание дистрибутива, коллекция будет доступна для поиска и загрузки пользователями.

Примечание

Метка кнопки не зависит от настройки автоматической подписи коллекций. При выключенной автоподписи диалог подтверждения предлагает только согласование (Согласовать коллекцию (Approve collections)), подпись при этом не выполняется.

Чтобы отклонить версию коллекции, в соответствующей строке нажмите кнопку Отклонить сбор (Reject collection) и подтвердите отклонение коллекции.

Важно

При отклонении версия коллекции не удаляется из Private Automation Hub, а перемещается в защищенный репозиторий rejected. Для окончательного удаления версии коллекции удалите ее из этого репозитория.