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
- Activeer de Provisioning Module en installeer en activeer daarna Virtualizor in Admin > Extensies.
- Sla
api_urlop alsscheme://host:portzonder pad, bijvoorbeeldhttps://vz.example.com:4085. - Sla de Admin API-key op in
api_tokenen het Admin API-wachtwoord inapi_secret. Beide worden versleuteld opgeslagen. - Laat
verify_tlsaan. - Voer Test connection uit. Die leest de planlijst.
- 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 wordtfaileden een nieuwe poging maakt opnieuw aan. Een timeout, HTTP-fout of onverwachte body laat de claim opunknownstaan. 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 eenspace-array ontbreken, worden verwijderd. Agovena stuurt geenspace-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.