PostgreSQL
Prérequis PostgreSQL intégré et Postgres géré
Le chart Helm intègre PostgreSQL 18 avec pgvector par défaut (infra.db.enabled: true). Aucune base de données externe n'est requise pour les déploiements standard ; l'instance intégrée pré-crée toutes les bases de données dont les services activés ont besoin.
Apporter votre propre Postgres géré
Si vous préférez une instance gérée (RDS, Cloud SQL, Azure Database for PostgreSQL, Supabase, Neon, CloudNativePG, …), définissez infra.db.enabled: false et pré-provisionnez les éléments suivants avant d'exécuter helm install. Les Jobs de migration du chart planteront lors de la première installation sinon.
| Exigence | Remarques |
|---|---|
| Version | PostgreSQL 15 ou ultérieur |
| Extension | pgvector doit être installable. La plupart des fournisseurs gérés la proposent : RDS ≥ 15.3, Cloud SQL 15+, Azure Flexible Server avec azure.extensions=VECTOR, Supabase, Neon. |
Bases de données à pré-créer. Une par composant activé. Chaque composant est activé par défaut dans le chart, donc planifiez les cinq sauf si vous en avez désactivé certains :
| Base de données | Requise quand | pgvector ? |
|---|---|---|
auth | toujours | oui |
agentic | toujours | oui |
analytics | analytics.enabled: true (par défaut) | non |
cortex (ou cortex.database.name) | cortex.enabled: true (par défaut) | oui |
ontology (ou apiOntology.database.name) | apiOntology.enabled: true (par défaut) | non |
Appliquez ceci sur votre Postgres géré avant helm install :
CREATE DATABASE auth;
CREATE DATABASE agentic;
CREATE DATABASE analytics; -- if analytics.enabled (default)
CREATE DATABASE cortex; -- if cortex.enabled (default)
CREATE DATABASE ontology; -- if apiOntology.enabled (default)
\c auth
CREATE EXTENSION IF NOT EXISTS vector;
\c agentic
CREATE EXTENSION IF NOT EXISTS vector;
\c cortex
CREATE EXTENSION IF NOT EXISTS vector;Consultez Postgres géré (BYO Database) pour les notes par fournisseur, les valeurs Helm infra.db.external.* correspondantes et les conseils de connection pooling.