готово

readme.md

@@ -1,7 +1,10 @@
 # Автоматизация процесса создания ВМ в Proxmox с использованием Ansible
-## Этапы
+## Содержание
+- [Требования](#требования)
 - [Создание шаблона](#создание-шаблона)
-  - [О файлах примерах](#о-файлах-примерах)
+- [Создание ВМ с помощью Ansible](#создание-вм-с-помощью-ansible)
+  - [Необходимые файлы](#необходимые-файлы)
+ 
   - [О версиях Ansible](#О-версиях-ansible)
 - [Структура данных](#Структура-данных)
   - [Списки](#Списки)
@@ -15,6 +18,9 @@
 - [Полезные ссылки](#Полезные-ссылки)
 - [Благодарности](#Благодарности)
 
+## Требования
+Для работы Ansible с гипервизором Proxmox, написан соответсвующий модуль [proxmox_kvm][https://docs.ansible.com/ansible/latest/collections/community/general/proxmox_kvm_module.html]
+
 ## Создание шаблона
 
 ВМ создаются из существующего шаблона. При этом, необходимо, чтобы шаблон был с поддержкой cloudinit. Здесь возможны 2 варианта, создать такой шаблон самостоятельно или скачать готовый образ.
@@ -55,7 +61,18 @@ root@pve:~#  ./create_template.sh verySecPassword
 
 **Результатом работы скрипта будет созданный шаблон, из которого с помощью ansible-playbook будут созданы ВМ**
 
-[⬆ Наверх](#этапы)
+[⬆ Наверх](#содержание)
 
-### О файлах примерах
+## Создание ВМ с помощью Ansible
-Во многих разделах идёт ссылка на файл пример из директории [examples](examples/). Все файлы примеры написаны с использованием модуля ``debug`` и просто работают с параметрами или синтаксисом, показывая возможное применение и возможные ошибки. Запуск этих файлов-примеров не приводит к каким-либо изменениям на локальной или удалённой системе.
+
+### Необходимые файлы
+Для корректной работы плейбука необходимы следующие файлы:
+- ansible.cfg - файл общих настроек ansible
+- create_vm.yaml - файл плейбука
+- hosts.ini - файл инвентаря, в котором указан, единственный в данном примере хост Proxmox
+- vars.yaml - используемые переменные
+- vms.yaml - переменные с описанием создаваемых ВМ
+
+[⬆ Наверх](#содержание)
+
+### Описание задач плейбука