|
|
# Модули Ansible для управления облачными ресурсами в платформе DECORT
|
|
|
## Введение
|
|
|
|
|
|
Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology).
|
|
|
|
|
|
У каждого модуля есть свой раздел, в котором Вы можете найти подробную информацию о параметрах, которые использует и возращает данный модуль, а также примеры использования данного модуля.
|
|
|
|
|
|
В состав библиотеки модулей DECORT для Ansible на текущий момент входят:
|
|
|
|
|
|
- decort_kvmvm - модуль для управления жизненным циклом виртуальных серверов (экземпляров compute). Платформа DECORT поддерживает виртуальные серверы на базе технологии KVM и аппаратных архитектур Intel x86 и IBM PowerPC.
|
|
|
Позволяет:
|
|
|
1. Создавать новые виртуальные сервера указанной аппаратной архитектуры. Платформа поддерживает виртуальные сервера архитектуры Intel x86 и IBM PowerPC.
|
|
|
2. Изменять конфигурацию существующего виртуального сервера:
|
|
|
- Изменять количества выделенных CPU и виртуальной ОЗУ. Следует иметь ввиду, что изменение этих параметров в меньшую сторону может потребовать перезагрузки гостевой ОС.
|
|
|
- Увеличивать размера загрузочного диска
|
|
|
- Подключать / отключать дополнительные дисковые ресурсы.
|
|
|
- Создавать / удалять сетевые подключения.
|
|
|
3. Изменять состояние существующего виртуального сервера:
|
|
|
- Выключать / включать.
|
|
|
- Перезагружать, приостанаваливать / возобновлять работу гостевой ОС.
|
|
|
4. Удалять существующий виртуальный сервер.
|
|
|
5. Получать информацию о существующем виртуальном сервере без изменения его конфигурации.
|
|
|
- decort_disk - модуль для управления жизненным циклом дисковых ресурсов, которые можно подключать к экземплярам compute.
|
|
|
Позволяет:
|
|
|
1) создавать / удалять диск;
|
|
|
2) изменять размер диска.
|
|
|
- decort_rg - модуль для управления жизненным циклом ресурсных групп (Resource Groups, RG).
|
|
|
Позволяет:
|
|
|
1) Создавать\удалять ресурсные группы.
|
|
|
2) Запрашивать информацию об уже существующих ресурсных группах.
|
|
|
3) Редактировать ресурсные группы.
|
|
|
4) Настраивать квоты в ресурсных группах.
|
|
|
5) Восстанавливать ресурсные группы.
|
|
|
- decort_vins - модуль для управления жизненным циклом виртуальных сетевых сегментов (Virtual Network Segment, ViNS). Экземпляры compute (напр., виртуальные серверы) могут быть подключены к нескольким виртуальным сетевым сегментам.
|
|
|
Позволяет:
|
|
|
1) Создавать, удалять виртуальные сетевые сегменты.
|
|
|
2) Изменять виртуальные сетевые сегменты.
|
|
|
3) Запрашивать информацию о виртуальных сетевых сегментах.
|
|
|
4) Восстанавливать удалённые виртуальные сетевые сегменты.
|
|
|
|
|
|
- decort_pfw - модуль для настройки правил трансляции сетевых портов виртуальных серверов.
|
|
|
- decort_osimage - модуль для взаимодействия с образами.
|
|
|
Позволяет:
|
|
|
1) Создавать новый образ операционной системы для виртуальных машин.
|
|
|
2) Создавать виртуальный образ для образа операционной системы.
|
|
|
3) Изменять имя образа (в случае изменения имени виртуального образа, имя и id виртуального образа указываются как image_name и image_id).
|
|
|
4) Привязывать другой образ операционной системы к виртуальному образу.
|
|
|
5) Удалять существующий образ, привязанный к аккаунту.
|
|
|
6) Получать информацию об образе.
|
|
|
- decort_jwt - модуль для получения авторизационного токена (JWT - JSON Web Token), который можно использовать при массовом создании экземпляров compute для ускорения работы playbook-а. Подробности см. в соответствующем разделе.
|
|
|
- decort_bservice - модуль для взаимодействия с Basic сервисами (Basic service).
|
|
|
Позволяет:
|
|
|
1) Создавать Basic Service.
|
|
|
2) Удалять Basic Service.
|
|
|
3) Включать/выключать Basic Service.
|
|
|
4) Запрашивать информацию о Basic Service.
|
|
|
- decort_group - модуль для взаимодействия с группами виртуальных серверов(compute).
|
|
|
Позволяет:
|
|
|
1) Получить информацию о группе виртуальных серверов.
|
|
|
2) Запустить/остановить группу виртуальных серверов.
|
|
|
3) Изменить параметры группы виртуальных серверов (cpu, ram, disk, и т.д).
|
|
|
4) Изменить количество виртуальных серверов в группе.
|
|
|
5) Изменить параметры сети (ext_net, VINS).
|
|
|
6) Создать группу виртуальных серверов и подключить её к Basic сервису.
|
|
|
7) Удалить группу виртуальных серверов.
|
|
|
- decort_k8s - модуль для взаимодействия с кластерами Kubernetes.
|
|
|
Позволяет:
|
|
|
1) Создавать/удалять кластера Kubernetes.
|
|
|
2) Enable/Disable кластера Kubernetes.
|
|
|
3) Запускать/Останавливать кластера Kubernetes
|
|
|
4) Модифицировать кластера Kubernetes
|
|
|
5) Получать информацию об уже существующем кластере Kubernetes.
|
|
|
|
|
|
## Системные требования
|
|
|
Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT.
|
|
|
Системные требования для работы модуля:
|
|
|
- Ansible 2.7 or higher
|
|
|
- Python 3.7 or higher
|
|
|
- PyJWT 2.0.0 Python module or higher
|
|
|
- requests Python module
|
|
|
- netaddr Python module
|
|
|
- DECORT cloud platform version 3.5.0 or higher
|
|
|
|
|
|
## Подготовка к работе
|
|
|
|
|
|
Для начала работы необходимо разместить директории library и module_utils в Вашей рабочей директории, откуда будут запускаться плейбуки, либо указать в ansible.cfg путь до них.
|
|
|
|
|
|
|
|
|
|
|
|
|
