Die Registerkarte „Add-ons“ ermöglicht es dir, eine verwaltete PostgreSQL-Datenbank oder eine verwaltete Redis-Instanz mit einer Website zu verbinden, ohne dafür einen Server aufzubauen oder zu pflegen. KapsuleHost stellt sie bereit, gibt dir eine Verbindungszeichenfolge und baut sie sauber ab, wenn du sie entfernst.
Wo Add-ons zu finden sind
Öffne Websites, klicke auf die Website, öffne die Gruppe Apps im linken Menü der Website und wähle Add-ons. Die Seite trägt den Titel Verwaltete Add-ons.
Zwei Optionen sind im Katalog verfügbar:
| 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 getrennt von der MySQL-Datenbank, die mit einer Standard-Hosting-Website mitgeliefert wird. Diese befindet sich auf der Registerkarte Datenbank und benötigt keine Bereitstellung: siehe Verbindung zu deiner Datenbank über einen SSH-Tunnel herstellen.
Ein Add-on anfordern
- Suche das Add-on im Bereich Verwaltete Datenbank hinzufügen.
- Klicke auf Zur Website hinzufügen.
Die Anfrage wird sofort erfasst und das Add-on erscheint unter Deine Add-ons mit dem Abzeichen PENDING und dem Hinweis Warte auf Provisioner. Die Seite aktualisiert sich alle fünfzehn Sekunden selbst, du kannst sie also geöffnet lassen.
Ein Hintergrundjob nimmt sich alle paar Minuten der ausstehenden Anfragen an, erstellt eine eigene Datenbank und einen eigenen Benutzer für deine Website und schreibt eine verschlüsselte Verbindungszeichenfolge zurück. Der Status wechselt dann zu ACTIVE.
Das Anfordern oder Entfernen eines Add-ons erfordert die Berechtigung sites:write. Teammitglieder mit Nur-Lese-Zugriff können sehen, welche Add-ons existieren und welchen Status sie haben, aber die Schaltflächen sind ausgeblendet.
Eines von jeder Art, pro Website
Eine Website kann ein PostgreSQL-Add-on und ein Redis-Add-on besitzen. Die Anfrage nach einem zweiten Add-on desselben Typs wird mit dem Hinweis abgelehnt, dass bereits eines bereitgestellt ist, und der Katalog blendet eine Option aus, sobald sie installiert ist. Wenn beide installiert sind, zeigt der Katalogbereich Alle verfügbaren Add-ons sind installiert.
Den Status lesen
| Status | Bedeutung |
|---|---|
| PENDING | Angefordert, in der Warteschlange für den Provisioner |
| PROVISIONING | Wird gerade erstellt |
| ACTIVE | Einsatzbereit |
| FAILED | Bereitstellung nicht abgeschlossen; der Grund wird in der Zeile angezeigt |
| DELETED | Entfernt, nicht mehr gelistet |
Eine Zeile mit FAILED zeigt darunter den tatsächlichen Fehlertext anstelle einer allgemeinen Meldung. Wenn der Grund nichts ist, worauf du reagieren kannst, zitiere ihn wörtlich in einem Support-Ticket: siehe Ein Support-Ticket eröffnen.
Die Verbindungszeichenfolge abrufen
Sobald ein Add-on ACTIVE ist, zeigt seine Zeile eine maskierte Verbindungszeichenfolge an, bei der das Passwort durch Punkte ersetzt ist, sodass du Host und Datenbankname auf einen Blick bestätigen kannst, ohne das Zugangsdaten offenzulegen.
Klicke auf Verbindung kopieren, um die vollständige Verbindungszeichenfolge in die Zwischenablage zu legen. Sie wird serverseitig nur für diese eine Anfrage entschlüsselt und niemals auf der Seite angezeigt, sodass Bildschirmfreigaben und Screenshots sie nicht preisgeben. Jede Offenlegung wird im Prüfprotokoll der Website vermerkt und erscheint im Website-Aktivitätsprotokoll.
Die Zeichenfolge liegt in der üblichen URL-Form für die jeweilige Engine vor und enthält Host, Port, Benutzer, Passwort und Datenbankname, die für diese Website erstellt wurden.
Verwendung in deiner Anwendung
Füge die Verbindungszeichenfolge dort ein, wo deine Anwendung ihre Konfiguration liest. Bei einer Node.js-Website ist der richtige Ort dafür die Registerkarte Secrets, unter einem Schlüssel wie DATABASE_URL oder REDIS_URL, in der Umgebung production.
Schreibe die Verbindungszeichenfolge nicht fest in eine Datei, die du committest. Sie enthält ein aktives Passwort. Landet sie in einem Git-Remote, muss sie als kompromittiert behandelt werden, und die einzig wirkliche Lösung ist, das Add-on zu löschen und ein neues anzufordern, da die Zugangsdaten nicht direkt im Panel rotiert werden können.
Ein Add-on entfernen
Klicke in der Zeile auf Löschen. KPanel bittet um eine Bestätigung und macht unmissverständlich klar, was passiert: Dies entfernt die verwaltete Datenbank, und die Daten sind unwiederbringlich verloren.
Die Zeile wird sofort als gelöscht markiert, und der Provisioner baut die zugrunde liegende Datenbank und den Benutzer bei seinem nächsten Durchlauf ab. Bestehende Verbindungen werden im Rahmen dieses Abbaus beendet.
Beim Löschen eines verwalteten Add-ons wird keine Sicherung angelegt, und es gibt kein Rückgängigmachen. Wenn sich darin etwas befindet, das du behalten möchtest, exportiere es zuerst mit pg_dump oder redis-cli --rdb, solange das Add-on noch aktiv ist und die Verbindungszeichenfolge noch funktioniert.
Zwischen den Optionen wählen
Verwende PostgreSQL, wenn deine Anwendung eine relationale Datenbank benötigt und gegen Postgres geschrieben ist: starke Integritätsbedingungen, Transaktionen, JSON-Spalten und Volltextsuche, die du sonst selbst ergänzen müsstest.
Verwende Redis für Dinge, die verschwinden dürfen: zwischengespeicherte Fragmente, Zähler für Ratenbegrenzung, Session-Speicherung und Job-Warteschlangen. Behandle es als schnell und flüchtig, nicht als Primärdatenquelle.
Verwende die integrierte MySQL-Datenbank für WordPress und für alles, was bereits gegen MySQL geschrieben ist. Ein Postgres-Add-on zu einer WordPress-Website hinzuzufügen, bringt nichts, da WordPress nicht damit kommunizieren kann.
Fehlerbehebung
Das Add-on ist seit langer Zeit PENDING. Der Provisioner läuft nach einem Zeitplan und nicht sofort. Lasse die Seite geöffnet, da sie sich selbst aktualisiert, und schau später wieder vorbei. Wenn sich nach mehreren Durchläufen nichts geändert hat, eröffne ein Support-Ticket mit der Website-Domain und dem Add-on-Typ.
Bereitstellung FAILED. Lies den Fehler in der Zeile. Lösche das fehlgeschlagene Add-on und fordere es erneut an, das ist unbedenklich: Eine fehlgeschlagene Zeile hatte nie eine aktive Datenbank dahinter.
Verbindung kopieren funktioniert nicht. Manche Browser blockieren Schreibvorgänge in die Zwischenablage, wenn der Tab nicht im Fokus ist. Klicke zuerst auf die Seite und dann erneut auf die Schaltfläche.
Die Anwendung kann keine Verbindung herstellen. Prüfe der Reihe nach drei Dinge: dass der Add-on-Status ACTIVE ist, dass du die Zeichenfolge kopiert und nicht abgetippt hast, und dass deine Anwendung den Wert liest, den du tatsächlich gesetzt hast, und nicht einen veralteten aus einer früheren Bereitstellung. In der Regel ist ein Neustart nötig, bevor die neue Konfiguration übernommen wird.
Verbindungen werden nach einem erneuten Deployment abgelehnt. Vergewissere dich, dass die Verbindungszeichenfolge in deiner Konfiguration noch mit der auf dieser Seite übereinstimmt. Das Löschen und erneute Anfordern eines Add-ons erzeugt einen neuen Benutzer und ein neues Passwort, sodass eine alte Zeichenfolge nicht mehr funktioniert.
Wie es weitergeht
- App-Geheimnisse für eine Website speichern, der richtige Ort, um die Verbindungszeichenfolge aufzubewahren.
- Verbindung zu deiner Datenbank über einen SSH-Tunnel herstellen für die integrierte MySQL-Datenbank.
- Website-Einstellungen für die übrige Konfiguration auf Website-Ebene.