# Proxmox Tools (PVE1)

## Описание
Инструменты для управления Proxmox VE на сервере PVE1 (192.168.31.4:8006).

## Настройки по умолчанию
- **Proxmox host:** `https://192.168.31.4:8006`
- **Пользователь API:** `root@pam`
- **Нода по умолчанию:** `pve1`
- **Хранилище по умолчанию:** `local`
- **Мост по умолчанию:** `vmbr0`
- **Таймаут запросов:** 30 секунд

## Доступные функции

### pve1_connection()
Проверка подключения к API Proxmox VE (PVE1).

**Возвращает:** `OK Proxmox VE X.Y.Z | node: pve1 | host: https://192.168.31.4:8006`

### pve1_nodes()
Список всех нод кластера с загрузкой CPU/RAM и аптаймом.

### pve1_node_status(node=None)
Подробный статус ноды: модель CPU, нагрузка, RAM, swap, диск, аптайм, ядро и версия PVE.

**Аргументы:**
- `node` — имя ноды (по умолчанию: `pve1`)

### pve1_cluster()
Статус кластера: кворум и участники.

### pve1_resources(ftype="")
Список всех ресурсов кластера (ноды, QEMU VM, LXC, хранилища).

**Аргументы:**
- `ftype` — фильтр: `"node"`, `"qemu"`, `"lxc"`, `"storage"` (пусто = все)

### pve1_storage()
Список всех настроенных хранилищ с типами контента и занятостью.

### pve1_tasks(limit=10, node=None)
Последние задачи на ноде.

**Аргументы:**
- `limit` — максимальное количество задач
- `node` — имя ноды (по умолчанию: `pve1`)

### pve1_lxc_list(node=None)
Список LXC-контейнеров на ноде.

### pve1_lxc_detail(vmid, node=None)
Подробная информация о LXC-контейнере: ОС, CPU, RAM, диск, сеть, использование и аптайм.

### pve1_lxc_action(vmid, action, node=None)
Управление жизненным циклом LXC.

**Аргументы:**
- `vmid` — ID контейнера
- `action` — одно из: `"start"`, `"stop"`, `"shutdown"`, `"restart"`, `"suspend"`, `"resume"`, `"delete"`

### pve1_templates(storage=None, node=None)
Список доступных шаблонов LXC в хранилище.

**Аргументы:**
- `storage` — имя хранилища (по умолчанию: `local`)
- `node` — имя ноды (по умолчанию: `pve1`)

### pve1_lxc_create(...)
Создание нового LXC-контейнера из шаблона.

**Основные аргументы:**
- `vmid` — новый ID (не должен существовать)
- `hostname` — имя хоста
- `ostemplate` — ID шаблона
- `password` / `sshkey` — аутентификация
- `cores` — ядра CPU (по умолчанию: 1)
- `memory` — RAM в МБ (по умолчанию: 512)
- `disk` — размер диска (по умолчанию: `"8G"`)
- `ip` — IP или `"dhcp"` (по умолчанию: `"dhcp"`)
- `netmask` — префикс маски (по умолчанию: 24)
- `start_now` — запустить сразу (по умолчанию: `true`)

### pve1_vm_list(node=None)
Список QEMU VM на ноде.

### pve1_vm_detail(vmid, node=None)
Подробный статус VM.

### pve1_vm_action(vmid, action, node=None)
Управление жизненным циклом VM.

**Аргументы:**
- `vmid` — ID VM
- `action` — одно из: `"start"`, `"stop"`, `"shutdown"`, `"restart"`, `"suspend"`, `"resume"`, `"delete"`

### pve1_vm_create_from_template(...)
Создание VM клонированием из шаблона (cloud-init).

**Основные аргументы:**
- `vmid` — новый ID
- `name` — имя VM
- `template_vmid` — VMID шаблона (по умолчанию: 999)
- `full` — полный (`true`) или связанный (`false`) клон
- `memory` — RAM в МБ
- `cores` — ядра CPU
- `storage` — целевое хранилище
- `target_node` — целевая нода (если отличается)
- `start_now` — запустить сразу
- `ciuser` / `cipassword` / `sshkeys` — cloud-init параметры

### pve1_vm_create(...)
Создание VM (клонирование из шаблона или создание с ISO).

**Режим 1 (клонирование):**
- `template_vmid` — VMID шаблона (по умолчанию: 999)

**Режим 2 (ISO):**
- `template_vmid=0`
- `iso` — ID ISO
- `ostype` — тип гостевой ОС (по умолчанию: `"l26"`)
- `agent` — QEMU guest agent (1/0)