Ресурсы разработчика

Ресурсы разработчика#

Значимой частью Astra Automation является набор средств для разработки инфраструктурного кода, включая:

  • сценарии;

  • коллекции;

  • образы служебных контейнеров.

Состав#

Инструментальные средства для работы с Ansible делятся на два типа: основные и дополнительные. Основные инструменты распространяются через репозиторий Astra Automation в составе пакета astra-automation-cdk. Действия, необходимые для использования дополнительных инструментов могут различаться и описаны в справочнике каждого из инструментов.

Основные инструменты#

В состав Astra Automation входят следующие основные инструментальные средства для работы с Ansible:

  • Ansible Builder – создание образов среды исполнения.

  • Ansible Creator – создание коллекций и наборов сценариев.

  • Ansible Lint – статический анализ кода на наличие ошибок.

  • Ansible Molecule – тестирование ролей.

  • Ansible Navigator – создание, проверка и запуск контента, а также поиск и устранение проблем в его работе.

  • Ansible Pytest – тестирование рабочих окружений с помощью pytest до и после применения ролей.

  • Ansible Sign – контроль целостности содержимого Ansible с помощью GPG.

  • Tox Ansible – тестирование коллекций с различными версиями Python и Ansible.

  • Ansible Test – тестирование кода перед его передачей в проект Ansible.

Дополнительные инструменты#

В состав Astra Automation входят следующие дополнительные инструментальные средства для работы с Ansible:

Установка#

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

  1. Подключите репозиторий 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> необходимо подставить версию устанавливаемой платформы, например, 2.0.

      Доступные версии продукта опубликованы в таблице История обновлений.

    2. Обновите список доступных пакетов:

      sudo apt update

  2. Установите пакет astra-automation-cdk:

    sudo apt install astra-automation-cdk --yes

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

  1. Загрузите архив с установщиком на установочный узел.

    Примечание

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

  2. Создайте каталог /opt/rbta/aa/CDK-setup/:

    sudo mkdir -p /opt/rbta/aa/CDK-setup/

  3. Распакуйте содержимое архива с установщиком в каталог /opt/rbta/aa/CDK-setup/:

    sudo tar -xvzf <archive>.tar.gz -C /opt/rbta/aa/CDK-setup/

  4. Перейдите в каталог с распакованными файлами:

    cd /opt/rbta/aa/CDK-setup/

  5. Сделайте файл install_cdk_bundle.sh исполняемым:

    sudo chmod +x install_cdk_bundle.sh

  6. Для установки всех доступных утилит выполните команду:

    sudo ./install_cdk_bundle.sh

  7. Чтобы установить отдельную утилиту, выполните команду:

    sudo ./install_cdk_bundle.sh <utility_name>

    Здесь <utility_name> – название утилиты, которую необходимо установить. Поддерживаемые значения:

    • ansible-navigator;

    • ansible-builder;

    • ansible-lint;

    • molecule;

    • pytest-ansible.

    Примечание

    Утилита ansible-test входит в состав Ansible Core. При его наличии установка дополнительных пакетов не требуется.

  8. Проведите дополнительные настройки Podman согласно инструкции.

  9. Если у вас установлен Podman версии 4.3.1, добавьте aa-creator-ee в список локальных образов:

    sudo podman load -i /opt/rbta/aa/CDK-setup/aa-creator-ee/aa-creator-ee.tar

    Здесь /opt/rbta/aa/CDK-setup/aa-creator-ee/aa-creator-ee.tar – путь к архиву с образом aa-creator-ee.