Compare commits
No commits in common. "a4ff970a9ca281d115b1318e7f609ba1e7b8d52a" and "2d2e260d57fd66d157bb37598c6a74661b56ffae" have entirely different histories.
a4ff970a9c
...
2d2e260d57
|
|
@ -20,7 +20,7 @@ vm_id=200
|
||||||
vm_name="ubuntu-2004-cloudinit-template"
|
vm_name="ubuntu-2004-cloudinit-template"
|
||||||
vm_memory=2048
|
vm_memory=2048
|
||||||
vm_cores=2
|
vm_cores=2
|
||||||
vm_user="cooluser"
|
vm_user="da2001"
|
||||||
|
|
||||||
# данные proxmox
|
# данные proxmox
|
||||||
px_storage=local-lvm
|
px_storage=local-lvm
|
||||||
|
|
|
||||||
174
readme.md
174
readme.md
|
|
@ -1,28 +1,35 @@
|
||||||
# Автоматизация процесса создания ВМ в Proxmox с использованием Ansible
|
# Автоматизация процесса создания ВМ в Proxmox с использованием Ansible
|
||||||
|
|
||||||
## Содержание
|
## Содержание
|
||||||
|
- [Требования](#требования)
|
||||||
- [Требования](#требования)
|
- [Создание шаблона](#создание-шаблона)
|
||||||
- [Создание шаблона](#создание-шаблона)
|
- [Создание ВМ с помощью Ansible](#создание-вм-с-помощью-ansible)
|
||||||
- [Создание ВМ с помощью Ansible](#создание-вм-с-помощью-ansible)
|
- [Необходимые файлы](#необходимые-файлы)
|
||||||
- [Необходимые файлы](#необходимые-файлы)
|
- [О версиях Ansible](#О-версиях-ansible)
|
||||||
- [Описание переменных](#описание-переменных)
|
- [Структура данных](#Структура-данных)
|
||||||
- [Задачи плейбука](#задачи-плейбука)
|
- [Списки](#Списки)
|
||||||
- [Подключение к ВМ](#подключение-к-вм)
|
- [Словари (Хеш таблицы)](#Словари-Хеш-таблицы)
|
||||||
|
- [Списки словарей](#Списки-словарей)
|
||||||
|
- [Словари словарей](#Словари-словарей)
|
||||||
|
- [Циклы](#Циклы)
|
||||||
|
- [with_items](#with_items)
|
||||||
|
- [С простыми списками](#С-простыми-списками)
|
||||||
|
- [with_dict](#with_dict)
|
||||||
|
- [Полезные ссылки](#Полезные-ссылки)
|
||||||
|
- [Благодарности](#Благодарности)
|
||||||
|
|
||||||
## Требования
|
## Требования
|
||||||
|
Для работы Ansible с гипервизором Proxmox, написан соответсвующий модуль [proxmox_kvm](https://docs.ansible.com/ansible/latest/collections/community/general/proxmox_kvm_module.html).
|
||||||
Для работы Ansible с гипервизором Proxmox, написан соответствующий модуль [proxmox_kvm](https://docs.ansible.com/ansible/latest/collections/community/general/proxmox_kvm_module.html).
|
|
||||||
В свою очередь, для работы модуля `proxmox_kvm` на хосте Proxmox, необходимо установить пакеты `requests` и `proxmoxer`.
|
В свою очередь, для работы модуля `proxmox_kvm` на хосте Proxmox, необходимо установить пакеты `requests` и `proxmoxer`.
|
||||||
Т.к. Ansible написан на Python, необходимые ему пакеты можно установить с помощью PIP.
|
Т.к. Ansible написан на Python, необходимые ему пакеты можно установить с помощью PIP.
|
||||||
Для установки PIP для Python 2 - `sudo apt install python-pip`
|
Для установки PIP для Python 2 - `sudo apt install python-pip`
|
||||||
Для установки PIP для Python 3 (предпочтительнее) - `sudo apt install python3-pip`
|
Для установки PIP для Python 3 (предпочтительнее) - `sudo apt install python3-pip`
|
||||||
|
|
||||||
Далее установим необходимые пакеты:
|
Далее установим необходимые пакеты:
|
||||||
_в зависимости от способа установки Python и PIP, команда для установки пакетов может отличаться. В общем случае, команда выглядит так:_
|
*в зависимости от способа установки Python и PIP, команда для установки пакетов может отличаться. В общем случае, команда выглядит так:*
|
||||||
|
```
|
||||||
pip install requests
|
pip install requests
|
||||||
pip install proxmoxer
|
pip install proxmoxer
|
||||||
|
```
|
||||||
|
|
||||||
[⬆ Наверх](#содержание)
|
[⬆ Наверх](#содержание)
|
||||||
|
|
||||||
|
|
@ -34,30 +41,32 @@ _в зависимости от способа установки Python и PIP,
|
||||||
Скрипт `create_template.sh` необходимо скопировать на хост Proxmox, добавить права на исполнение.
|
Скрипт `create_template.sh` необходимо скопировать на хост Proxmox, добавить права на исполнение.
|
||||||
|
|
||||||
Стоит обратить внимание на объявленные в скрипте переменные:
|
Стоит обратить внимание на объявленные в скрипте переменные:
|
||||||
_скачиваемый образ и его URL_
|
*скачиваемый образ и его URL*
|
||||||
|
```
|
||||||
|
cloudimg=focal-server-cloudimg-amd64.img # имя скачиваемого образа
|
||||||
|
img_url=https://cloud-images.ubuntu.com/focal/current # адрес, по которому доступен образ
|
||||||
|
```
|
||||||
|
|
||||||
cloudimg=focal-server-cloudimg-amd64.img # имя скачиваемого образа
|
*параметры создаваемого шаблона*
|
||||||
img_url=https://cloud-images.ubuntu.com/focal/current # адрес, по которому доступен образ
|
```
|
||||||
|
vm_id=200 # идентификатор создаваемого шаблона
|
||||||
|
vm_name="ubuntu-2004-cloudinit-template" # имя создаваемого шаблона
|
||||||
|
vm_memory=2048 # объем оперативной памяти выделяемый шаблону
|
||||||
|
vm_cores=2 # количество ядер процессора доступных шаблону
|
||||||
|
vm_user="da2001" # имя пользвателя, который будет создан в шаблоне
|
||||||
|
```
|
||||||
|
|
||||||
_параметры создаваемого шаблона_
|
*переменные, относящиеся к гипервизору Proxmox*
|
||||||
|
```
|
||||||
vm_id=200 # идентификатор создаваемого шаблона
|
px_storage=local-lvm # хранилище, в котором будет размещен диск шаблона
|
||||||
vm_name="ubuntu-2004-cloudinit-template" # имя создаваемого шаблона
|
px_bridge=vmbr1 # имя сетевого интерфейса к которому будет подключен шаблон
|
||||||
vm_memory=2048 # объем оперативной памяти выделяемый шаблону
|
```
|
||||||
vm_cores=2 # количество ядер процессора доступных шаблону
|
|
||||||
vm_user="da2001" # имя пользвателя, который будет создан в шаблоне
|
|
||||||
|
|
||||||
_переменные, относящиеся к гипервизору Proxmox_
|
|
||||||
|
|
||||||
px_storage=local-lvm # хранилище, в котором будет размещен диск шаблона
|
|
||||||
px_bridge=vmbr1 # имя сетевого интерфейса к которому будет подключен шаблон
|
|
||||||
|
|
||||||
**необходимо изменить значения переменных на свои**
|
**необходимо изменить значения переменных на свои**
|
||||||
|
|
||||||
Скрипт необходимо запустить от имени пользователя, который может создавать и редактировать ВМ (по-умолчанию это `root`). При запуске нужно придумать и указать в качестве аргумента пароль, который будет добавлен для авторизации пользователя, указанного в переменной `vm_user`
|
Скрипт необходимо запустить от имени пользователя, который может создавать и редактировать ВМ (по-умолчанию это `root`). При запуске нужно придумать и указать в качестве аргумента пароль, который будет добавлен для авторизации пользователя, указанного в переменной `vm_user`
|
||||||
|
|
||||||
Пример запуска скрипта
|
Пример запуска скрипта
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
root@pve:~# ./create_template.sh verySecPassword
|
root@pve:~# ./create_template.sh verySecPassword
|
||||||
```
|
```
|
||||||
|
|
@ -69,87 +78,56 @@ root@pve:~# ./create_template.sh verySecPassword
|
||||||
## Создание ВМ с помощью Ansible
|
## Создание ВМ с помощью Ansible
|
||||||
|
|
||||||
### Необходимые файлы
|
### Необходимые файлы
|
||||||
|
|
||||||
Для корректной работы плейбука необходимы следующие файлы:
|
Для корректной работы плейбука необходимы следующие файлы:
|
||||||
|
- `ansible.cfg` - файл общих настроек ansible
|
||||||
- `ansible.cfg` - файл общих настроек ansible
|
- `create_vm.yaml` - файл плейбука
|
||||||
- `create_vm.yaml` - файл плейбука
|
- `hosts.ini` - файл инвентаря, в котором указан, единственный в данном примере хост Proxmox
|
||||||
- `hosts.ini` - файл инвентаря, в котором указан, единственный в данном примере хост Proxmox
|
- `vars.yaml` - используемые переменные
|
||||||
- `vars.yaml` - используемые переменные
|
- `vms.yaml` - переменные с описанием создаваемых ВМ
|
||||||
- `vms.yaml` - переменные с описанием создаваемых ВМ
|
|
||||||
|
|
||||||
[⬆ Наверх](#содержание)
|
[⬆ Наверх](#содержание)
|
||||||
|
|
||||||
### Описание переменных
|
### Описание переменных
|
||||||
|
|
||||||
Используемые в плейбуке переменные разделены на два файла: `vars.yaml`, `vms.yaml`. Это разделение сделано для удобства, чтобы отделить переменные виртуальных машин.
|
Используемые в плейбуке переменные разделены на два файла: `vars.yaml`, `vms.yaml`. Это разделение сделано для удобства, чтобы отделить переменные виртуальных машин.
|
||||||
`vars.yaml`
|
`vars.yaml`
|
||||||
|
```
|
||||||
pve_storage: local-lvm # название хранилища на котором будут созданы ВМ
|
pve_storage: local-lvm # название хранилища на котором будут созданы ВМ
|
||||||
api_host: 192.168.13.9 # IP адрес хоста Proxmox
|
api_host: 192.168.13.9 # IP адрес хоста Proxmox
|
||||||
api_user: root@pam # данные для авторизации по API
|
api_user: root@pam # данные для авторизации по API
|
||||||
api_password: securePassword # пароль для авторизации
|
api_password: securePassword # пароль для авторизации
|
||||||
node: pve # имя ноды Proxmox
|
node: pve # имя ноды Proxmox
|
||||||
clone_vm: ubuntu-2004-cloudinit-template # имя шаблона из которого создаются ВМ
|
clone_vm: ubuntu-2004-cloudinit-template # имя шаблона из которого создаются ВМ
|
||||||
key_name: id_rsa.pub # имя SSH ключа, который будет скопирован в ВМ для дальнейшего доступа к ним
|
key_name: id_rsa.pub # имя SSH ключа, который будет скопирован в ВМ для дальнейшего доступа к ним
|
||||||
|
```
|
||||||
|
|
||||||
`vms.yaml`
|
`vms.yaml`
|
||||||
|
```
|
||||||
|
vms:
|
||||||
|
us1:
|
||||||
|
name: us10.da2001.ru # имя создаваемой ВМ
|
||||||
|
ip: 192.168.10.21/24 # IP адрес ВМ
|
||||||
|
gw: 192.168.10.9 # IP адрес шлюза по-умолчанию, который будет прописан в ВМ (адрес гипервизора)
|
||||||
|
dns: 8.8.8.8 # IP адрес DNS сервера
|
||||||
|
vmid: 201 # идентификатор создаваемой ВМ
|
||||||
|
cores: 2 # количество доступных процессоров для ВМ, если отличается от указанных в шаблоне
|
||||||
|
sockets: 1 # количество доступных сокетов для ВМ, если отличается от указанных в шаблоне
|
||||||
|
memory: 2048 # количество доступной оперативной памяти для ВМ, если отличается от указанного значения в шаблоне
|
||||||
|
us2:
|
||||||
|
name: us11.da2001.ru
|
||||||
|
ip: 192.168.10.22/24
|
||||||
|
gw: 192.168.10.9
|
||||||
|
dns: 8.8.8.8
|
||||||
|
vmid: 202
|
||||||
|
cores: 2
|
||||||
|
sockets: 1
|
||||||
|
memory: 2048
|
||||||
|
```
|
||||||
|
|
||||||
vms:
|
**перед запуском плейбука необходимо убедиться, что установлены корректные значения**
|
||||||
us1:
|
|
||||||
name: us10.da2001.ru # имя создаваемой ВМ
|
|
||||||
ip: 192.168.10.21/24 # IP адрес ВМ
|
|
||||||
gw: 192.168.10.9 # IP адрес шлюза по-умолчанию, который будет прописан в ВМ (адрес гипервизора)
|
|
||||||
dns: 8.8.8.8 # IP адрес DNS сервера
|
|
||||||
vmid: 201 # идентификатор создаваемой ВМ
|
|
||||||
cores: 2 # количество доступных процессоров для ВМ, если отличается от указанных в шаблоне
|
|
||||||
sockets: 1 # количество доступных сокетов для ВМ, если отличается от указанных в шаблоне
|
|
||||||
memory: 2048 # количество доступной оперативной памяти для ВМ, если отличается от указанного значения в шаблоне
|
|
||||||
us2:
|
|
||||||
name: us11.da2001.ru
|
|
||||||
ip: 192.168.10.22/24
|
|
||||||
gw: 192.168.10.9
|
|
||||||
dns: 8.8.8.8
|
|
||||||
vmid: 202
|
|
||||||
cores: 2
|
|
||||||
sockets: 1
|
|
||||||
memory: 2048
|
|
||||||
|
|
||||||
**перед запуском плейбука необходимо убедиться, что установлены корректные значения переменных**
|
|
||||||
|
|
||||||
[⬆ Наверх](#содержание)
|
[⬆ Наверх](#содержание)
|
||||||
|
|
||||||
### Задачи плейбука
|
### Задачи плейбука
|
||||||
|
|
||||||
- Клонирование ВМ из шаблона
|
|
||||||
_за основу были взяты примеры из документации <https://docs.ansible.com/ansible/latest/collections/community/general/proxmox_kvm_module.html#examples>_</br>
|
|
||||||
В задаче создаются виртуальные машины на основе шаблона
|
|
||||||
|
|
||||||
Конструкция
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
loop: "{{ lookup('dict', vms) }}"
|
|
||||||
```
|
|
||||||
|
|
||||||
позволяет перебрать все необходимые ключи и значения из словаря `vms`
|
|
||||||
|
|
||||||
- Настройка IP адресов
|
|
||||||
В этой задаче назначается IP адрес для каждой созданной ВМ и IP адрес шлюза по-умолчанию
|
|
||||||
|
|
||||||
- Настройка DNS
|
|
||||||
Как видно из названия, в ВМ указывается IP адрес DNS сервера
|
|
||||||
|
|
||||||
- Копирование SSH ключей в ВМ
|
|
||||||
Для беспарольного доступа в ВМ будет скопирован указанный SSH ключ хоста, на котором выполняется плейбук
|
|
||||||
|
|
||||||
- Обновление параметров ВМ
|
|
||||||
При клонировании из шаблона, ВМ создаются с теми же параметрами, что и сам шаблон. Выполнение этой задачи позволяет изменить параметры ВМ, например размер оперативной памяти, количество доступных процессоров и т.д.
|
|
||||||
|
|
||||||
- Запуск ВМ
|
|
||||||
Финальным этапом будет запуск созданных ВМ
|
|
||||||
|
|
||||||
## Подключение к ВМ
|
|
||||||
|
|
||||||
Для доступа к ВМ по SSH необходимо использовать имя пользователя, которое определено в переменной `vm_user` в скрипте `create_template.sh`. При подключении с хоста, на котором запускался плейбук пароль вводить не нужно, т.к. в ВМ скопирован SSH ключ. При подключении из других систем, необходимо указать пароль, который был задан в виде аргумента при запуске скрипта `create_template.sh`.
|
|
||||||
|
|
||||||
[⬆ Наверх](#содержание)
|
[⬆ Наверх](#содержание)
|
||||||
|
|
|
||||||
4
vms.yaml
4
vms.yaml
|
|
@ -1,6 +1,6 @@
|
||||||
vms:
|
vms:
|
||||||
us1:
|
us1:
|
||||||
name: us10.example.com
|
name: us10.da2001.ru
|
||||||
ip: 192.168.10.21/24
|
ip: 192.168.10.21/24
|
||||||
gw: 192.168.10.9
|
gw: 192.168.10.9
|
||||||
dns: 8.8.8.8
|
dns: 8.8.8.8
|
||||||
|
|
@ -9,7 +9,7 @@ vms:
|
||||||
sockets: 1
|
sockets: 1
|
||||||
memory: 2048
|
memory: 2048
|
||||||
us2:
|
us2:
|
||||||
name: us11.example.com
|
name: us11.da2001.ru
|
||||||
ip: 192.168.10.22/24
|
ip: 192.168.10.22/24
|
||||||
gw: 192.168.10.9
|
gw: 192.168.10.9
|
||||||
dns: 8.8.8.8
|
dns: 8.8.8.8
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue