Ansible Creator#

Ansible Creator – это инструмент командной строки, упрощающий создание коллекций и наборов сценариев.

Установка#

Для установки Ansible Creator выполните следующие действия:

Подключите репозиторий Astra Automation.
Инструкция по подключению репозитория
1. В каталоге /etc/apt/sources.list.d/ создайте файл astra-automation.list со ссылкой на репозиторий Astra Automation:
  deb https://dl.astralinux.ru/aa/aa-debs-for-alse-1.8 <version> main
  Вместо <version> необходимо подставить версию устанавливаемой платформы, например, 1.2.
  
  Доступные версии продукта опубликованы в таблице История обновлений.
2. Обновите список доступных пакетов:
  sudo apt update
Установите пакет ansible-creator:
```
sudo apt install ansible-creator --yes
```

Установка при отсутствии доступа к интернету описана в документе Средства разработки.

Применение#

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

ansible-creator init collection <namespace>.<collection> <dir>

Здесь:

<namespace> – пространство имен;
<collection> – название коллекции;
<dir> – каталог, в котором следует разместить файлы и каталоги коллекции.

Если этот параметр не указан, файлы и каталоги будут размещены в текущем каталоге.

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

ansible-creator init playbook <namespace>.<collection> <dir>

Параметры этой команды аналогичны параметрам предыдущей, однако, создаваемая структура файлов и каталогов будет отличаться.

Примечание

Одним из требований утилиты Ansible Creator является распространение набора сценариев в составе коллекции. По этой причине в аргументах команды необходимо указать ее название.

Полный перечень возможных команд и опций см. в справочнике.

Примеры#

Изучите на примерах применение Ansible Creator для создания структуры файлов и каталогов ваших проектов Ansible.

Создание коллекции#

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

ansible-creator init collection astra.example ./astra-example

Эта команда создаст в текущем каталоге подкаталог astra-example/, а внутри него разместит файлы и каталоги, необходимые для начала работы над коллекцией astra.example.

Набор сценариев#

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

ansible-creator init playbook astra.playbooks ./astra-playbooks

Эта команда создаст в текущем каталоге подкаталог astra-playbooks/, а внутри него разместит файлы и каталоги, необходимые для начала работы над сценариями.