Добавлен файл

2026-08-01 13:03:45 +03:00
parent 7957c8abc9
commit cd9109f0a1
1 changed files with 127 additions and 0 deletions
@@ -0,0 +1,127 @@
+# Proxmox Tools (Kybinka)
+
+## Описание
+Инструменты для управления Proxmox VE на сервере Kybinka (192.168.31.2:8006).
+
+## Настройки по умолчанию
+- **Proxmox host:** `https://192.168.31.2:8006`
+- **Пользователь API:** `root@pam`
+- **Нода по умолчанию:** `pve`
+- **Хранилище по умолчанию:** `local`
+- **Мост по умолчанию:** `vmbr0`
+- **VMID шаблона:** 1000
+- **Таймаут запросов:** 30 секунд
+
+## Доступные функции
+
+### connection()
+Проверка подключения к API Proxmox VE.
+
+**Возвращает:** `OK Proxmox VE X.Y.Z | node: pve | host: https://192.168.31.2:8006` или `ERR <описание ошибки>`
+
+### nodes()
+Список всех нод кластера с загрузкой CPU/RAM и аптаймом.
+
+**Возвращает:** список нод со статусом, CPU, RAM, аптаймом.
+
+### node_status(node=None)
+Подробный статус ноды: модель CPU, нагрузка, RAM, swap, диск, аптайм, ядро и версия PVE.
+
+**Аргументы:**
+- `node` — имя ноды (по умолчанию: `pve`)
+
+### cluster()
+Статус кластера: кворум и участники.
+
+### resources(ftype="")
+Список всех ресурсов кластера (ноды, QEMU VM, LXC, хранилища).
+
+**Аргументы:**
+- `ftype` — фильтр по типу: `"node"`, `"qemu"`, `"lxc"`, `"storage"` (пусто = все)
+
+### storage()
+Список всех настроенных хранилищ с типами контента и занятостью.
+
+### tasks(limit=10, node=None)
+Последние задачи на ноде.
+
+**Аргументы:**
+- `limit` — максимальное количество задач
+- `node` — имя ноды (по умолчанию: `pve`)
+
+### lxc_list(node=None)
+Список LXC-контейнеров на ноде.
+
+### lxc_detail(vmid, node=None)
+Подробная информация о LXC-контейнере: ОС, CPU, RAM, диск, сеть, использование и аптайм.
+
+**Аргументы:**
+- `vmid` — числовой ID контейнера
+- `node` — имя ноды (по умолчанию: `pve`)
+
+### lxc_action(vmid, action, node=None)
+Управление жизненным циклом LXC.
+
+**Аргументы:**
+- `vmid` — ID контейнера
+- `action` — одно из: `"start"`, `"stop"`, `"shutdown"`, `"restart"`, `"suspend"`, `"resume"`, `"delete"`
+- `node` — имя ноды (по умолчанию: `pve`)
+
+### templates(storage=None, node=None)
+Список доступных шаблонов LXC в хранилище.
+
+**Аргументы:**
+- `storage` — имя хранилища (по умолчанию: `local`)
+- `node` — имя ноды (по умолчанию: `pve`)
+
+### lxc_create(...)
+Создание нового LXC-контейнера из шаблона.
+
+**Основные аргументы:**
+- `vmid` — новый ID (не должен существовать)
+- `hostname` — имя хоста
+- `ostemplate` — ID шаблона, например `"local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst"`
+- `password` — пароль root (обязателен если нет sshkey)
+- `sshkey` — публичный SSH-ключ (обязателен если нет password)
+- `cores` — количество ядер (по умолчанию: 1)
+- `memory` — RAM в МБ (по умолчанию: 512)
+- `disk` — размер диска, например `"8G"` (по умолчанию: `"8G"`)
+- `ip` — IP-адрес или `"dhcp"` (по умолчанию: `"dhcp"`)
+- `netmask` — префикс маски (по умолчанию: 24)
+- `gw` — шлюз
+- `start_now` — запустить сразу (по умолчанию: `true`)
+
+### vm_list(node=None)
+Список QEMU VM на ноде.
+
+### vm_detail(vmid, node=None)
+Подробный статус VM.
+
+### vm_action(vmid, action, node=None)
+Управление жизненным циклом VM.
+
+### vm_create_from_template(...)
+Создание VM клонированием из шаблона (cloud-init).
+
+**Основные аргументы:**
+- `vmid` — новый ID
+- `name` — имя VM
+- `template_vmid` — VMID шаблона (по умолчанию: 1000)
+- `full` — полный клон (`true`) или связанный (`false`)
+- `memory` — RAM в МБ
+- `cores` — ядра CPU
+- `ciuser` — пользователь cloud-init
+- `cipassword` — пароль cloud-init
+- `sshkeys` — SSH-ключи (через новую строку)
+
+### vm_create(...)
+Создание VM (два режима: клон из шаблона или создание с ISO).
+
+**Режим 1 (клонирование):**
+- `template_vmid` — VMID шаблона (по умолчанию: 1000)
+
+**Режим 2 (ISO):**
+- `template_vmid=0`
+- `iso` — ID ISO, например `"local:iso/debian-12.iso"`
+- `ostype` — тип ОС, например `"l26"`
+- `agent` — включить QEMU guest agent (1/0)