Prepare 0.1.0 for lab release: durable handlers, HTTP Compose, CI, and pulumi-tests.
- Harden DB-backed handlers and seed profiles; align client wire shapes for cluster resources, QEMU config, and node SSL fields - Serve plain HTTP on Compose :8006; keep TLS optional (--profile tls) and terminate HTTPS at Kubernetes Ingress - Add pulumi-tests (full contract surface majors 6–9 + BPG lifecycle) and make pulumi-tests - Ship bilingual docs, CHANGELOG, SECURITY, CONTRIBUTING, and GitHub Actions (make ci + Compose/Helm validation)
This commit is contained in:
@@ -0,0 +1,58 @@
|
||||
**Language / Язык:** [English](../../examples/overview.md) | [Русский](overview.md)
|
||||
|
||||
# Обзор примеров клиентов
|
||||
|
||||
## Чеклист запуска
|
||||
|
||||
```bash
|
||||
make up
|
||||
curl -sf http://localhost:8006/health/ready
|
||||
make seed PROFILE=small
|
||||
curl -s http://localhost:8006/api2/json/version
|
||||
```
|
||||
|
||||
Опционально — зафиксировать major 8 на время сессии:
|
||||
|
||||
```bash
|
||||
curl -s -X POST 'http://localhost:8006/ui/api/contract/apply?major=8'
|
||||
```
|
||||
|
||||
## Эндпоинты
|
||||
|
||||
| URL | Когда использовать |
|
||||
|---|---|
|
||||
| `http://localhost:8006` | curl, Go, Java, Perl, Ansible, requests |
|
||||
| `http://localhost:8006` | proxmoxer, многие TLS-клиенты Terraform/Pulumi |
|
||||
|
||||
## Краткая справка по аутентификации
|
||||
|
||||
**Ticket**
|
||||
|
||||
```bash
|
||||
RESP=$(curl -s -X POST -d 'username=root@pam&password=secret' \
|
||||
http://localhost:8006/api2/json/access/ticket)
|
||||
TICKET=$(echo "$RESP" | jq -r .data.ticket)
|
||||
CSRF=$(echo "$RESP" | jq -r .data.CSRFPreventionToken)
|
||||
```
|
||||
|
||||
**Заголовок токена**
|
||||
|
||||
```text
|
||||
Authorization: PVEAPIToken=root@pam!automation=automation-secret
|
||||
```
|
||||
|
||||
## Ожидание UPID
|
||||
|
||||
Никогда не считайте, что ВМ уже запущена, только по HTTP-ответу мутации. Опрашивайте
|
||||
`/nodes/{node}/tasks/{upid}/status`, пока `data.status` не станет терминальным (обычно
|
||||
`stopped` с кодом выхода OK для завершённых задач — используйте поля Proxmox, которые
|
||||
ваш клиент уже понимает).
|
||||
|
||||
## Предупреждение о повторном seed
|
||||
|
||||
`make seed` заменяет гостей в PostgreSQL. После этого обновите состояние
|
||||
Terraform/Pulumi/Ansible.
|
||||
|
||||
## Запускаемое дерево примеров
|
||||
|
||||
См. [`examples/README.ru.md`](../../../examples/README.ru.md).
|
||||
Reference in New Issue
Block a user