Files
gpu-rent/docs/spike-notes.md
T
Leonid Pershin f437cd0373 Update documentation and CLI behavior for GPU management
- Clarified the behavior of `Ctrl+C` and `Ctrl+D` in the README and other documentation, specifying that `Ctrl+C` only stops the tunnel while keeping the GPU active, and `Ctrl+D` stops the GPU while preserving disk data.
- Enhanced the CLI documentation to reflect these changes, ensuring users understand the implications of these commands during GPU operations.
- Improved the handling of data bindings and remounting logic in the codebase to prevent issues with empty model tabs in the UI.
- Added tests to validate the new command behaviors and ensure proper documentation alignment.
2026-08-21 13:25:55 +03:00

130 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Spike notes — первый живой прогон
Заполняй **руками** после зелёного `doctor`. Без секретов и без личных имён чекпоинтов.
Подготовка ключей: [setup.md](setup.md). Цель — один раз пройти панель + CLI на реальном GPU и зафиксировать факты (времена, цены, имя образа).
---
## 0. Перед прогоном
| Шаг | Дата | Результат |
| --- | --- | --- |
| Квота GPU в панели (лимит) | | 0 / N |
| Тикет в поддержку (номер), если был | | |
| Сервисный пользователь `member` + `.env` | | да / нет |
| `gpu-rent doctor` exit 0 | | |
Текст тикета: [setup.md §2.3](setup.md#23-тикет-в-поддержку).
---
## 1. Preflight
```powershell
.\gpu-rent.ps1 doctor
.\gpu-rent.ps1 flavors
.\gpu-rent.ps1 dry-run
```
| Проверка | OK? | Заметка |
| --- | --- | --- |
| Keystone token | | |
| GPU quota > 0 | | |
| Flavor из `FLAVOR_PREFERENCE` | | id / имя |
| Image Driver 580 (без Docker) | | имя образа |
| Volume type в AZ | | |
| Civitai `.red` + token (если используешь) | | |
---
## 2. Первый `up`
```powershell
.\gpu-rent.ps1 up --yes
```
Первый bootstrap долгий (ориентир 20–40 мин). Не рви терминал посередине.
| Метрика | Значение |
| --- | --- |
| Flavor фактически | |
| Spot / preemptible | |
| ACTIVE через (мин) | |
| SSH через (мин) | |
| Backend Idle через (мин) | |
| Seed Civitai (мин / GB) | |
| Boot snapshot `gpu-rent-boot-ok` | да / нет / ошибка |
| ₽/час GPU (панель) | |
| ₽/мес data disk (панель) | |
| Access-card / URL :17801 | да / нет |
---
## 3. Туннель и API
Если закрыл туннель (**Ctrl+C**, GPU жив):
```powershell
.\gpu-rent.ps1 tunnel --open
```
**Ctrl+D** на живом туннеле = `stop` GPU.
| Шаг | OK? |
| --- | --- |
| UI http://127.0.0.1:17801 | |
| `/API/GetNewSession` | |
| MCP `/mcp` (если нужно) | |
| `nvidia-smi` через `gpu-rent ssh` | |
---
## 4. Idle-killer / hold
| Шаг | OK? | Заметка |
| --- | --- | --- |
| `systemctl status gpu-rent-idle-killer.timer` (по SSH) | | |
| `gpu-rent hold` пишет hold-until | | |
| Качалка модели в UI | | hold, если killer не видит busy |
---
## 5. Preempt / диски / stop
| Шаг | OK? |
| --- | --- |
| EXPIRED → `tunnel` unshelve или `up` | |
| `stop` — диски живы | |
| Второй `up` — те же модели на data | |
| Boot из snapshot `gpu-rent-boot-ok` | |
---
## 6. (Опц.) LLM
```powershell
.\gpu-rent.ps1 up --yes --ollama
# или интерактивно: up → меню runtime/пресет
```
| Шаг | OK? |
| --- | --- |
| Ollama :17811 через туннель | |
| pull / GGUF из манифеста | |
| `LLM_RUNTIME=none` гасит unit на следующем up | |
См. [llm.md](llm.md).
---
## Выводы для кода / конфига
- Имя GPU-образа в пуле:
- Реальные flavor id (не в git):
- Хватает ли `IDLE_GRACE_MINUTES=90`:
- Application credential с узкими access_rules: ок / ошибка (fail closed):
- Прочее:
Когда spike закрыт — отметь пункты в [roadmap.md](roadmap.md) §0.