Ospita pgAdmin 4 per il tuo database PostgreSQL

​

Introduzione

• Questo articolo ti guida nella creazione e nell’hosting di un’applicazione pgAdmin su Square Cloud.
• Prima di iniziare, assicurati di avere un account su Square Cloud, che puoi creare con la tua email nella pagina di registrazione.
• Infine, devi avere un piano attivo sul tuo account. Confronta i piani disponibili e scegline uno in base alle tue esigenze.

​

Creazione del progetto

• pgAdmin gira su Python, quindi al progetto serve un requirements.txt o un pyproject.toml. Consulta come creare un requirements.txt.
• Il tuo requirements.txt deve contenere pgadmin4 e un webserver per servirlo. In questo tutorial, useremo gunicorn.

pgadmin4
gunicorn

• Successivamente, avrai bisogno di un file di configurazione config_local.py per impostare alcuni percorsi. Questi percorsi definiranno dove salvare alcune informazioni sul tuo pgadmin.

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'

​

File nello ZIP

• requirements.txt o pyproject.toml
• config_local.py
• squarecloud.app (il file di configurazione qui sotto)

​

File di configurazione

• Quando carichi dalla dashboard, imposta manualmente il runtime su Python e usa il comando START qui sotto come comando di avvio. In un file di configurazione squarecloud.app, appare così:

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 ascolta sulla porta 80 su tutte le interfacce (0.0.0.0), dove Square Cloud consegna il traffico del tuo sottodominio. Mantieni un solo worker (--workers=1) e aggiungi invece dei thread: con più worker, pgAdmin fallisce con errori CSRF.
• Poi imposta 2 variabili d’ambiente, PGADMIN_SETUP_EMAIL e PGADMIN_SETUP_PASSWORD. pgAdmin le usa per creare il primo utente al primo avvio.

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

• Impostale in Advanced configuration del modulo di upload, nella pagina Environment Variables dell’applicazione (poi riavviala) o con squarecloud app env set. pgAdmin non legge un file .env nella radice del progetto, quindi un file come quello qui sopra funziona solo come .squarecloud/.env, il file che Square Cloud carica all’avvio dell’applicazione (la nostra release pronta lo usa). Consulta Variabili d’ambiente.

​

Caricamento del progetto su Square Cloud

​

Tramite dashboard

1

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.

2

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.

3

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​

Tramite 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

​

Considerazioni finali

​

Prossimi passi

​

Contattaci