Providerhandleidingen
Pterodactyl: instellen en beheren
Lever gameservers op een Pterodactyl-paneel vanuit betaalde dienstproducten.
Op deze pagina
Werkwijze bij de provider
Lever gameservers op een Pterodactyl-paneel vanuit betaalde dienstproducten. De adapter koppelt elke Agovena-instantie aan een panelserver, controleert inzetbare resources en ondersteunt opschorten, hervatten, verwijderen, planwijzigingen en statussynchronisatie. Aan- en uitacties voor klanten vereisen daarnaast een Client API-sleutel.
Vereisten
Agovena Core ^0.0.1. Activeer Provisioning vóór deze uitbreiding.
Deze uitbreiding is niet als productierijp gemarkeerd. Controleer de ondersteunde werkwijze in je eigen testomgeving voordat je klantbestellingen aanneemt.
Het pakket instellen
Activeer Provisioning en de Pterodactyl-uitbreiding met hun migraties. Maak een serververbinding met panel_url, het geheime application_api_key en user_id. Voeg client_api_key alleen toe als klanten poweracties nodig hebben. Laat verify_tls aan. Stel op het product location_id, nest_id en egg_id in en vul daarna resourcelimieten en egg-omgevingswaarden aan.
Providerspecifieke grenzen
Gebruik een panelroot zoals https://panel.example.com, zonder inloggegevens of API-pad in de URL. De Application API-sleutel beheert serverresources. De optionele Client API-sleutel stuurt een bestaande klantserver aan. De sleutels zijn niet uitwisselbaar. Het verplichte user_id is de eigenaar op het paneel, niet het Agovena-klant-ID.
Productvelden zijn location_id, nest_id, egg_id, memory, swap, disk, io, cpu, databases, allocations, backups, docker_image, startup, het geheime environment en dedicated_ip. Omgevingswaarden hebben per regel de vorm KEY=value. Gebruik placeholders in gedeelde voorbeelden en bewaar echte waarden in beschermde instellingen. Zonder eigen image of startopdracht worden de egg-waarden gebruikt.
Test een betaalde dienst van aanmaak en installatie tot gereed, opgeschort en hervat. Controleer limieten en eigendom ook in het paneel. Test verwijderen uitsluitend op een wegwerpinstantie. Onderzoek een foutieve koppeling, ontbrekende allocatie of afwijkende eigenaar; omzeil die niet door een extern ID te wijzigen. Een gestopt proces is niet hetzelfde als een opgeschorte dienst. Laat queue en statuscontrole draaien voor verwerking van langlopende handelingen. 2
Configuratiecontract
| Veld | Type | Verplicht | Geheim | Standaard |
|---|---|---|---|---|
panel_url |
string |
Ja | Nee | Leeg |
application_api_key |
string |
Ja | Ja | Leeg |
client_api_key |
string |
Nee | Ja | Leeg |
user_id |
string |
Ja | Nee | Leeg |
verify_tls |
boolean |
Nee | Nee | true |
timeout |
string |
Nee | Nee | "15" |
Dit zijn de velden uit het manifest. Een optioneel veld kan voor een API-handeling toch noodzakelijk zijn, zoals hierboven beschreven. Bewaar geheime waarden alleen in beschermde instellingen, nooit in productbeschrijvingen, URL’s of gedeelde voorbeelden. 1
Werking en foutafhandeling
De adapter controleert eigendom en configuratie voordat een opgeslagen koppeling wordt gebruikt. Bestaande servers kunnen via het vaste externe ID agovena-{instanceId} worden teruggevonden. Installeren en herstellen blijven als provisioning gelden. Een installatiefout wordt mislukt en onbekende levenscyclusgegevens vragen handmatige controle. Poweracties zijn beperkt tot starten, stoppen en herstarten en ontbreken zonder Client API-sleutel.