Пространства имен#
Окно Пространства имен (Namespaces) используется для управления пространствами имен коллекций Ansible. Для перехода к нему выберите на панели навигации ( ).
Окно состоит из двух вкладок:
Все (All) – все пространства имен, существующие в Private Automation Hub.
Мои пространства имен (My namespaces) – пространства имен, доступ к которым предоставлен активному пользователю непосредственно или через группы, в которых он состоит.
В обеих вкладках выводятся панели, содержащие логотип пространства имен, его название и ссылку Просмотреть коллекции (View collections).
Просмотр информации о пространстве имен#
Для просмотра подробной информации о пространстве имен нажмите на ссылку Просмотреть коллекции (View collections) на соответствующей панели.
Окно просмотра сведений о пространстве имен состоит из следующих вкладок:
Коллекции (Collections) – таблица коллекций, имеющихся в пространстве имен.
Примечание
В списке отображаются только коллекции, прошедшие согласование.
Конфигурация CLI (CLI configuration) – URI со ссылкой на Private Automation Hub. Эта ссылка может быть использована для настройки
ansible-galaxy
и Automation Controller на использование Private Automation Hub в качестве источника коллекций.Ресурсы (Resource) – дополнительные сведения о пространстве имен.
Примечание
Эта вкладка не отображается, если соответствующий раздел не заполнен.
Доступ (Access) – управление доступом к пространству имен как отдельных пользователей, так и групп.
Создание пространства имен#
Для создания пространства имен выполните следующие действия:
В окне Пространства имен (Namespaces) нажмите кнопку Создать (Create).
Заполните форму Создать новое пространство имен (Create a new namespace):
В поле Название (Name) укажите название пространства имен.
Требования к названию пространств имен:
длина не менее двух знаков;
может содержать буквы латинского алфавита, цифры и символ
_
;не может начинаться с символа
_
.
Важно
Будьте внимательны при выборе названия пространства имен – его нельзя будет изменить.
Нажмите кнопку Создать (Create).
Укажите дополнительную информацию о пространстве имен.
Изменение свойств пространства имен#
Для изменения основных сведений о пространстве имен выполните следующие действия:
На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекции (View collections).
В окне с информацией о пространстве имен нажмите кнопку ⋮ и в открывшемся меню выберите Редактировать пространство имен (Edit namespace).
Во вкладке Редактировать подробности (Edit details) укажите следующие сведения о пространстве имен:
Название компании (Company name);
URL логотипа (Logo URI) – логотип по указанной ссылке будет загружен в Private Automation Hub при сохранении изменений;
Описание (Description) – общее описание пространства имен;
Полезные ссылки – список ссылок, которые могут быть полезны при поиске информации о пространстве имен и хранящихся в нем коллекциях, например, сайт компании-разработчика.
Во вкладке Редактировать ресурсы (Edit resources) укажите дополнительную информацию о пространстве имен, которая будет выводиться при его просмотре. Для оформления содержимого используйте правила разметки Markdown.
Загрузка коллекций#
Для загрузки коллекции в пространство имен выполните следующие действия:
На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекции (View collections).
Нажмите кнопку Загрузить коллекцию (Upload collection).
В открывшемся окне заполните форму:
Выбрать файл (Select file) – файл в формате
.tar.gz
, сформированный с помощью командыansible-galaxy build
.Репозиторий (Repository):
Промежуточные репозитории – коллекция будет загружена в репозиторий на Private Automation Hub.
Все репозитории – выберите один из репозиториев для загрузки кода коллекции в него.
Важно
Для успешной загрузки коллекции необходимо наличие привилегий, позволяющих публиковать код в указанном репозитории от имени активного пользователя.
Нажмите кнопку Загрузить (Upload).
Конфигурация CLI#
Для настройки утилит командной строки на работу с Private Automation Hub выполните следующие действия:
На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекции (View collections).
Выберите вкладку Конфигурация CLI (CLI configuration).
Скопируйте ссылку, отображаемую во вкладке.
Укажите параметры подключения к Private Automation Hub в конфигурационном файле
ansible.cfg
согласно инструкции.
При использовании Automation Controller создайте полномочие типа «API-токен Ansible Galaxy/Automation Hub».
Настройка доступа#
Доступ к пространству имен может быть предоставлен отдельным пользователям и группам. Порядок настройки одинаков:
На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекци (View collections).
Выберите вкладку Доступ (Access).
Чтобы предоставить доступ к пространству имен пользователю или группе нажмите кнопку Выбрать пользователя (Select a user) или Выбрать группу (Select a group) соответственно.
В открывшемся окне выберите нужного пользователя или группу и нажмите кнопку Далее (Next).
Во вкладке Выбрать роль (роли) выберите роли, предоставляемые пользователю или группе:
Роль
Предоставляемые привилегии
galaxy.collection_namespace_owner
Изменение свойств пространства имен
Загрузка коллекций
galaxy.collection_publisher
Создание пространств имен
Изменение свойств пространства имен
Загрузка коллекций
Нажмите кнопку Далее (Next).
Во вкладке Предварительный просмотр (Preview) проверьте корректность настроек и нажмите кнопку Добавить (Add).
Удаление пространства имен#
Предупреждение
При удалении пространства имен также удаляются все содержащиеся в нем коллекции.
Это действие нельзя отменить.
Чтобы удалить пространство имен, выполните следующие действия:
На панели с названием удаляемого пространства имен нажмите на ссылку Просмотреть коллекции (View collections).
В окне с информацией о пространстве имен нажмите кнопку ⋮ и в открывшемся меню выберите Удалить пространство имен (Delete namespace).
В открывшемся окне включите флаг Я понимаю, что это действие не может быть отменено (I understand that this action cannot be undone) и нажмите кнопку Удалить.