pgAdmin 4 für deine PostgreSQL-Datenbank hosten

​

Einführung

• Dieser Artikel führt dich durch das Erstellen und Hosten einer pgAdmin-Anwendung auf Square Cloud.
• Bevor du beginnst, stelle sicher, dass du ein Konto bei Square Cloud hast, das du auf der Registrierungsseite mit deiner E-Mail-Adresse erstellen kannst.
• Schließlich benötigst du einen aktiven Plan in deinem Konto. Vergleiche die verfügbaren Pläne und wähle einen passend zu deinen Bedürfnissen.

​

Das Projekt erstellen

• pgAdmin läuft auf Python, das Projekt braucht also eine requirements.txt oder eine pyproject.toml. Siehe wie du eine requirements.txt erstellst.
• Deine requirements.txt muss pgadmin4 und einen Webserver zum Bereitstellen enthalten. In diesem Tutorial verwenden wir gunicorn.

pgadmin4
gunicorn

• Als Nächstes benötigst du eine Konfigurationsdatei config_local.py, um einige Pfade festzulegen. Diese Pfade bestimmen, wo einige Informationen über dein pgAdmin gespeichert werden.

SERVER_MODE = True
MAX_LOGIN_ATTEMPTS = 3
"""
    CRITICAL 50
    ERROR    40
    WARNING  30
    SQL      25
    INFO     20
    DEBUG    10
    NOTSET    0
"""
CONSOLE_LOG_LEVEL = 10
DATA_DIR = "/application/.pgadmin/"
LOG_FILE = "/application/.pgadmin/logfile"
SQLITE_PATH = '/application/.pgadmin/pgadmin4.db'

​

Dateien in deiner ZIP-Datei

• requirements.txt oder pyproject.toml
• config_local.py
• squarecloud.app (die Konfigurationsdatei unten)

​

Konfigurationsdatei

• Beim Upload über das Dashboard legst du die Runtime manuell auf Python fest und verwendest den START-Befehl unten als Startbefehl. In einer Konfigurationsdatei squarecloud.app sieht das so aus:

DISPLAY_NAME=App name
RUNTIME=python
MEMORY=1024
START=python -m gunicorn --bind 0.0.0.0:80 --workers=1 --threads=4 pgadmin4.pgAdmin4:app
VERSION=recommended
SUBDOMAIN=my-pgadmin-subdomain

• Gunicorn lauscht auf Port 80 auf allen Interfaces (0.0.0.0), wohin Square Cloud den Traffic deiner Subdomain leitet. Behalte einen einzigen Worker (--workers=1) und füge stattdessen Threads hinzu: Mit mehr Workern scheitert pgAdmin mit CSRF-Fehlern.
• Lege als Nächstes 2 Umgebungsvariablen fest, PGADMIN_SETUP_EMAIL und PGADMIN_SETUP_PASSWORD. pgAdmin erstellt damit beim ersten Start den ersten Benutzer.

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

• Lege sie im Upload-Formular unter Erweiterte Konfiguration fest, auf der Seite Umgebungsvariablen der Anwendung (und starte sie dann neu) oder mit squarecloud app env set. pgAdmin liest keine .env-Datei im Stammverzeichnis deines Projekts; eine Datei wie die oben funktioniert daher nur als .squarecloud/.env, die Datei, die Square Cloud beim Start der Anwendung lädt (unser fertiges Release nutzt sie). Siehe Umgebungsvariablen.

​

Das Projekt zu Square Cloud hochladen

​

Über das Dashboard

1

Upload-Seite aufrufen

Rufe die Upload-Seite auf und lade die ZIP-Datei deines Projekts hoch.

2

Umgebung konfigurieren

Nachdem du deine ZIP-Datei hochgeladen hast, musst du den Namen, die Hauptdatei oder Runtime-Umgebung und weitere Einstellungen für dein Projekt konfigurieren.
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.

3

Projekt bereitstellen

Klicke abschließend auf die Schaltfläche “Deploy”, um dein Projekt auf Square Cloud zu hosten.
Nach dem Deploy kannst du den Status und die Logs deines Projekts über das Dashboard überwachen.

4

Bestätige, dass deine App live ist

Dein erstes Deploy dauert in der Regel weniger als eine Minute. Warte im Dashboard, bis der Status deiner Anwendung als “running” angezeigt wird, und prüfe die Logs auf Startfehler.
Wenn du eine Website oder API bereitgestellt hast, öffne https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.

App startet nicht? Im Leitfaden zur Fehlerbehebung findest du die häufigsten Ursachen und Lösungen.

​

Über die CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Abschließende Überlegungen

​

Nächste Schritte

​

Kontaktiere uns