Database esterno

Per impostazione predefinita, lo stack Compose esegue il proprio container Postgres. In alternativa, puoi eseguire lo stesso stack su un Postgres gestito. In tal caso, il container postgres non viene mai avviato. L'autenticazione, la Data API, lo storage e il Migration Runner si connettono al tuo database.

Tested a ogni release: un Postgres 16 semplice con pgvector, nel replay di integrazione continua dell'intera catena di migrazione.

Expected to work, dalla documentazione del provider:

• Azure Database per PostgreSQL Flexible Server
• Amazon RDS for PostgreSQL e Amazon Aurora PostgreSQL
• Google Cloud SQL per PostgreSQL e AlloyDB
• Neon

Funziona anche qualsiasi altro Postgres che soddisfi i requisiti indicati di seguito. Segnala il tuo risultato nel tracker dei problemi, in modo che l'elenco possa spostare un provider nello stato tested.

Requisiti

Collega lo stack

Passa la stringa di connessione dell'amministratore allo script di bootstrap:

./deploy/bootstrap.sh --database-url postgresql://admin:password@host:5432/dbname

Lo script scrive le impostazioni EXTERNAL_DB_* e l'overlay docker-compose.external-db.yml in deploy/.env. Crea un'unica password per i tre accessi ai servizi. Quindi verifica il database prima di avviare un container: la versione di Postgres, le due estensioni, i privilegi di amministratore, il limite di connessioni e TLS. Ogni controllo non superato visualizza una riga che ti indica cosa modificare.

Lo script rifiuta un hostname del pooler, un progetto Supabase ospitato, sslmode=disable e una password con caratteri che una stringa di connessione non può supportare. Esegui la codifica percentuale di tali caratteri oppure imposta una password di amministratore più semplice.

All'avvio, un servizio one-shot provision prepara il database con i privilegi di amministratore. Crea i ruoli, gli schemi auth, storage e extensions, le funzioni helper di autenticazione, i privilegi predefiniti e le due estensioni. Il servizio viene eseguito nuovamente a ogni avvio e non modifica nulla quando il database è pronto.

L'opzione --database-url si combina con --images, --workers e --tls. Esegui nuovamente lo script con una nuova connection string per puntare lo stack a un database diverso. La password del servizio viene conservata.

Verifica il certificato

I provider con una propria autorità di certificazione privata necessitano del bundle per la verifica completa:

./deploy/bootstrap.sh --database-url postgresql://admin:password@host:5432/dbname --db-ca ./bundle.pem

Lo script copia il bundle in deploy/external-db/db-ca.pem e imposta sslmode=verify-full. Ogni servizio verifica quindi il server rispetto a tale bundle.

Note del provider

Neon

Crea il progetto in una regione dell'UE su Postgres 16 o versione successiva. Copia la stringa di connessione direct, non quella -pooler. Il piano Free sospende l'elaborazione dopo cinque minuti di inattività. La prima richiesta dopo una pausa richiede alcuni secondi, durante i quali i servizi si riconnettono.

Azure Database per PostgreSQL Flexible Server

Crea il server su Postgres 16 o versione successiva. Aggiungi vector,pg_trgm al parametro del server azure.extensions prima di eseguire lo script di bootstrap. Usa l'admin login che hai impostato al momento della creazione. Aggiungi l'indirizzo IP del tuo host alle regole del firewall.

Amazon RDS e Aurora

Usa l'utente master. Scarica il bundle di certificati e passalo con --db-ca. Consenti il tuo host nel security group. Le versioni di Aurora precedenti alla 17 non impongono l'uso di TLS. Lo stack utilizza ancora TLS.

Google Cloud SQL e AlloyDB

Usa l'utente postgres. Seleziona almeno il livello db-g1-small su Cloud SQL. Scarica server-ca.pem dall'istanza e passalo con --db-ca. Aggiungi l'indirizzo IP pubblico del tuo host agli authorized networks.

Supabase in hosting

Un progetto Supabase ospitato non può essere il database sotto questi container. I suoi ruoli di servizio esistono con password di cui non sei in possesso, e i suoi servizi proprietari detengono gli schemi auth e storage. Invece, punta l'applicazione a quel progetto e non eseguire il profilo db.

Backup

Il provider conserva i backup del database. I file caricati rimangono nel volume storage-data sul tuo host. Esegui il backup del volume insieme al database. Ripristina entrambi allo stesso punto temporale. Consulta Database per i comandi relativi al volume.

Aggiornamento

Gli aggiornamenti funzionano come descritto in Upgrade. Il servizio migrate applica le migrazioni in sospeso al tuo database. Il servizio provision viene eseguito per primo e conferma i ruoli e gli schemi.