Providerhandleidingen
VirtFusion: instellen en beheren
Maak, bouw, schort op, hervat, beëindig en wijzig VirtFusion-virtuele servers via de VirtFusion API v1, met statussync.
Op deze pagina
Status en werkwijze
De VirtFusion-extension levert virtuele servers via de VirtFusion API v1. Per Agovena-dienst maakt de extension de VirtFusion-gebruiker voor die klant aan of hergebruikt de gebruiker die Agovena eerder aanmaakte, maakt een server op basis van het productpackage en bouwt die met de besturingssysteemtemplate van het product. De extension ondersteunt opschorten, hervatten, beëindigen, planwijzigingen, packagecontroles, statussynchronisatie en een klantpaneel.
Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de VirtFusion API v1-documentatie en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen VirtFusion-account blijft de verantwoordelijkheid van de beheerder: maak, bouw, schort op, hervat, wijzig en beëindig één wegwerpserver op je eigen paneel 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 VirtFusion-paneel dat via HTTPS bereikbaar is en een VirtFusion API-token.
- Ingeschakelde VirtFusion-packages, een hypervisorgroep-ID en een besturingssysteemtemplate-ID per product.
Het pakket instellen
- Activeer de Provisioning Module en installeer en activeer daarna VirtFusion in Admin > Extensies.
- Sla
api_urlop alsscheme://host[:port]zonder pad, bijvoorbeeldhttps://cp.example.com, en de API-token inapi_token. De token wordt versleuteld opgeslagen. - Laat
verify_tlsaan. - Voer Test connection uit. Die roept de alleen-lezen
GET /connectaan. - Stel op elk provisionable product Package ID (een ingeschakeld VirtFusion-package), Hypervisor group ID en Operating system template ID in.
Ondersteunde bewerkingen
Calls gaan naar https://host:port/api/v1/... met een bearer token.
| Bewerking | Methode en pad |
|---|---|
| Health check | GET /connect |
| Packagecontrole | GET /packages |
| Gebruiker aanmaken | POST /users met sendMail=true |
| Onderbroken gebruikersaanmaak reconciliëren | GET /users/{relStr}/byExtRelation |
| Server aanmaken | POST /servers met packageId, userId, hypervisorId |
| Server bouwen | POST /servers/{id}/build met operatingSystemId en email=true |
| Statussync, build reconciliëren | GET /servers/{id} |
| Opschorten | POST /servers/{id}/suspend |
| Hervatten | POST /servers/{id}/unsuspend |
| Beëindigen | DELETE /servers/{id} zonder vertraging; 404 betekent al verwijderd |
| Plan wijzigen | PUT /servers/{id}/package/{packageId} |
Een planwijziging controleert eerst of het doelpackage bestaat en is ingeschakeld, en vraagt daarna elke gedocumenteerde resource het nieuwe package te volgen. Alleen een 200 met een info-lijst wordt geaccepteerd. VirtFusion verkleint nooit een primaire schijf en meldt overgeslagen resources in info.
Niet ondersteund
- Poweracties, single sign-on voor klanten en capaciteitscontroles.
- VirtFusion-gebruikers verwijderen. Beëindigen verwijdert alleen de server.
Foutafhandeling en eigendom
- Eigendom wordt alleen bewezen door een rij in
virtfusion_accounts, ingevoegd met een willekeurige relatiestring vóór elke aanmaakcall. Het numeriekeextRelationIdvan VirtFusion kan geen namespace krijgen, dus de gedocumenteerde relatiestring legt de koppeling. - Per klant en endpoint wordt één VirtFusion-gebruiker aangemaakt. Een latere dienst van dezelfde klant op hetzelfde paneel hergebruikt het gebruikers-ID dat een eerdere aanmaak door Agovena vastlegde. Een gebruiker die alleen via e-mail of een zoekactie wordt gevonden, wordt nooit overgenomen; een dubbel e-mailadres geeft een gedocumenteerde
409en laat de claim falen. 409en422bij het aanmaken van gebruiker of server en geweigerde inloggegevens bewijzen dat er niets is aangemaakt. De claim wordtfaileden een nieuwe poging maakt opnieuw aan. Timeouts, andere fouten en onverwachte bodies laten de claim opunknownstaan en de dienst gaat naar handmatige controle.- Reconciliatie leest alleen vastgelegde ID's. Een server waarvan de eigenaar bij de vastgelegde gebruiker past maar die nog niet gebouwd is, wordt opnieuw gebouwd; VirtFusion weigert dat met
423zolang een build loopt. Een serveraanmaak zonder teruggegeven ID wordt nooit herhaald. - Levenscycluscalls vereisen dat claimstatus en huidig endpoint overeenkomen. Een omgezet paneel of een handmatig ingevulde
provider_mappingzonder claimrij wordt zonder netwerkcall geweigerd. Beëindigen bewaart de rij alsterminated. - Het gebruikerswachtwoord uit het aanmaakantwoord wordt nooit opgeslagen. VirtFusion mailt de toegangsgegevens naar de klant.
Configuratiecontract
| Veld | Type | Verplicht | Geheim | Standaard |
|---|---|---|---|---|
api_url |
string |
Ja | Nee | Leeg |
api_token |
string |
Ja | Ja | Leeg |
verify_tls |
boolean |
Nee | Nee | true |
timeout |
string |
Nee | Nee | "20" |
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.