Trigger verstehen<\/h2>\n
Bevor du Wartungsvorg\u00e4nge f\u00fcr deine Datenbank erstellst, ist es wichtig, die verschiedenen M\u00f6glichkeiten, wie sie ausgel\u00f6st werden k\u00f6nnen, zu verstehen. Jeder Trigger dient einem bestimmten Zweck, um die Wartungsaufgaben zu erleichtern. Die drei wichtigsten Trigger, die h\u00e4ufig verwendet werden, sind:<\/p>\n
- \n
- Manuell, API-basiert<\/strong>: Dieser Trigger erm\u00f6glicht es dir, einmalige Vorg\u00e4nge \u00fcber einen API-Aufruf auszuf\u00fchren. Er ist z. B. n\u00fctzlich, um ein Datenbank-Backup wiederherzustellen oder Indizes neu aufzubauen, wenn die Leistung pl\u00f6tzlich abf\u00e4llt.<\/li>\n
- Zeitplan (wie CRON)<\/strong>: Mit diesem Trigger kannst du geplante Wartungsaktivit\u00e4ten in Zeiten mit geringem Nutzeraufkommen automatisieren. Er ist ideal f\u00fcr ressourcenintensive Vorg\u00e4nge wie Archivierung und Bereinigung. Mit Paketen wie node-schedule<\/a> kannst du Zeitpl\u00e4ne in Node.js einrichten, die die Vorg\u00e4nge bei Bedarf automatisch ausl\u00f6sen.<\/li>\n
- Datenbank-Benachrichtigungen<\/strong>: Dieser Trigger erm\u00f6glicht es dir, Wartungsarbeiten als Reaktion auf Datenbank\u00e4nderungen durchzuf\u00fchren. Wenn zum Beispiel ein Nutzer einen Kommentar auf einer Plattform postet, k\u00f6nnen die gespeicherten Daten sofort eine \u00dcberpr\u00fcfung auf unregelm\u00e4\u00dfige Zeichen, anst\u00f6\u00dfige Sprache oder Emojis ausl\u00f6sen. Diese Funktion l\u00e4sst sich in Node.js mit Paketen wie pg-listen<\/a> implementieren.<\/li>\n<\/ul>\n
Voraussetzungen<\/h2>\n
Um diesem Leitfaden folgen zu k\u00f6nnen, solltest du die folgenden Tools auf deinem lokalen Computer haben:<\/p>\n
- \n
- Git<\/a>: Um die Versionskontrolle f\u00fcr den Quellcode deiner Anwendung zu verwalten<\/li>\n
- Node.js<\/a>: F\u00fcr die Erstellung deiner Backend-Anwendung<\/li>\n
- psql<\/a>: F\u00fcr die Interaktion mit deiner PostgreSQL-Datenbank \u00fcber dein Terminal<\/li>\n
- PGAdmin<\/a> (optional): F\u00fcr die Interaktion mit deiner PostgreSQL-Datenbank \u00fcber eine grafische Benutzeroberfl\u00e4che (GUI).<\/li>\n<\/ul>\n
Erstellen und Hosten einer Node.js-Anwendung<\/h3>\n
Richte ein Node.js-Projekt ein, \u00fcbertrage es auf GitHub und richte eine Auto-Deploy-Pipeline zu Kinsta ein. Du musst auch eine PostgreSQL-Datenbank auf Kinsta<\/a> einrichten, um deine Wartungsroutinen darauf zu testen.<\/p>\n
Beginne damit, ein neues Verzeichnis auf deinem lokalen System mit dem folgenden Befehl zu erstellen:<\/p>\n
mkdir node-db-maintenance<\/code><\/pre>\nWechsle dann in das neu erstellte Verzeichnis und f\u00fchre den folgenden Befehl aus, um ein neues Projekt zu erstellen:<\/p>\n
cd node-db-maintenance\nyarn init -y # or npm init -y<\/code><\/pre>\nDadurch wird ein Node.js-Projekt mit der Standardkonfiguration f\u00fcr dich initialisiert. Du kannst nun die notwendigen Abh\u00e4ngigkeiten installieren, indem du den folgenden Befehl ausf\u00fchrst:<\/p>\n
yarn add express pg nodemon dotenv<\/code><\/pre>\nHier ist eine kurze Beschreibung der einzelnen Pakete:<\/p>\n
- \n
express<\/code>: erm\u00f6glicht es dir, eine Express-basierte REST-API einzurichten.<\/li>\npg<\/code>mit diesem Paket kannst du \u00fcber deine Node.js-Anwendung mit einer PostgreSQL-Datenbank interagieren.<\/li>\nnodemon<\/code>mit diesem Paket kannst du deinen Dev-Build w\u00e4hrend der Entwicklung deiner Anwendung aktualisieren, sodass du deine Anwendung nicht jedes Mal stoppen und starten musst, wenn du eine \u00c4nderung vornimmst.<\/li>\ndotenv<\/code>: erm\u00f6glicht es dir, Umgebungsvariablen aus einer .env-Datei<\/strong> in deinprocess.env<\/code> Objekt zu laden.<\/li>\n<\/ul>\nAls N\u00e4chstes f\u00fcgst du die folgenden Skripte in deine package.json-Datei<\/strong> ein, damit du deinen Entwicklungsserver einfach starten und deinen Server auch in der Produktion betreiben kannst:<\/p>\n
{\n \/\/ ... \n \"scripts\": {\n \"start-dev\": \"nodemon index.js\",\n \"start\": \"NODE_ENV=production node index.js\"\n },\n \/\/ \u2026\n}<\/code><\/pre>\nDu kannst nun eine index.js-Datei<\/strong> erstellen, die den Quellcode deiner Anwendung enth\u00e4lt. F\u00fcge den folgenden Code in diese Datei ein:<\/p>\n
const express = require(\"express\")\nconst dotenv = require('dotenv');\n\nif (process.env.NODE_ENV !== 'production') dotenv.config();\nconst app = express()\nconst port = process.env.PORT || 3000\n\napp.get(\"\/health\", (req, res) => res.json({status: \"UP\"}))\n\napp.listen(port, () => {\n console.log(`Server running at port: ${port}`);\n});<\/code><\/pre>\nDer obige Code initialisiert einen Express-Server<\/a> und konfiguriert die Umgebungsvariablen mit Hilfe des
dotenv<\/code> Pakets, wenn es sich nicht im Produktionsmodus befindet. Er richtet auch eine\/health<\/code> Route ein, die ein JSON-Objekt{status: \"UP\"}<\/code> zur\u00fcckgibt. Schlie\u00dflich wird die Anwendung mit der Funktionapp.listen()<\/code> gestartet, um auf dem angegebenen Port zu lauschen. Wenn kein Port \u00fcber die Umgebungsvariable angegeben wird, wird standardm\u00e4\u00dfig3000<\/code> verwendet.<\/p>\nNachdem du nun eine einfache Anwendung erstellt hast, initialisiere ein neues Git-Repository mit deinem bevorzugten Git-Anbieter (BitBucket<\/a>, GitHub<\/a> oder GitLab<\/a>) und ver\u00f6ffentliche deinen Code. Kinsta unterst\u00fctzt die Bereitstellung von Anwendungen \u00fcber all diese Git-Anbieter. F\u00fcr diesen Artikel verwenden wir GitHub.<\/p>\n
Wenn dein Repository fertig ist, befolge die folgenden Schritte, um deine Anwendung auf Kinsta bereitzustellen:<\/p>\n
- \n
- Melde dich an oder erstelle ein Konto, um dein MyKinsta-Dashboard<\/a> zu sehen.<\/li>\n
- Autorisiere Kinsta mit deinem Git-Anbieter.<\/li>\n
- Klicke in der linken Seitenleiste auf Anwendungen<\/strong> und dann auf Anwendung hinzuf\u00fcgen<\/strong>.<\/li>\n
- W\u00e4hle das Repository und den Zweig aus, von dem aus du bereitstellen m\u00f6chtest.<\/li>\n
- W\u00e4hle einen der verf\u00fcgbaren Rechenzentrumsstandorte aus der Liste der 27 Optionen aus. Kinsta erkennt automatisch die Build-Einstellungen f\u00fcr deine Anwendungen \u00fcber Nixpacks<\/a>.<\/li>\n
- W\u00e4hle die Ressourcen f\u00fcr deine Anwendung, z. B. RAM und Festplattenplatz.<\/li>\n
- Klicke auf Anwendung erstellen<\/strong>.<\/li>\n<\/ol>\n
Sobald die Bereitstellung abgeschlossen ist, kopierst du den Link der bereitgestellten Anwendung und navigierst zu
\/health<\/code>. In deinem Browser sollte das folgende JSON angezeigt werden:<\/p>\n{status: \"UP\"}<\/code><\/pre>\nDies zeigt an, dass die Anwendung korrekt eingerichtet wurde.<\/p>\n
Einrichten einer PostgreSQL-Instanz auf Kinsta<\/h3>\n
Kinsta bietet eine einfache Schnittstelle zur Bereitstellung von Datenbankinstanzen. Beginne damit, ein neues Kinsta-Konto<\/a> zu erstellen, falls du noch keines hast. Befolge dann die folgenden Schritte:<\/p>\n
- \n
- Logge dich in dein MyKinsta-Dashboard ein.<\/li>\n
- Klicke in der linken Seitenleiste auf Datenbanken<\/strong> und dann auf Datenbank hinzuf\u00fcgen<\/strong>.<\/li>\n
- W\u00e4hle PostgreSQL<\/strong> als Datenbanktyp und w\u00e4hle deine bevorzugte Version. W\u00e4hle einen Namen f\u00fcr deine Datenbank und \u00e4ndere den Benutzernamen und das Passwort, wenn du m\u00f6chtest.<\/li>\n
- W\u00e4hle einen Standort f\u00fcr das Rechenzentrum aus der Liste von 27 aus.<\/li>\n
- W\u00e4hle die Gr\u00f6\u00dfe deiner Datenbank.<\/li>\n
- Klicke auf Datenbank erstellen<\/strong>.<\/li>\n<\/ol>\n
Sobald die Datenbank erstellt ist, stelle sicher, dass du den Datenbank-Host, den Port, den Benutzernamen und das Passwort abrufst.<\/p>\n
![\"Der](\"https:\/\/kinqsta.com\/wp-content\/uploads\/2023\/11\/database-credentials-from-kinsta-1024x435.jpg\")
Von Kinsta generierte Datenbank-Anmeldedaten<\/figcaption><\/figure>\n Du kannst diese Werte dann in dein psql CLI (oder PGAdmin GUI) eingeben, um die Datenbank zu verwalten. Um deinen Code lokal zu testen, erstelle eine .env-Datei<\/strong> im Hauptverzeichnis deines Projekts und speichere darin die folgenden Secrets:<\/p>\n
DB_USER_NAME=your database user name\nDB_HOST=your database host\nDB_DATABASE_NAME=your database\u2019s name\nDB_PORT=your database port\nPGPASS=your database password<\/code><\/pre>\nWenn du auf Kinsta bereitstellst, musst du diese Werte als Umgebungsvariablen<\/a> zu deiner Anwendungsimplementierung hinzuf\u00fcgen.<\/p>\n
Um die Datenbankoperationen vorzubereiten, lade dieses SQL-Skript<\/a> herunter und f\u00fchre es aus, um Tabellen (Benutzer, Beitr\u00e4ge, Kommentare) zu erstellen und Beispieldaten einzuf\u00fcgen. Verwende den folgenden Befehl, indem du die Platzhalter durch deine eigenen Angaben ersetzt, um die Daten zu deiner neu erstellten PostgreSQL-Datenbank hinzuzuf\u00fcgen:<\/p>\n
psql -h <host> -p <port> -U <username> -d <db_name> -a -f <sql file e.g. test-data.sql><\/code><\/pre>\nAchte darauf, dass du den genauen Dateinamen und den Pfad im obigen Befehl eingibst. Bei der Ausf\u00fchrung dieses Befehls wirst du aufgefordert, dein Datenbankpasswort zur Autorisierung einzugeben.<\/p>\n
Sobald dieser Befehl ausgef\u00fchrt wurde, kannst du mit dem Schreiben von Operationen f\u00fcr die Wartung deiner Datenbank beginnen. Du kannst deinen Code in dein Git-Repository stellen, wenn du mit jeder Operation fertig bist, um ihn auf der Kinsta-Plattform in Aktion zu sehen.<\/p>\n
Wartungsroutinen schreiben<\/h2>\n
In diesem Abschnitt werden mehrere h\u00e4ufig verwendete Operationen f\u00fcr die Wartung von PostgreSQL-Datenbanken erkl\u00e4rt.<\/p>\n
1. Backups erstellen<\/h3>\n
Regelm\u00e4\u00dfige Backups von Datenbanken sind ein g\u00e4ngiger und wichtiger Vorgang. Dabei wird eine Kopie des gesamten Datenbankinhalts erstellt, die an einem sicheren Ort gespeichert wird. Diese Backups sind wichtig f\u00fcr die Wiederherstellung von Daten im Falle eines versehentlichen Verlusts oder von Fehlern, die die Datenintegrit\u00e4t beeintr\u00e4chtigen.<\/p>\n
Auch wenn Plattformen wie Kinsta automatische Backups<\/a> als Teil ihrer Dienste anbieten, ist es wichtig zu wissen, wie man bei Bedarf eine eigene Backup-Routine einrichtet.<\/p>\n
PostgreSQL bietet das Tool pg_dump<\/a> f\u00fcr die Erstellung von Datenbanksicherungen. Es muss jedoch direkt von der Kommandozeile aus ausgef\u00fchrt werden und es gibt kein npm-Paket daf\u00fcr. Du musst also das Paket @getvim\/execute<\/a> verwenden, um den Befehl
pg_dump<\/code> in der lokalen Umgebung deiner Node-Anwendung auszuf\u00fchren.<\/p>\nInstalliere das Paket, indem du den folgenden Befehl ausf\u00fchrst:<\/p>\n
yarn add @getvim\/execute<\/code><\/pre>\nAls N\u00e4chstes importierst du das Paket in deine index.js-Datei <\/strong>, indem du diese Codezeile am Anfang einf\u00fcgst:<\/p>\n
const {execute} = require('@getvim\/execute');<\/code><\/pre>\nDie Backups werden als Dateien im lokalen Dateisystem deiner Node-Anwendung erstellt. Daher ist es am besten, wenn du im Stammverzeichnis des Projekts ein eigenes Verzeichnis mit dem Namen backup<\/strong> anlegst.<\/p>\n
Jetzt kannst du die folgende Route verwenden, um bei Bedarf Backups deiner Datenbank zu erstellen und herunterzuladen:<\/p>\n
app.get('\/backup', async (req, res) => {\n\n \/\/ Create a name for the backup file\n const fileName = \"database-backup-\" + new Date().valueOf() + \".tar\";\n\n \/\/ Execute the pg_dump command to generate the backup file\n execute(\"PGPASSWORD=\" + process.env.PGPASS + \" pg_dump -U \" + process.env.DB_USER_NAME \n + \" -d \" + process.env.DB_DATABASE_NAME \n + \" -h \" + process.env.DB_HOST\n + \" -p \" + process.env.DB_PORT\n + \" -f backup\/\" + fileName + \" -F t\"\n\n).then(async () => {\n console.log(\"Backup created\");\n res.redirect(\"\/backup\/\" + fileName)\n }).catch(err => {\n console.log(err);\n res.json({message: \"Something went wrong\"})\n })\n\n})<\/code><\/pre>\nAu\u00dferdem musst du die folgende Zeile am Anfang deiner index.js-Datei<\/strong> einf\u00fcgen, nachdem die Express-Anwendung initialisiert wurde:<\/p>\n
app.use('\/backup', express.static('backup'))<\/code><\/pre>\nDadurch kann der Backup-Ordner<\/strong> statisch mit der Middleware-Funktion
express.static<\/code> bedient werden, so dass der Nutzer die erzeugten Backup-Dateien von der Node-Anwendung herunterladen kann.<\/p>\n - W\u00e4hle PostgreSQL<\/strong> als Datenbanktyp und w\u00e4hle deine bevorzugte Version. W\u00e4hle einen Namen f\u00fcr deine Datenbank und \u00e4ndere den Benutzernamen und das Passwort, wenn du m\u00f6chtest.<\/li>\n
- Node.js<\/a>: F\u00fcr die Erstellung deiner Backend-Anwendung<\/li>\n
- Zeitplan (wie CRON)<\/strong>: Mit diesem Trigger kannst du geplante Wartungsaktivit\u00e4ten in Zeiten mit geringem Nutzeraufkommen automatisieren. Er ist ideal f\u00fcr ressourcenintensive Vorg\u00e4nge wie Archivierung und Bereinigung. Mit Paketen wie node-schedule<\/a> kannst du Zeitpl\u00e4ne in Node.js einrichten, die die Vorg\u00e4nge bei Bedarf automatisch ausl\u00f6sen.<\/li>\n