Пространства имен#

Окно Пространства имен (Namespaces) используется для управления пространствами имен коллекций Ansible. Для перехода к нему выберите на панели навигации Коллекции ‣ Пространства имен (Collections ‣ Namespaces).

../../../../_images/namespaces-index.png

Окно состоит из двух вкладок:

  • Все (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) – управление доступом к пространству имен как отдельных пользователей, так и групп.

Создание пространства имен#

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

  1. В окне Пространства имен (Namespaces) нажмите кнопку Создать (Create).

  2. Заполните форму Создать новое пространство имен (Create a new namespace):

    В поле Название (Name) укажите название пространства имен.

    Требования к названию пространств имен:

    • длина не менее двух знаков;

    • может содержать буквы латинского алфавита, цифры и символ _;

    • не может начинаться с символа _.

    Важно

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

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

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

  5. Настройте параметры CLI.

  6. Укажите дополнительную информацию о пространстве имен.

  7. Настройте параметры доступа.

Изменение свойств пространства имен#

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

  1. На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекции (View collections).

  2. В окне с информацией о пространстве имен нажмите кнопку и в открывшемся меню выберите Редактировать пространство имен (Edit namespace).

  3. Во вкладке Редактировать подробности (Edit details) укажите следующие сведения о пространстве имен:

    • Название компании (Company name);

    • URL логотипа (Logo URI) – логотип по указанной ссылке будет загружен в Private Automation Hub при сохранении изменений;

    • Описание (Description) – общее описание пространства имен;

    • Полезные ссылки – список ссылок, которые могут быть полезны при поиске информации о пространстве имен и хранящихся в нем коллекциях, например, сайт компании-разработчика.

  4. Во вкладке Редактировать ресурсы (Edit resources) укажите дополнительную информацию о пространстве имен, которая будет выводиться при его просмотре. Для оформления содержимого используйте правила разметки Markdown.

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

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

  1. На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекции (View collections).

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

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

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

    • Репозиторий (Repository):

      • Промежуточные репозитории – коллекция будет загружена в репозиторий на Private Automation Hub.

      • Все репозитории – выберите один из репозиториев для загрузки кода коллекции в него.

        Важно

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

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

Конфигурация CLI#

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

  1. На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекции (View collections).

  2. Выберите вкладку Конфигурация CLI (CLI configuration).

  3. Скопируйте ссылку, отображаемую во вкладке.

  4. Укажите параметры подключения к Private Automation Hub в конфигурационном файле ansible.cfg согласно инструкции.

При использовании Automation Controller создайте полномочие типа «API-токен Ansible Galaxy/Automation Hub».

Настройка доступа#

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

  1. На панели с названием нужного пространства имен нажмите на ссылку Просмотреть коллекци (View collections).

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

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

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

  5. Во вкладке Выбрать роль (роли) выберите роли, предоставляемые пользователю или группе:

    Роль

    Предоставляемые привилегии

    galaxy.collection_namespace_owner

    • Изменение свойств пространства имен

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

    galaxy.collection_publisher

    • Создание пространств имен

    • Изменение свойств пространства имен

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

  6. Нажмите кнопку Далее (Next).

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

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

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

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

  • Это действие нельзя отменить.

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

  1. На панели с названием удаляемого пространства имен нажмите на ссылку Просмотреть коллекции (View collections).

  2. В окне с информацией о пространстве имен нажмите кнопку и в открывшемся меню выберите Удалить пространство имен (Delete namespace).

  3. В открывшемся окне включите флаг Я понимаю, что это действие не может быть отменено (I understand that this action cannot be undone) и нажмите кнопку Удалить.