Ga naar de inhoud
agovena.
agovena.
Aan de slag
Community

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

  1. Activeer de Provisioning Module en installeer en activeer daarna Proxmox in Admin > Extensies.
  2. Maak een API-token aan in Proxmox VE.
  3. Sla api_url op als root-URL, bijvoorbeeld https://pve.example.com:8006. De extension voegt zelf /api2/json toe. Paden, query strings, fragments en inloggegevens in de URL worden geweigerd.
  4. Sla token_user inclusief realm, token_id en token_secret op. Samen vormen ze de PVEAPIToken-autorisatieheader. Het secret wordt versleuteld opgeslagen.
  5. Sla de node en storage voor nieuwe VM's op en laat verify_tls aan.
  6. Voer Test connection uit.
  7. Stel op elk provisionable product template_vmid in en controleer cores (standaard 1), memory (standaard 1024), disk (standaard 20), sockets (standaard 1), cpu_type (standaard host), bridge (standaard vmbr0) en autostart (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 in proxmox_vms.
  • Capaciteit: node- en storagecapaciteit worden aan de Provisioning Module doorgegeven, zodat voorraadcontroles orders kunnen weigeren die niet passen.
  • Opschorten stopt de VM, zet onboot op 0 en controleert beide. Hervatten zet onboot op 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: running en stopped worden 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.

Bekijk het pakket

Bronnen

Doorzoek de documentatie

Zoek handleidingen, commando’s en API-endpoints

Waar ben je naar op zoek?

Documentatie