Websites
Verwaltete Add-ons: Postgres und 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…
Der Tab "Add-ons" ermöglicht es dir, eine verwaltete PostgreSQL-Datenbank oder eine verwaltete Redis-Instanz an eine Website anzuhängen, ohne einen Server dafür zu erstellen oder zu warten. Kapsule stellt sie bereit, gibt dir eine Verbindungszeichenkette und entfernt sie sauber, wenn du sie löschst.
Wo Add-ons zu finden sind
Öffne Websites, klicke auf die Website, öffne das Menü Settings in der Website-Registerkarte und wähle Add-ons. Die Seite heißt Managed addons.
Im Katalog gibt es zwei Optionen:
| Add-on | Typische Verwendung |
|---|---|
| PostgreSQL | Der primäre Datenspeicher für eine Anwendung, die nicht auf MySQL läuft |
| Redis | Caching, Session-Speicherung und Hintergrund-Job-Warteschlangen |
Diese sind separat von der MySQL-Datenbank, die mit einer Standard-Hosting-Website geliefert wird. Diese findest du auf der Registerkarte Files und dann Database und benötigt keine Bereitstellung: siehe Verbinden mit deiner Datenbank über einen SSH-Tunnel.
Ein Add-on anfordern
- Finde das Add-on im Bereich Add a managed database.
- Klicke auf Add to site.
Die Anfrage wird sofort erfasst und das Add-on erscheint in Your addons mit einem PENDING-Badge und dem Hinweis Waiting for provisioner. Die Seite aktualisiert sich alle 15 Sekunden selbst, sodass du sie offen lassen kannst.
Ein Hintergrund-Job nimmt alle paar Minuten ausstehende Anfragen auf, erstellt eine dedizierte Datenbank und einen dedizierten Benutzer für deine Website und schreibt eine verschlüsselte Verbindungszeichenkette zurück. Der Status wird dann auf ACTIVE gesetzt.
Das Anfordern oder Entfernen eines Add-ons erfordert die Berechtigung sites:write. Schreibgeschützte Teammitglieder können sehen, welche Add-ons vorhanden sind und deren Status, aber die Schaltflächen sind verborgen.
Ein Add-on pro Website
Eine Website kann ein PostgreSQL-Add-on und ein Redis-Add-on enthalten. Eine Anfrage für ein zweites derselben Art wird mit einer Meldung abgelehnt, dass es bereits bereitgestellt ist, und der Katalog verbirgt eine Option, sobald sie installiert ist. Wenn beide installiert sind, lautet der Katalogbereich All available addons are installed.
Den Status lesen
| Status | Bedeutung |
|---|---|
| PENDING | Angefordert, in der Warteschlange für den Provisioner |
| PROVISIONING | Wird gerade erstellt |
| ACTIVE | Bereit zur Verwendung |
| FAILED | Die Bereitstellung konnte nicht abgeschlossen werden; der Grund wird in der Zeile angezeigt |
| DELETED | Entfernt, wird nicht mehr aufgelistet |
Eine FAILED-Zeile zeigt den eigentlichen Fehlertext darunter an, anstatt einer generischen Meldung. Wenn der Grund nicht etwas ist, auf das du reagieren kannst, zitiere ihn wortwörtlich in einem Support-Ticket: siehe Support-Ticket öffnen.
Die Verbindungszeichenkette abrufen
Sobald ein Add-on ACTIVE ist, zeigt seine Zeile eine maskierte Verbindungszeichenkette mit durch Punkte ersetztem Passwort, sodass du Host und Datenbankname auf einen Blick bestätigen kannst, ohne die Berechtigung freizulegen.
Klicke auf Copy connection, um die vollständige Verbindungszeichenkette in deine Zwischenablage zu kopieren. Sie wird für diese eine Anfrage serverseitig entschlüsselt und nie auf der Seite angedruckt, sodass Bildschirmfreigaben und Screenshots sie nicht preisgeben. Jedes Aufdecken wird in das Audit-Trail der Website geschrieben und erscheint im Site Activity Log.
Die Zeichenkette hat die übliche URL-Form für jede Engine und enthält Host, Port, Benutzer, Passwort und Datenbankname, die für diese Website erstellt wurden.
In deiner Anwendung verwenden
Füge die Verbindungszeichenkette dort ein, wo deine Anwendung ihre Konfiguration liest. Bei einer Node.js-Website ist die richtige Stelle die Registerkarte Secrets unter einem Schlüssel wie DATABASE_URL oder REDIS_URL in der production-Umgebung.
Hardcode die Verbindungszeichenkette nicht in eine Datei, die du committest. Sie enthält ein Live-Passwort. Wenn es zu einem Git-Remote gelangt, muss es als geleakt behandelt werden, und die einzige echte Lösung ist, das Add-on zu löschen und ein neues anzufordern, da die Berechtigung nicht an Ort und Stelle vom Panel aus rotiert werden kann.
Ein Add-on entfernen
Klicke auf Delete in der Zeile. KPanel fragt dich zur Bestätigung und ist deutlich darüber, was passiert: Dies entfernt die verwaltete Datenbank und die Daten sind unwiederherstellbar.
Die Zeile wird sofort als gelöscht markiert und der Provisioner baut die zugrunde liegende Datenbank und den Benutzer beim nächsten Durchlauf ab. Vorhandene Verbindungen werden als Teil dieses Abbaus beendet.
Von einem verwalteten Add-on wird beim Löschen keine Sicherung erstellt, und es gibt keine Rückgängigmachung. Wenn es etwas darin gibt, das du behalten möchtest, dump es zuerst mit pg_dump oder redis-cli --rdb, während das Add-on noch aktiv ist und die Verbindungszeichenkette noch funktioniert.
Zwischen den Optionen wählen
Verwende PostgreSQL, wenn deine Anwendung eine relationale Datenbank benötigt und für Postgres geschrieben ist: starke Constraints, Transaktionen, JSON-Spalten und Volltextsuche, die du sonst ankleben müsstest.
Verwende Redis für Dinge, die verschwinden dürfen: gecachte Fragmente, Rate-Limit-Counter, Session-Speicherung und Job-Warteschlangen. Behandle es als schnell und flüchtig, nicht als System of Record.
Verwende die integrierte MySQL-Datenbank für WordPress und für alles, das bereits gegen MySQL geschrieben ist. Das Hinzufügen eines Postgres-Add-ons zu einer WordPress-Website ist nicht sinnvoll, da WordPress nicht mit ihm sprechen kann.
Fehlersuche
Das Add-on ist lange Zeit PENDING geblieben. Der Provisioner läuft nach einem Zeitplan und nicht sofort. Lass die Seite offen, da sie sich selbst aktualisiert, und schau später nach. Wenn es nach einigen Durchläufen nicht vorangegangen ist, öffne ein Support-Ticket mit der Website-Domain und dem Add-on-Typ.
Bereitstellung FEHLGESCHLAGEN. Lies den Fehler in der Zeile. Lösche das fehlgeschlagene Add-on und fordere es erneut an, was sicher ist: eine fehlgeschlagene Zeile hatte nie eine Live-Datenbank dahinter.
Copy connection funktioniert nicht. Einige Browser blockieren Clipboard-Schreibvorgänge, wenn die Registerkarte nicht fokussiert ist. Klicke zuerst auf die Seite und dann erneut auf die Schaltfläche.
Die Anwendung kann sich nicht verbinden. Überprüfe der Reihe nach drei Dinge: dass der Add-on-Status ACTIVE ist, dass du die Zeichenkette kopiert hast anstatt sie neu einzugeben, und dass deine Anwendung den Wert liest, den du tatsächlich gesetzt hast, anstatt einen veralteten aus einem vorherigen Deploy. Ein Neustart ist normalerweise erforderlich, bevor neue Konfiguration aufgegriffen wird.
Verbindungen werden nach einer Neubereitstellung abgelehnt. Bestätige, dass die Verbindungszeichenkette in deiner Konfiguration immer noch mit der auf dieser Seite übereinstimmt. Das Löschen und erneute Anfordern eines Add-ons erstellt einen neuen Benutzer und ein neues Passwort, sodass eine alte Zeichenkette nicht funktioniert.
Wo es weitergeht
- App-Geheimnisse für eine Website speichern, der richtige Ort, um die Verbindungszeichenkette zu speichern.
- Verbinden mit deiner Datenbank über einen SSH-Tunnel für die integrierte MySQL-Datenbank.
- Website-Einstellungen für den Rest der Konfiguration auf Website-Ebene.