Providerhandleidingen
Proxmox VE: instellen en beheren
Lever Proxmox VE QEMU-VM's door een template te klonen, met levenscyclusacties, planwijzigingen, statussync en poweracties voor klanten.
Op deze pagina
Status en werkwijze
De Proxmox VE-extension levert QEMU-VM's met een volledige clone van een template-VMID op de ingestelde node en storage, en past daarna de gekochte CPU-, geheugen-, schijf- en netwerkinstellingen toe. De extension ondersteunt opschorten, hervatten, beëindigen, planwijzigingen, statussynchronisatie, een klantpaneel en starten, stoppen en herstarten door klanten. Langlopende clone-, resize- en verwijderacties worden gevolgd via Proxmox task polling.
Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de Proxmox VE API en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen Proxmox VE-account blijft de verantwoordelijkheid van de beheerder: kloon, schort op, hervat, vergroot en verwijder één VM uit een wegwerptemplate op je eigen cluster voordat je het product verkoopt. Bewerkingen onder Niet ondersteund worden niet aangeboden.
Vereisten
- Agovena Core
^0.0.1. - De Provisioning Module, geactiveerd vóór deze extension.
- Een Proxmox VE-node met een QEMU-template-VM en storage voor de clones.
- Een Proxmox API-token voor een gebruiker met rechten op die node, storage en template.
Het pakket instellen
- Activeer de Provisioning Module en installeer en activeer daarna Proxmox in Admin > Extensies.
- Maak een API-token aan in Proxmox VE.
- Sla
api_urlop als root-URL, bijvoorbeeldhttps://pve.example.com:8006. De extension voegt zelf/api2/jsontoe. Paden, query strings, fragments en inloggegevens in de URL worden geweigerd. - Sla
token_userinclusief realm,token_identoken_secretop. Samen vormen ze dePVEAPIToken-autorisatieheader. Het secret wordt versleuteld opgeslagen. - Sla de
nodeenstoragevoor nieuwe VM's op en laatverify_tlsaan. - Voer Test connection uit.
- Stel op elk provisionable product
template_vmidin en controleercores(standaard 1),memory(standaard 1024),disk(standaard 20),sockets(standaard 1),cpu_type(standaardhost),bridge(standaardvmbr0) enautostart(standaard aan). Deze standaardwaarden zijn een vertrekpunt, geen bewijs dat je template, storage of bridge ze aankan.
Ondersteunde bewerkingen
- Aanmaken met een volledige clone van
template_vmid, gevolgd door de ingestelde CPU-, geheugen-, schijf- en netwerkinstellingen. De VM-beschrijving bevat een eigendomsmarkering voor de dienst en de koppeling staat inproxmox_vms. - Capaciteit: node- en storagecapaciteit worden aan de Provisioning Module doorgegeven, zodat voorraadcontroles orders kunnen weigeren die niet passen.
- Opschorten stopt de VM, zet
onbootop 0 en controleert beide. Hervatten zetonbootop 1, start de VM en controleert dat die draait. - Beëindigen verwijdert alleen een VM met de eigendomsmarkering van deze dienst en controleert dat die weg is.
- Plan wijzigen past de nieuwe productinstellingen toe. Schijven worden vergroot en nooit verkleind, omdat Proxmox VE geen schijven verkleint.
- Statussync:
runningenstoppedworden actief of opgeschort, elke andere status gaat naar handmatige controle. - Klantacties starten, stoppen en herstarten. Stoppen en herstarten zijn gemarkeerd als gevaarlijke acties.
Niet ondersteund
- LXC-containers en andere Proxmox-resourcetypen dan QEMU-VM's.
- IP-pools, besturingssysteemcatalogi, een back-upinterface en bandbreedtemeting.
- Schijven verkleinen bij een lager plan.
Foutafhandeling en eigendom
- Opschorten, hervatten en beëindigen controleren eerst of de VM de eigendomsmarkering van deze dienst heeft. Een VM zonder die markering wordt nooit gewijzigd of verwijderd.
- Een clone kan slagen terwijl het opslaan van de koppeling faalt, bijvoorbeeld na een timeout. Beëindigen vindt de VM dan via de vaste naam en verwijdert die alleen als de markering aanwezig is.
- Clone, resize, starten, stoppen en verwijderen wachten tot de Proxmox-task klaar is. Een HTTP-antwoord alleen bewijst niet dat de VM gereed is.
- Onjuiste antwoorden en onvoldoende capaciteit falen in plaats van beschikbaarheid te suggereren. Vergelijk na een onderbroken actie de koppeling, de configuratie op de node en de taskstatus voordat je opnieuw kloont.
- Redirects worden nooit gevolgd en de token gaat alleen mee in de autorisatieheader, nooit in de URL.
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" |
timeout is standaard 30 seconden per verzoek. Task polling voor clone en verwijderen loopt los van die verzoektimeout. Bewaar geheime waarden alleen in de beschermde extension-instellingen, nooit in productbeschrijvingen, URL's, screenshots of gedeelde voorbeelden.