Ospita pgAdmin 4 per il tuo database PostgreSQL

Introduzione

Per sviluppare e ospitare un'istanza pgAdmin su Square Cloud, è essenziale seguire una sequenza strutturata di configurazioni e prerequisiti. Questa guida tecnica coprirà l’intero processo, dalla configurazione iniziale al deploy in produzione.

Prerequisiti

Account Square Cloud: Registrati tramite la pagina di registrazione usando la tua email.
Piano attivo: Garantisce risorse dedicate e prestazioni ottimizzate per la tua applicazione. Consulta i nostri piani disponibili e scegli quello più adatto alle tue esigenze.

Questa guida usa il runtime Python.

Ottenere il progetto

pgAdmin gira su Python, quindi al progetto serve un requirements.txt o un pyproject.toml (consulta come creare un requirements.txt). Elenca pgadmin4 e un web server per servirlo. Questa guida usa gunicorn:

requirements.txt

pgadmin4==9.18
gunicorn==26.2.0

Le versioni sono fissate, come nella nostra release pronta, così una reinstallazione non passa mai a una nuova versione con modifiche incompatibili. Per aggiornare in seguito, cambiale qui e carica di nuovo il progetto. Poi crea un file config_local.py. pgAdmin lo legge all’avvio: queste impostazioni lo eseguono come web server e conservano i suoi dati, il log e il database SQLite in una cartella .pgadmin all’interno della tua applicazione.

config_local.py

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'

Abbiamo già tutto pronto per il deploy nelle nostre release di pgadmin4-web. Devi solo scaricare il project.zip, compilare le due variabili qui sotto e caricarlo.

Configurare Square Cloud

Crea un file squarecloud.app nella radice del tuo progetto:

squarecloud.app

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. Quando carichi dalla dashboard, imposta manualmente il runtime su Python e usa lo stesso comando START come comando di avvio.

Variabili d’ambiente

Imposta 2 variabili d’ambiente, PGADMIN_SETUP_EMAIL e PGADMIN_SETUP_PASSWORD. pgAdmin le usa per creare il primo utente al primo avvio.

.env

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

Impostale in Configurazione avanzata del modulo di upload, nella pagina Variabili d’ambiente dell’applicazione (poi riavviala) o con squarecloud app env set. pgAdmin non legge un file .env nella radice del progetto, quindi questi valori funzionano solo come variabili d’ambiente. Consulta Variabili d’ambiente.

Cosa mettere nello ZIP

requirements.txt o pyproject.toml
config_local.py
squarecloud.app

Deploy e verifica

Tramite dashboard

Accedi alla pagina di upload

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

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.

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.

Caricamento dell'applicazione su Square Cloud

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

Per utilizzare questo metodo, il tuo progetto deve avere un file di configurazione chiamato squarecloud.app nella sua radice. Indica a Square Cloud come eseguire la tua applicazione.

Guida al file di configurazione

Scopri come creare il file di configurazione squarecloud.app che definisce l’ambiente della tua applicazione.

Installa la CLI

Installa la CLI di Square Cloud. Se ce l’hai già, esegui lo stesso comando per aggiornarla:

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

npm install -g @squarecloud/cli@latest

Accedi

Esegui il comando qui sotto. Apre il tuo browser: approva l’accesso lì e la CLI è pronta. Non c’è nessuna chiave API da copiare. Per script e CI, consulta Autenticazione della CLI.

squarecloud auth login

Carica il tuo progetto

Dalla cartella del tuo progetto, esegui il comando qui sotto. La CLI comprime la cartella corrente, escludendo ciò che elenca squarecloud.ignore, e la carica:

squarecloud upload

Per caricare uno zip che hai creato tu, passalo con --file:

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

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Controlla lo stato e i log della tua applicazione direttamente dal terminale:

squarecloud app status
squarecloud app logs

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.

Primo accesso

