Sergey Antropoff
48df10b17e
- 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)
2.3 KiB
2.3 KiB
Language / Язык: English | Русский
Clients
Use the simulator from common automation stacks. Each cookbook aims for the same laboratory flow where the tool allows it:
- Authenticate (ticket + CSRF or API token)
- Read
version/ nodes / QEMU list - Create a VM (accept UPID)
- Poll task status
- Start / stop
- Read status back
- Delete / cleanup
Connection matrix
Real Proxmox VE clients talk to HTTPS :8006. This lab’s Compose stack
publishes plain HTTP :8006 (same port number). HTTPS belongs on
Kubernetes Ingress (cert-manager). Clients that cannot speak HTTP
(proxmoxer) use the optional profile: docker compose --profile tls →
https://localhost:8443/ (see Ports and TLS).
| Stack | Compose transport | Notes | Docs | Code |
|---|---|---|---|---|
| Python (proxmoxer) | HTTPS :8443 (--profile tls) |
HTTPS-only library; verify_ssl=False for lab cert |
guide | examples/python |
| Python (requests) | HTTP :8006 |
Raw /api2/json |
guide | examples/python |
| Go | HTTP :8006 |
stdlib net/http |
guide | examples/go |
| Java | HTTP :8006 |
Java 11+ HttpClient |
guide | examples/java |
| Perl | HTTP :8006 |
HTTP::Tiny + JSON |
guide | examples/perl |
| Ansible | HTTP :8006 |
uri module cookbook |
guide | examples/ansible |
| Terraform | HTTP :8006 (or TLS :8443) |
Prefer HTTP; use insecure only with --profile tls |
guide | examples/terraform |
| Pulumi | HTTP :8006 |
pulumi-proxmoxve or HTTP cookbooks |
guide | examples/pulumi |
On Kubernetes with Ingress + cert-manager, point every client at
https://<your-host>/ instead.
More
- Cookbooks index: examples/overview.md
- Troubleshooting: examples/troubleshooting-clients.md
- Pulumi full suite:
pulumi-tests/