Websites
Beheerde Addons: Postgres en Redis
The Addons tab lets you attach a managed PostgreSQL database or a managed Redis instance to a site without building or maintaining a server for it. Kapsule provisions it, gives you a connection…
Het tabblad Addons laat je een beheerde PostgreSQL-database of een beheerd Redis-exemplaar aan een site koppelen zonder een server te bouwen of te onderhouden. Kapsule stelt het in, geeft je een verbindingstekenreeks en verwijdert het netjes wanneer je het verwijdert.
Waar Addons zich bevinden
Open Websites, klik op de site, open het menu Settings in de tabstrip van de site en kies Addons. De pagina heet Managed addons.
Twee opties staan in de catalogus:
| Addon | Typisch gebruik |
|---|---|
| PostgreSQL | De primaire datastore voor een applicatie die niet op MySQL draait |
| Redis | Caching, sessieopslag en achtergrondwachtrijen voor taken |
Deze zijn gescheiden van de MySQL-database die bij een standaard hostingsite hoort. Die staat op het tabblad Files, vervolgens Database en heeft geen inrichting nodig: zie Verbinding maken met je database via een SSH-tunnel.
Een addon aanvragen
- Zoek de addon in de sectie Add a managed database.
- Klik op Add to site.
Het verzoek wordt onmiddellijk geregistreerd en de addon verschijnt in Your addons met een PENDING-badge en de opmerking Waiting for provisioner. De pagina vernieuwt zichzelf elke vijftien seconden, dus je kunt het open laten.
Een achtergrondtaak neemt hangende verzoeken elke paar minuten op, maakt een toegewijde database en een toegewijde gebruiker voor je site en schrijft een versleutelde verbindingstekenreeks terug. De status verandert dan in ACTIVE.
Voor het aanvragen of verwijderen van een addon is de machtiging sites:write nodig. Teamleden met alleen-lezen toegang kunnen zien welke addons bestaan en hun status, maar de knoppen zijn verborgen.
Één van elk, per site
Een site kan één PostgreSQL-addon en één Redis-addon bevatten. Om een tweede van hetzelfde type aanvragen wordt geweigerd met een bericht dat het al is voorzien, en de catalogus verbergt een optie zodra deze is geïnstalleerd. Wanneer beide zijn geïnstalleerd, staat in de catalogussectie All available addons are installed.
De status lezen
| Status | Betekenis |
|---|---|
| PENDING | Aangevraagd, in de wachtrij voor de provisioner |
| PROVISIONING | Wordt nu aangemaakt |
| ACTIVE | Klaar voor gebruik |
| FAILED | Inrichting is niet voltooid; de reden wordt op de rij weergegeven |
| DELETED | Verwijderd, niet meer vermeld |
Een FAILED-rij toont de werkelijke fouttekst eronder in plaats van een generiek bericht. Als de reden niet iets is waar je iets aan kunt doen, citeer het dan letterlijk in een supportticket: zie Een ondersteuningsticket openen.
De verbindingstekenreeks ophalen
Zodra een addon ACTIVE is, toont de rij een gemaskeerde verbindingstekenreeks met het wachtwoord vervangen door punten, zodat je de host en databasenaam in één oogopslag kunt bevestigen zonder de referentie bloot te stellen.
Klik op Copy connection om de volledige verbindingstekenreeks op je klembord te zetten. Deze wordt aan serverzijde voor dat ene verzoek ontsleuteld en nooit op de pagina afgedrukt, dus schermdelingen en schermafbeeldingen lekken het niet. Elke reveal wordt geregistreerd in het audittrail van de site en verschijnt in het Activity Log van de site.
De tekenreeks is in de gebruikelijke URL-vorm voor elke engine, met de host, poort, gebruiker, wachtwoord en databasenaam die voor deze site zijn gemaakt.
Het in je applicatie gebruiken
Plak de verbindingstekenreeks in waar je applicatie zijn configuratie leest. Op een Node.js-site is het juiste thuis het tabblad Secrets, onder een sleutel zoals DATABASE_URL of REDIS_URL, in de omgeving production.
Codeer de verbindingstekenreeks niet hardcoded in een bestand dat je commit. Het bevat een live wachtwoord. Als het een git-remote bereikt, moet het als gelekt worden beschouwd, en de enige echte oplossing is de addon verwijderen en een verse aanvragen, omdat de referentie niet ter plekke uit het paneel kan worden geroteerd.
Een addon verwijderen
Klik op Delete op de rij. KPanel vraagt je om bevestiging en is duidelijk over wat er gebeurt: dit verwijdert de beheerde database en de gegevens zijn niet herstelbaar.
De rij wordt onmiddellijk als verwijderd gemarkeerd en de provisioner verwijdert de onderliggende database en gebruiker bij de volgende passage. Bestaande verbindingen worden beëindigd als onderdeel van die sloopfase.
Er wordt geen back-up gemaakt van een beheerde addon bij verwijdering, en er is geen ongedaan maken. Als er iets in zit dat je wilt bewaren, dump het eerst met pg_dump of redis-cli --rdb terwijl de addon nog actief is en de verbindingstekenreeks nog werkt.
Kiezen tussen de opties
PostgreSQL gebruiken wanneer je applicatie een relationele database nodig heeft en tegen Postgres is geschreven: sterke beperkingen, transacties, JSON-kolommen en volledige tekstzoeken die je anders zou moeten toevoegen.
Redis gebruiken voor dingen die mogen verdwijnen: buffers met fragmenten, snelheidslimiettellers, sessieopslag en taakwachtrijen. Behandel het als snel en vluchtig, niet als een systeem van waarheid.
Gebruik de ingebouwde MySQL-database voor WordPress en voor alles wat al tegen MySQL is geschreven. Het toevoegen van een Postgres-addon aan een WordPress-site doet niets nuttigs, omdat WordPress er niet mee kan communiceren.
Probleemoplossing
De addon is al lange tijd PENDING. De provisioner wordt volgens een schema uitgevoerd in plaats van onmiddellijk. Laat de pagina open, omdat deze zichzelf vernieuwt, en controleer later. Als het na een paar passes niet is verplaatst, open je een supportticket met het sitedomein en het addontype.
Inrichting FAILED. Lees de fout op de rij. Verwijder de mislukte addon en vraag hem opnieuw aan, wat veilig is: een mislukte rij had nooit een live database erachter.
Copy connection doet niets. Sommige browsers blokkeren klembordschrijven wanneer het tabblad niet actief is. Klik eerst op de pagina en klik vervolgens opnieuw op de knop.
De applicatie kan geen verbinding maken. Controleer drie dingen op volgorde: dat de addon-status ACTIVE is, dat je de tekenreeks hebt gekopieerd in plaats van opnieuw te typen, en dat je applicatie de waarde leest die je daadwerkelijk hebt ingesteld in plaats van een verouderde waarde van een eerdere implementatie. Een herstart is meestal nodig voordat nieuwe configuratie wordt opgehaald.
Verbindingen worden na een herimplementatie geweigerd. Bevestig dat de verbindingstekenreeks in je configuratie nog steeds overeenkomt met die op deze pagina. Het verwijderen en opnieuw aanvragen van een addon maakt een nieuwe gebruiker en een nieuw wachtwoord aan, dus een oude tekenreeks werkt niet.
Waar je vervolgens naartoe gaat
- App-geheimen opslaan voor een site, de juiste plaats om de verbindingstekenreeks te bewaren.
- Verbinding maken met je database via een SSH-tunnel voor de ingebouwde MySQL-database.
- Site-instellingen voor de rest van de configuratie op siteniveau.