Apri https://my-pgadmin-subdomain.squareweb.app e accedi con l’email e la password che hai impostato. Poi aggiungi il tuo server PostgreSQL per gestirlo da qualsiasi luogo.

Errori comuni

Dominio personalizzato

Per utilizzare un dominio personalizzato (ad esempio, mysite.com) invece dell’URL predefinito mysite.squareweb.app, hai bisogno del piano Standard o superiore. L’URL predefinito deriva dal campo SUBDOMAIN nel file di configurazione. Per collegare il tuo dominio, segui come configurare il tuo dominio.

Requisiti minimi di RAM

Minimo: 512MB di RAM per siti web e API, sufficienti per una build statica sul runtime statico. Per le app che generano le pagine su un server (Next.js, Nuxt, Angular SSR e simili), consigliamo almeno 1GB di RAM. Per applicazioni più grandi, alloca più RAM per evitare che l’applicazione esaurisca la memoria e si arresti in modo anomalo.

Impossibile trovare questo sito.

Verifica che il sottodominio/dominio corrisponda a quanto configurato nel campo SUBDOMAIN o nelle impostazioni del dominio personalizzato. Se hai appena caricato il sito, attendi fino a 60 secondi affinché Square abiliti il primo accesso.

Il sito ha impiegato troppo tempo per rispondere…

Il tuo server deve ascoltare sulla porta 80 e sull’host 0.0.0.0. Square Cloud imposta le variabili d’ambiente PORT (80) e HOST (0.0.0.0) nella tua applicazione: leggile nel codice invece di scrivere altri valori fissi. Un server che ascolta solo su localhost o 127.0.0.1 non riceve mai richieste.

pgAdmin gira con più di un worker Gunicorn. Imposta --workers=1 nel comando START, aggiungi thread con --threads se ti serve più capacità, poi riavvia l’applicazione.

Prossimi passi

Database gestito

Crea un database PostgreSQL da gestire con pgAdmin.

Errori di connessione al database

Risolvi gli errori SSL/TLS e di connessione.

Gunicorn

Regola il web server che esegue pgAdmin.

Per saperne di più su pgAdmin, consulta la documentazione ufficiale di pgAdmin.

Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.

Bots

Siti web

API e backend

Database

App self-hosted

Guide

Guide alla migrazione

Ospita pgAdmin 4 per il tuo database PostgreSQL

Introduzione

Prerequisiti

Ottenere il progetto

Configurare Square Cloud

Variabili d’ambiente

Cosa mettere nello ZIP

Deploy e verifica

Tramite dashboard

Tramite CLI

Guida al file di configurazione

Primo accesso

Errori comuni

Dominio personalizzato

Requisiti minimi di RAM

Impossibile trovare questo sito.

Il sito ha impiegato troppo tempo per rispondere…

Prossimi passi

Database gestito

Errori di connessione al database

Gunicorn

Contattaci

​Introduzione

​Prerequisiti

​Ottenere il progetto

​Configurare Square Cloud

​Variabili d’ambiente

​Cosa mettere nello ZIP

​Deploy e verifica

​Tramite dashboard

​Tramite CLI

Guida al file di configurazione

​Primo accesso

​Errori comuni

​Dominio personalizzato

​Requisiti minimi di RAM

​Impossibile trovare questo sito.

​Il sito ha impiegato troppo tempo per rispondere…

​Errori CSRF dopo il login

​Prossimi passi

Database gestito

Errori di connessione al database

Gunicorn

​Contattaci

Introduzione

Prerequisiti

Ottenere il progetto

Configurare Square Cloud

Variabili d’ambiente

Cosa mettere nello ZIP

Deploy e verifica

Tramite dashboard

Tramite CLI

Primo accesso

Errori comuni

Dominio personalizzato

Requisiti minimi di RAM

Impossibile trovare questo sito.

Il sito ha impiegato troppo tempo per rispondere…

Errori CSRF dopo il login

Prossimi passi

Contattaci