Providerhandleidingen
Proxmox VE: instellen en beheren
Lever Proxmox VE QEMU-VM’s door een template te klonen en de gekochte configuratie toe te passen.
Op deze pagina
Werkwijze bij de provider
Lever Proxmox VE QEMU-VM’s door een template te klonen en de gekochte configuratie toe te passen. De adapter controleert node- en opslagcapaciteit, bewaart een VM-koppeling en volgt externe taken bij levenscyclusacties. Dit is een VM-adapter, geen ondersteuningstoezegging voor ieder Proxmox-resourcetype.
Vereisten
Agovena Core ^0.0.1. Activeer Provisioning vóór deze uitbreiding.
Deze uitbreiding is niet als productierijp gemarkeerd. Controleer de ondersteunde werkwijze in je eigen testomgeving voordat je klantbestellingen aanneemt.
Het pakket instellen
Activeer Provisioning en Proxmox en voer de migraties uit. Stel api_url, token_user, token_id, het geheime token_secret, node en storage in op de serververbinding. Gebruik een root-URL zoals https://pve.example.com:8006. De adapter voegt /api2/json toe. Laat TLS-controle aan. Het product vereist template_vmid en passende CPU-, geheugen-, schijf- en netwerkinstellingen.
Providerspecifieke grenzen
De verbinding combineert token_user, inclusief realm, met token_id en token_secret tot een Proxmox API-token. Zet deze gegevens niet in api_url. De URL-controle weigert paden, querystrings, fragmenten en ingebedde gebruikersgegevens. Een verbindingstest controleert versie en node- en opslagcapaciteit, maar voert geen volledige betaalde levering uit.
Productinstellingen zijn template_vmid, cores, memory, disk, sockets, cpu_type, bridge en autostart. De standaardwaarden omvatten één core, 1024 MiB geheugen, 20 GiB schijf, één socket, CPU-type host, bridge vmbr0 en automatisch starten. Dit zijn beginwaarden, geen bewijs dat template, opslag en bridge de configuratie aankunnen.
Test met een wegwerptemplate en voldoende gereserveerde capaciteit. Controleer dat de VM bij de bedoelde instantie hoort, de juiste configuratie heeft en de gewenste werkstatus bereikt. Test opschorten en hervatten los van verwijderen. Een taaktime-out, autorisatiefout en onbekende VM-status vereisen verschillende oplossingen. Zet TLS- of resourcecontroles niet uit om een mislukte test groen te krijgen. 2
Configuratiecontract
| Veld | Type | Verplicht | Geheim | Standaard |
|---|---|---|---|---|
api_url |
string |
Ja | Nee | Leeg |
token_user |
string |
Ja | Nee | Leeg |
token_id |
string |
Ja | Nee | Leeg |
token_secret |
string |
Ja | Ja | Leeg |
node |
string |
Ja | Nee | Leeg |
storage |
string |
Ja | Nee | Leeg |
verify_tls |
boolean |
Nee | Nee | true |
timeout |
string |
Nee | Nee | "30" |
Dit zijn de velden uit het manifest. Een optioneel veld kan voor een API-handeling toch noodzakelijk zijn, zoals hierboven beschreven. Bewaar geheime waarden alleen in beschermde instellingen, nooit in productbeschrijvingen, URL’s of gedeelde voorbeelden. 1
Werking en foutafhandeling
Capaciteitscontrole vergelijkt gevraagde resources en bestaande reserveringen met gegevens van node en opslag. Ongeldige antwoorden en onvoldoende capaciteit geven een fout in plaats van beschikbaarheid te suggereren. Klonen, starten, stoppen en verwijderen controleren taak-ID’s en wachten op voltooiing. Een HTTP-antwoord bewijst dus niet dat de VM klaar is. Vergelijk na een onderbreking eerst de VM-koppeling, externe configuratie en taakstatus voordat je opnieuw kloont.