Het tabblad Add-ons stelt u in staat een beheerde PostgreSQL-database of een beheerde Redis-instantie aan een site te koppelen zonder dat u daarvoor een server hoeft te bouwen of te onderhouden. KapsuleHost regelt de provisioning, geeft u een connection string en breekt alles netjes weer af wanneer u de add-on verwijdert.
Waar add-ons zich bevinden
Open Websites, klik op de site, open de groep Apps in het linkermenu van de site en kies Add-ons. De pagina heeft de titel Beheerde add-ons.
Er staan twee opties in de catalogus:
| Add-on | Typisch gebruik |
|---|---|
| PostgreSQL | De primaire datastore voor een applicatie die niet op MySQL draait |
| Redis | Caching, sessieopslag en achtergrondtaken (job queues) |
Deze staan los van de MySQL-database die bij een standaard hostingsite wordt geleverd. Die vindt u op het tabblad Database en vereist geen provisioning: zie Verbinding maken met uw database via een SSH-tunnel.
Een add-on aanvragen
- Zoek de add-on in het gedeelte Een beheerde database toevoegen.
- Klik op Aan site toevoegen.
De aanvraag wordt direct geregistreerd en de add-on verschijnt in Uw add-ons met het label PENDING en de notitie Waiting for provisioner. De pagina ververst zichzelf elke vijftien seconden, dus u kunt haar gewoon open laten staan.
Een achtergrondtaak verwerkt elke paar minuten de openstaande aanvragen, maakt een eigen database en een eigen gebruiker voor uw site aan en schrijft een versleutelde connection string terug. De status gaat vervolgens naar ACTIVE.
Het aanvragen of verwijderen van een add-on vereist de rechten sites:write. Teamleden met alleen-lezen rechten kunnen zien welke add-ons er bestaan en wat hun status is, maar de knoppen zijn voor hen verborgen.
Eén van elk, per site
Een site kan één PostgreSQL-add-on en één Redis-add-on hebben. Als u een tweede van hetzelfde type aanvraagt, wordt dit geweigerd met een melding dat deze al aanwezig is, en de catalogus verbergt een optie zodra deze is geïnstalleerd. Zodra beide zijn geïnstalleerd, toont de catalogus de tekst All available addons are installed.
De status lezen
| Status | Betekenis |
|---|---|
| PENDING | Aangevraagd, in wachtrij voor provisioning |
| PROVISIONING | Wordt op dit moment aangemaakt |
| ACTIVE | Gereed voor gebruik |
| FAILED | Provisioning niet voltooid; de reden wordt op de regel getoond |
| DELETED | Verwijderd, niet langer vermeld |
Bij een regel met FAILED wordt de daadwerkelijke foutmelding eronder getoond in plaats van een algemene melding. Als u met die reden niets kunt, citeer deze dan letterlijk in een supportticket: zie Een supportticket openen.
De connection string ophalen
Zodra een add-on ACTIVE is, toont de regel een gemaskeerde connection string waarin het wachtwoord is vervangen door puntjes, zodat u in één oogopslag de host en databasenaam kunt controleren zonder de inloggegevens bloot te geven.
Klik op Verbinding kopiëren om de volledige connection string naar uw klembord te kopiëren. Deze wordt serverzijdig ontsleuteld voor die ene aanvraag en wordt nooit op de pagina weergegeven, zodat schermdelen en schermafbeeldingen hem niet kunnen lekken. Elke onthulling wordt vastgelegd in het auditlogboek van de site en verschijnt in het Activiteitenlogboek van de site.
De string heeft de gebruikelijke URL-vorm voor elke engine en bevat de host, poort, gebruiker, wachtwoord en databasenaam die voor deze site zijn aangemaakt.
Gebruik in uw applicatie
Plak de connection string op de plek waar uw applicatie zijn configuratie uitleest. Bij een Node.js-site is het tabblad Secrets de juiste plek hiervoor, onder een sleutel zoals DATABASE_URL of REDIS_URL, in de omgeving production.
Zet de connection string niet hardcoded in een bestand dat u commit. Deze bevat een actief wachtwoord. Als deze toch in een git-remote terechtkomt, moet u hem als gelekt beschouwen, en de enige echte oplossing is de add-on te verwijderen en een nieuwe aan te vragen, omdat de inloggegevens niet rechtstreeks vanuit het paneel kunnen worden vervangen.
Een add-on verwijderen
Klik op Delete op de regel. KPanel vraagt om bevestiging en is daarbij duidelijk over de gevolgen: dit verwijdert de beheerde database en de gegevens zijn niet meer te herstellen.
De regel wordt direct als verwijderd gemarkeerd en het provisioningsysteem breekt bij de volgende ronde de onderliggende database en gebruiker af. Bestaande verbindingen worden als onderdeel van die afbraak beëindigd.
Bij verwijdering wordt er geen back-up van een beheerde add-on gemaakt, en er is geen ongedaan maken mogelijk. Als er iets in staat dat u wilt bewaren, dump dit dan eerst met pg_dump of redis-cli --rdb terwijl de add-on nog actief is en de connection string nog werkt.
Kiezen tussen de opties
Gebruik PostgreSQL wanneer uw applicatie een relationele database nodig heeft en is geschreven voor Postgres: sterke constraints, transacties, JSON-kolommen en full-text search die u anders zelf zou moeten toevoegen.
Gebruik Redis voor zaken die mogen verdwijnen: gecachte fragmenten, rate-limit-tellers, sessieopslag en taakwachtrijen. Behandel het als snel en vluchtig, niet als een systeem van record.
Gebruik de ingebouwde MySQL-database voor WordPress en voor alles wat al voor MySQL is geschreven. Een Postgres-add-on aan een WordPress-site toevoegen heeft geen nut, omdat WordPress er niet mee kan communiceren.
Probleemoplossing
De add-on staat al heel lang op PENDING. Het provisioningsysteem werkt volgens een schema en niet onmiddellijk. Laat de pagina open staan, want deze ververst zichzelf, en kijk later nog eens. Als er na een paar rondes nog niets is veranderd, open dan een supportticket met het domein van de site en het type add-on.
Provisioning is mislukt (FAILED). Lees de foutmelding op de regel. Verwijder de mislukte add-on en vraag deze opnieuw aan; dit is veilig, want achter een mislukte regel heeft nooit een actieve database gezeten.
Verbinding kopiëren doet niets. Sommige browsers blokkeren schrijfacties naar het klembord wanneer het tabblad niet actief is. Klik eerst ergens op de pagina en klik daarna nogmaals op de knop.
De applicatie kan geen verbinding maken. Controleer deze drie zaken in volgorde: of de status van de add-on ACTIVE is, of u de string hebt gekopieerd in plaats van overgetypt, en of uw applicatie de waarde leest die u daadwerkelijk hebt ingesteld en niet een verouderde waarde van een eerdere deploy. Meestal is een herstart nodig voordat de nieuwe configuratie wordt opgepikt.
Verbindingen worden geweigerd na een herdeploy. Controleer of de connection string in uw configuratie nog overeenkomt met die op deze pagina. Het verwijderen en opnieuw aanvragen van een add-on creëert een nieuwe gebruiker en een nieuw wachtwoord, waardoor een oude string niet meer werkt.
Wat hierna te doen
- App-secrets opslaan voor een site, de juiste plek om de connection string te bewaren.
- Verbinding maken met uw database via een SSH-tunnel voor de ingebouwde MySQL-database.
- Site-instellingen voor de rest van de configuratie op siteniveau.