Database gestiti

Disponibilità

Postgres gestito non è ancora disponibile. Il servizio database attuale è un’anteprima control-plane: valida richieste, registra metadati, genera forma credenziale one-time e può pubblicare DATABASE_URL, ma restituisce host non instradabile stub-shared-pg-01.local. Non crea server database, tenant, schema, backup o recovery point.

Non collegare un’applicazione a un record il cui stato è stub. Non trattare una risposta API riuscita come prova che storage esista.

Cosa puoi testare oggi

L’anteprima è utile per testare integrazione contro il contratto pianificato:

ownership app controllata dal wrapper MCP;
record database possono essere creati ed elencati;
la password generata non è restituita da letture metadati successive;
DATABASE_URL può essere passato al produttore ambiente app quando il token produttore è configurato; e
l’app registra il riferimento database restituito.

Pubblicare l’URL placeholder non lo rende utilizzabile. Rimuovilo dall’ambiente app prima di un deploy reale.

Tool MCP

Tool	Comportamento attuale
`add_app_database(app_id, engine='postgres')`	Crea record `stub`. Può pubblicare `DATABASE_URL` placeholder.
`list_app_databases(app_id)`	Restituisce solo metadati. Non restituisce mai la password.

Controlla lo stato restituito prima di fare altro:


add_app_database(app_id='app-12345678', engine='postgres')


{
  "db_id": "db-a1b2c3d4e5f6",
  "engine": "postgres",
  "status": "stub",
  "env_published": false,
  "publish_skipped_reason": "OPENFACTORY_DB_PRODUCER_TOKEN is not configured"
}

La risposta esatta può contenere anche campi connessione one-time. In preview puntano all’host stub e non devono essere usati come credenziali per carico reale.

Contratto REST

Le route lato platform sono:

Metodo	Path	Risultato
`POST`	`/api/app-infra/databases`	Crea record preview e restituisce dati a forma connessione one-time.
`GET`	`/api/app-infra/databases/{db_id}`	Restituisce metadati senza password.
`GET`	`/api/app-infra/databases?app_id={app_id}`	Elenca metadati, opzionalmente filtrati per app.

Queste route di livello inferiore sono principalmente per integrazione interna. Preferisci tool MCP con scope owner salvo sviluppo della platform stessa.

Prima che Postgres gestito possa essere considerato pronto

Una release production-capable richiede evidenza per tutto quanto segue:

servizio Postgres raggiungibile e provisioning tenant reale;
isolamento rete tra app;
rotazione credenziali e deprovisioning;
drill backup e restore con risultati recovery misurati;
limiti risorse, monitoraggio e alert fallimento; e
test applicazione end-to-end che scrive dati, redeploya e li rilegge.

Finché quei controlli non passano nell’ambiente target, porta il tuo database e metti la connection string reale in Variabili ambiente app.