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

Окно Пространства имен (Namespaces) предназначено для централизованного управления пространствами имен коллекций Ansible с помощью следующих операций:

• организация структуры контента по проектам и командам;

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

• контроль публикаций и распространение контента внутри организации.

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

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

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

Окно Пространства имен (Namespaces) состоит из двух вкладок:

• Все (All) – все пространства имен, существующие в Private Automation Hub.

• Мои пространства имен (My namespaces) – пространства имен, доступ к которым предоставлен активному пользователю непосредственно или через команды, в которых он состоит.

В обеих вкладках выводится таблица, содержащая следующие столбцы:

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

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

• Описание (Description);

• Компания (Company) – компания, связанная с пространством имен;

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

  • переход в окно редактирования свойств пространства имен;

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

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

Просмотр информации о пространстве имен

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

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

• Подробности (Details) – основная информация о пространстве имен.

• Коллекции (Collections) – таблица коллекций, имеющихся в пространстве имен.

  Примечание

  В списке отображаются только коллекции, прошедшие согласование.

• Настройка CLI (CLI configuration) – URL со ссылкой на Private Automation Hub. Эта ссылка может быть использована для настройки ansible-galaxy и Automation Controller на использование Private Automation Hub в качестве источника коллекций.

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

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

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

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

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

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

   • Название (Name) – название пространства имен.

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

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

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

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

     Важно

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

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

   • Компания (Company) – компания, связанная с пространством имен.

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

   • Ресурсы (Resources) – дополнительные сведения о пространстве имен в формате Markdown.

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

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

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

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

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

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

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

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

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

3. Во вкладке Редактировать <название_пространства_имен> (Edit <namespace_name>) отредактируйте необходимые сведения.

4. Нажмите кнопку Сохранить пространство имен (Save namespace).

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

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

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

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

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

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

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

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

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

       Важно

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

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

Настройка CLI

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

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

2. Выберите вкладку Настройка CLI (CLI configuration).

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

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

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

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

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

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

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

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

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

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

   Роль	Предоставляемые привилегии
   galaxy.collection_namespace_owner	Изменение свойств пространства имен Загрузка коллекций
   galaxy.collection_publisher	Создание пространств имен Изменение свойств пространства имен Загрузка коллекций

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

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

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

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

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

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

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

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

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

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