Синхронизация коллекций#
Синхронизация Private Automation Hub с другими реестрами коллекций позволяет решить следующие задачи:
сокращение времени загрузки коллекций в Automation Controller и на рабочие места пользователей Ansible;
поддержание актуальности версий коллекций в Private Automation Hub;
тонкая настройка доступности версий коллекций.
В результате синхронизации в Private Automation Hub будут доступны коллекции, распространяемые через сторонние реестры. Например, вы можете настроить синхронизацию Private Automation Hub с реестром Automation Hub, чтобы всегда иметь под рукой необходимые версии коллекций, созданных ПАО Группа Астра и ее партнерами.
Для настройки синхронизации коллекций с внешним реестром необходимо выполнить описанные далее действия.
Получение полномочий#
Некоторые реестры коллекций, например, Ansible Galaxy, не требуют полномочий для доступа к содержимому. Другие предоставляют доступ только авторизованным пользователям. В этом случае для синхронизации коллекций необходимо получить соответствующие полномочия.
Авторизация в Automation Hub осуществляется по токену. Для его создания воспользуйтесь инструкцией.
Прочие реестры коллекций могут использовать для авторизации имя пользователя и пароль, токен, ключи SSH и тому подобное. Для получения необходимых полномочий обратитесь к владельцу соответствующего реестра.
Private Automation Hub может использоваться как источник коллекций. Для авторизации в нем можно использовать следующие способы:
токен;
имя пользователя и пароль.
Настройка синхронизации#
Чтобы Private Automation Hub мог получать коллекции из стороннего реестра коллекций, выполните следующие действия:
Согласно инструкции добавьте внешний репозиторий со следующими свойствами:
Название (Name): произвольное название внешнего репозитория, например,
Automation Hub
.URL: URL репозитория во внешнем реестре, например:
https://hub.example.com/api/galaxy/content/<repository>/
Важно
URL репозитория должен завершаться символом
/
.Здесь <repository> – название репозитория во внешнем реестре.
По умолчанию коллекции загружаются из репозитория
published
. В этом случае допускается указать сокращенный URL:https://hub.example.com/api/galaxy/
Требования YAML (YAML requirements) – если вы хотите синхронизировать все доступные коллекции, оставьте это поле пустым. Чтобы синхронизировать только определенные коллекции, укажите их названия, например:
--- collections: - name: astra.ald_pro - name: astra.ceph - name: astra.nginx
Также укажите полномочия, используемые для авторизации во внешнем реестре. При настройке синхронизации Private Automation Hub с реестром Automation Hub заполните поле Токен, а поля Имя пользователя и Пароль оставьте пустыми.
Согласно инструкции создайте репозиторий, в котором будут размещаться коллекции, полученные из стороннего реестра. В поле Внешний репозиторий (Remote) выберите внешний репозиторий, созданный на предыдущем шаге.
Синхронизация#
Следуя инструкции запустите синхронизацию репозитория с внешним источником. Дождитесь перехода задания синхронизации в статус Успешно (Success).
Совет
Для отслеживания процесса синхронизации в реальном времени выполните следующие действия:
На панели навигации выберите пункт Управление задачами (Task management).
Нажмите на ссылку с названием задачи синхронизации.
Сообщения о ходе синхронизации выводятся на панели Сообщения о ходе исполнения (Progress messages).
Публикация#
Чтобы загруженные коллекции были доступны пользователям, разместите их в репозитории со следующими свойствами:
Присвоена метка
pipeline: approved
.Если версии коллекций загружены в репозиторий с меткой
pipeline: staging
, проведите согласование.Если версии коллекций загружены в репозиторий без меток, измените его конвейер задач на Согласовано (Approved). Метка
pipeline: approved
будет присвоена автоматически.Включена настройка Создать дистрибутив (Create distribution).
Совет
В свойствах защищенных репозиториев
aa-certified
,validated
,community
иpublished
эта настройка включена по умолчанию.
Проверка результатов синхронизации#
Для проверки успешности синхронизации выполните следующие действия в Private Automation Hub и внешнем реестре:
На панели навигации выберите пункт
( ).Нажмите на ссылку с названием синхронизированного пространства имен.
Убедитесь, что выбранное пространство имен в Private Automation Hub и внешнем реестре содержит один и тот же набор коллекций.
Рекомендуемые настройки синхронизации с Automation Hub#
В Private Automation Hub по умолчанию доступны репозитории validated
и aa-certified
.
Чтобы настроить их на получение проверенных и сертифицированных коллекций из Automation Hub, выполните следующие действия:
Создайте токен для доступа к Automation Hub согласно инструкции.
В свойствах внешнего репозитория
aa-certified
укажите значение токена для доступа к Automation Hub.Добавьте внешний репозиторий согласно инструкции:
Название:
aa-validated
.URL:
https://hub.astra-automation.ru/api/galaxy/content/validated/
Токен: укажите значение токена для доступа к Automation Hub.
Измените настройки репозитория
validated
согласно инструкции. В поле Внешний репозиторий (Remote) выберите внешний репозиторийaa-validated
.Совет
Изменять настройки репозитория
aa-certified
не нужно – он по умолчанию настроен на получение содержимого из внешнего репозиторияaa-certified
.Запустите синхронизацию обоих репозиториев Private Automation Hub с репозиториями Automation Hub согласно инструкции.