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

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

  1. Activeer de Provisioning Module en installeer en activeer daarna VirtFusion in Admin > Extensies.
  2. Sla api_url op als scheme://host[:port] zonder pad, bijvoorbeeld https://cp.example.com, en de API-token in api_token. De token wordt versleuteld opgeslagen.
  3. Laat verify_tls aan.
  4. Voer Test connection uit. Die roept de alleen-lezen GET /connect aan.
  5. 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 numerieke extRelationId van 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 409 en laat de claim falen.
  • 409 en 422 bij het aanmaken van gebruiker of server en geweigerde inloggegevens bewijzen dat er niets is aangemaakt. De claim wordt failed en een nieuwe poging maakt opnieuw aan. Timeouts, andere fouten en onverwachte bodies laten de claim op unknown staan 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 423 zolang 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_mapping zonder claimrij wordt zonder netwerkcall geweigerd. Beëindigen bewaart de rij als terminated.
  • 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.

Bekijk het pakket

Bronnen

Doorzoek de documentatie

Zoek handleidingen, commando’s en API-endpoints

Waar ben je naar op zoek?

Documentatie