128 lines
5.1 KiB
Markdown
128 lines
5.1 KiB
Markdown
# 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)
|