Bases de données gérées
Disponibilité
Postgres géré n’est pas encore disponible. Le service base de données actuel est un aperçu plan de contrôle : il valide requêtes, enregistre métadonnées, génère une forme d’identifiant à usage unique et peut publier DATABASE_URL, mais il renvoie l’hôte non routable stub-shared-pg-01.local. Il ne crée pas de serveur base, locataire, schéma, sauvegarde ni point de reprise.
Ne connectez pas une application à un enregistrement dont le statut est stub. Ne traitez pas une réponse API réussie comme preuve qu’un stockage existe.
Ce que vous pouvez tester aujourd’hui
L’aperçu est utile pour tester une intégration contre le contrat prévu :
- la propriété app est vérifiée par le wrapper MCP ;
- les enregistrements base peuvent être créés et listés ;
- le mot de passe généré n’est pas renvoyé par les lectures métadonnées ultérieures ;
DATABASE_URLpeut être remis au producteur environnement app lorsque son jeton producteur est configuré ; et- l’app enregistre la référence base renvoyée.
Publier l’URL placeholder ne la rend pas utilisable. Retirez-la de l’environnement app avant un déploiement réel.
Outils MCP
| Outil | Comportement actuel |
|---|---|
add_app_database(app_id, engine='postgres') | Crée un enregistrement stub. Peut publier un DATABASE_URL placeholder. |
list_app_databases(app_id) | Renvoie métadonnées uniquement. Ne renvoie jamais le mot de passe. |
Vérifiez le statut renvoyé avant toute autre action :
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 réponse exacte peut aussi contenir des champs de connexion à usage unique. En aperçu ils pointent vers l’hôte stub et ne doivent pas servir d’identifiants pour une charge réelle.
Contrat REST
Les routes côté plateforme sont :
| Méthode | Chemin | Résultat |
|---|---|---|
POST | /api/app-infra/databases | Crée un enregistrement aperçu et renvoie des données de forme connexion à usage unique. |
GET | /api/app-infra/databases/{db_id} | Renvoie métadonnées sans mot de passe. |
GET | /api/app-infra/databases?app_id={app_id} | Liste métadonnées, filtrées par app optionnellement. |
Ces routes de niveau inférieur servent surtout à l’intégration interne. Préférez l’outil MCP limité au propriétaire sauf développement plateforme.
Avant de pouvoir appeler Postgres géré prêt
Une version capable production exige des preuves pour tout ce qui suit :
- service Postgres joignable et provisionnement locataire réel ;
- isolation réseau entre apps ;
- rotation et déprovisionnement d’identifiants ;
- exercices backup et restore avec résultats de reprise mesurés ;
- limites ressources, surveillance et alertes d’échec ; et
- test applicatif bout en bout qui écrit des données, redéploie et les relit.
Jusqu’à ce que ces vérifications passent dans l’environnement cible, apportez votre propre base et placez sa vraie chaîne de connexion dans Variables d’environnement app.