diff --git a/knowledge-base/tools/proxmox-tools-kybinka.md b/knowledge-base/tools/proxmox-tools-kybinka.md new file mode 100644 index 0000000..5033d11 --- /dev/null +++ b/knowledge-base/tools/proxmox-tools-kybinka.md @@ -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)