Files

T

Sergey Antropoff 48df10b17e 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)

2026-07-18 04:18:05 +03:00

1.9 KiB

Raw Blame History

Language / Язык: English | Русский

Обзор примеров клиентов

Чеклист запуска

make up
curl -sf http://localhost:8006/health/ready
make seed PROFILE=small
curl -s http://localhost:8006/api2/json/version

Опционально — зафиксировать major 8 на время сессии:

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

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)

Заголовок токена

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.

1.9 KiB Raw Blame History