9.0.0

5.2.6/введение.md

@@ -0,0 +1,90 @@
+# Модули 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 путь до них.
+
+
+
+