Connecter un service à une base
Reliez les variables d'un service aux identifiants générés pour une base, puis lisez-les dans votre code.
- Accès requis
- Profil Infra (droit « Infra Client »)
- Durée
- 5 min
Votre code ne connaît ni l'hôte ni le mot de passe de sa base. Il lit une variable d'environnement, par exemple DATABASE_URL, que Wakastart remplit à partir des identifiants de la base dans chaque environnement. Ce guide relie cette variable à la base, puis montre comment la lire.
Avant de commencer
- La base est Prête dans l'environnement : voir Provisionner une base.
- La définition du service déclare la variable attendue, par exemple
DATABASE_URL. La déclaration des variables est décrite dans Variables et secrets. - Le service est déployé dans l'environnement : voir Services.
Relier la variable
Ouvrir le service
- Dans le menu latéral, sous le nom de votre application, cliquez sur Environnements, puis ouvrez l'environnement.
- Dans l'onglet Services, cliquez sur le service.
Ouvrir sa configuration
Cliquez sur l'onglet Configuration du service (N).
Chaque variable consommée par le service s'affiche avec une liste de choix.
Choisir l'identifiant de la base
Pour la variable DATABASE_URL, ouvrez la liste Choisir une valeur... et sélectionnez l'entrée <BASE>_URL de votre base, par exemple MAINDB_URL.
Pour des champs séparés, reliez de la même façon …_HOST, …_PORT, …_DATABASE, …_USERNAME, …_PASSWORD et …_SSL_MODE.
Enregistrer
Cliquez sur Enregistrer la configuration.
Le message Configuration enregistrée s'affiche. Wakastart redéploie le service avec ses nouvelles variables.
Répétez la liaison dans chaque environnement : la valeur MAINDB_URL de dev pointe vers la base de dev, celle de prod vers la base de prod.
Lire les identifiants dans votre code
La variable contient une URL complète. L'exemple suivant, en TypeScript avec le client pg, active TLS quand la base l'exige, ce qui est le cas en mode managé. Il suppose que la variable DATABASE_SSL_MODE est reliée à MAINDB_SSL_MODE.
import { Pool } from "pg";
const sslRequired = ["require", "REQUIRED"].includes(process.env.DATABASE_SSL_MODE ?? "");
const pool = new Pool({
connectionString: process.env.DATABASE_URL,
ssl: sslRequired ? { rejectUnauthorized: false } : undefined,
});
const { rows } = await pool.query("select current_database() as base, current_user as compte");
console.log(rows[0]);Attention
rejectUnauthorized: false chiffre la connexion mais ne vérifie pas le certificat de la base. En production, fournissez le certificat de l'autorité de la base au client (ssl: { ca: <certificat>, rejectUnauthorized: true }) pour que la connexion refuse un serveur qui n'est pas le vôtre.
Résultat attendu dans les logs du service :
{ base: 'monapp_maindb', compte: 'monapp_maindb_primary' }En mode managé, la base et le compte portent le préfixe ws : wsmonapp_maindb, wsmonapp_maindb_primary.
Conseil
Avec Prisma 7, l'URL de connexion ne s'écrit plus dans schema.prisma : la CLI la lit dans prisma.config.ts, et le client la reçoit par un adaptateur.
// prisma.config.ts : utilisé par les commandes prisma (migrate, generate…)
import { defineConfig, env } from "prisma/config";
export default defineConfig({
schema: "prisma/schema.prisma",
datasource: { url: env("DATABASE_URL") },
});// À l'exécution : le client passe par l'adaptateur PostgreSQL (@prisma/adapter-pg)
import { PrismaClient } from "@prisma/client";
import { PrismaPg } from "@prisma/adapter-pg";
const prisma = new PrismaClient({
adapter: new PrismaPg({ connectionString: process.env.DATABASE_URL }),
});Le bloc datasource de schema.prisma ne garde que provider. Avec Prisma 6, l'URL s'écrit encore dans ce bloc : url = env("DATABASE_URL"). Pour MongoDB dans le cluster, l'URL contient déjà replicaSet=rs0, que Prisma exige pour les transactions.
Vérifier le résultat
- Dans l'onglet Configuration du service (N), la variable affiche son lien vers l'entrée de la base.
- Dans l'onglet Logs du service, aucune erreur de connexion n'apparaît après le redémarrage.
Dépannage
- La variable est absente du conteneur : la base n'était pas encore Prête au déploiement. Une entrée qui ne peut pas être résolue est ignorée. Attendez le statut Prêt, puis redéployez le service.
- Connexion refusée par une base managée : la base exige TLS. Activez-le dans votre client quand
…_SSL_MODEvautrequireouREQUIRED, comme dans l'exemple.