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

Providerhandleidingen

Virtualizor: instellen en beheren

Maak Virtualizor-VPS'en aan en schort ze op, hervat, beëindig of wijzig ze via de Virtualizor Admin API, met statussync.

Op deze pagina

Status en werkwijze

De Virtualizor-extension levert VPS'en via de Virtualizor Admin API. Per Agovena-dienst maakt de extension een VPS met bijbehorende Virtualizor-gebruiker, of koppelt de VPS aan de gebruiker die een eerdere aanmaak door Agovena voor dezelfde klant vastlegde. De extension ondersteunt opschorten, hervatten, beëindigen, planwijzigingen, plannen tonen, statussynchronisatie en een klantpaneel.

Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de Virtualizor Admin API-documentatie en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen Virtualizor-account blijft de verantwoordelijkheid van de beheerder: maak, schort op, hervat, wijzig en beëindig één wegwerp-VPS op je eigen paneel voordat je het product verkoopt, en test planwijzigingen op VPS'en met meerdere schijven apart. Bewerkingen onder Niet ondersteund worden niet aangeboden.

Vereisten

  • Agovena Core ^0.0.1.
  • De Provisioning Module, geactiveerd vóór deze extension.
  • Een Virtualizor-master die via HTTPS bereikbaar is, met de Admin API-key en het wachtwoord uit Configuration > Server Info.
  • Ingeschakelde Virtualizor-plannen, besturingssysteemtemplate-ID's en servergroep-ID's voor je producten.

Het pakket instellen

  1. Activeer de Provisioning Module en installeer en activeer daarna Virtualizor in Admin > Extensies.
  2. Sla api_url op als scheme://host:port zonder pad, bijvoorbeeld https://vz.example.com:4085.
  3. Sla de Admin API-key op in api_token en het Admin API-wachtwoord in api_secret. Beide worden versleuteld opgeslagen.
  4. Laat verify_tls aan.
  5. Voer Test connection uit. Die leest de planlijst.
  6. Stel op elk provisionable product Plan ID (een ingeschakeld plan), Operating system template ID en Server group ID in, waarbij 0 de standaardgroep is.

Ondersteunde bewerkingen

Elke call gaat naar https://host:port/index.php?act=...&api=json met de gedocumenteerde query parameters adminapikey en adminapipass.

Bewerking Verzoek
Health check, plancontrole, plannen tonen POST act=plans
Controle op bestaande gebruiker bij aanmaken POST act=users op e-mailadres
VPS en gebruiker aanmaken POST act=addvs
Statussync, eigendomscontrole GET act=vs&vpsid={id}
Opschorten GET act=vs&suspend={id}
Hervatten GET act=vs&unsuspend={id}
Beëindigen GET act=vs&delete={id} na de eigendomscontrole
Plan wijzigen POST act=managevps met plid, apply_plan=1 en editvps=1 na plan- en eigendomscontrole

Virtualizor antwoordt bij fouten met HTTP 200, dus elk antwoord moet een JSON-object zijn, elke niet-lege error laat de call falen en het gedocumenteerde succesveld wordt gecontroleerd. Een planwijziging wordt alleen geaccepteerd als een nieuwe uitlezing van de VPS de nieuwe plid toont.

Niet ondersteund

  • Poweracties, single sign-on voor klanten en capaciteitscontroles.
  • Virtualizor-gebruikers verwijderen. Beëindigen verwijdert alleen de VPS.
  • Automatisch herstel van een onderbroken aanmaak. Dat vraagt altijd handmatige controle.
  • Plannen voorbij de eerste pagina van 1000 plannen. Zo'n plan wordt als niet beschikbaar gemeld.

Foutafhandeling en eigendom

  • Omdat de inloggegevens query parameters zijn, komen verzoek-URL's nooit in exceptions, meldingen of logs. Transportfouten verschijnen alleen als vertaalsleutels.
  • Eigendom wordt alleen bewezen door een rij in virtualizor_accounts, ingevoegd onder een lock per dienst vóór elke aanmaakcall. Het VPS-ID vervangt de placeholder in dezelfde voorwaardelijke update die de claim actief maakt.
  • Een latere dienst van dezelfde klant op hetzelfde paneel geeft het gebruikers-ID mee dat een eerdere aanmaak door Agovena vastlegde, en het teruggegeven gebruikers-ID moet overeenkomen. Zonder vastgelegde gebruiker blokkeert elke bestaande Virtualizor-gebruiker met hetzelfde e-mailadres de aanmaak, dus een gebruiker die alleen via een zoekactie wordt gevonden, wordt nooit overgenomen.
  • Een niet-lege error-lijst of geweigerde inloggegevens bewijzen dat er niets is aangemaakt; de claim wordt failed en een nieuwe poging maakt opnieuw aan. Een timeout, HTTP-fout of onverwachte body laat de claim op unknown staan. Omdat er geen VPS-ID is vastgelegd, wordt die nooit herhaald en gaat de dienst naar handmatige controle.
  • Beëindigen, plan wijzigen en statussync lezen eerst de VPS op het vastgelegde ID en vereisen de vastgelegde gebruiker. Een ontbrekende VPS gaat naar handmatige controle. Beëindigen bewaart de rij als terminated.
  • Plan wijzigen past het plan toe via apply_plan. De Virtualizor-documentatie waarschuwt dat schijven die in een space-array ontbreken, worden verwijderd. Agovena stuurt geen space-array mee, dus test planwijzigingen op VPS'en met meerdere schijven voordat je ze aanbiedt.
  • De gegenereerde root- en gebruikerswachtwoorden worden één keer verstuurd en nooit opgeslagen. Virtualizor mailt de toegangsgegevens naar de klant.

Configuratiecontract

Veld Type Verplicht Geheim Standaard
api_url string Ja Nee Leeg
api_token string Ja Ja Leeg
api_secret string Ja Ja Leeg
verify_tls boolean Nee Nee true
timeout string Nee Nee "20"

api_token bevat de Admin API-key en api_secret het Admin API-wachtwoord. Calls volgen nooit redirects, controleren TLS, pinnen DNS via de gedeelde provisioning-HTTP-client en worden geweigerd in de demo-omgeving. Productie weigert gewone HTTP en ongecontroleerde TLS. 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