Identifiants de connexion
Les deux comptes applicatifs d'une base, les sept champs fournis à vos services, le nommage de la base et le chemin des identifiants jusqu'au conteneur.
Vous ne saisissez jamais de mot de passe de base de données dans Wakastart. À la création de chaque instance, la plateforme génère deux comptes applicatifs, les range dans le coffre de secrets de votre application et les expose à vos services sous forme de variables à relier.
Définition
Une instance de base reçoit :
- deux comptes applicatifs,
primaryetsecondary, chacun avec un mot de passe aléatoire de 32 caractères ; - pour chaque compte, sept champs de connexion ;
- une entrée de configuration par champ dans l'environnement, que vos services consomment par liaison.
Ces identifiants ne sont jamais affichés en clair dans la console, ni renvoyés par une API. Ils ne quittent le coffre que pour être injectés dans le conteneur d'un service qui les consomme.
Les sept champs
| Champ | Contenu | Exemple (PostgreSQL dans le cluster) |
|---|---|---|
url | URL de connexion complète, mot de passe inclus | postgresql://monapp_maindb_primary:…@maindb.wakapp-ab12cd-dev.svc.cluster.local:5432/monapp_maindb |
host | nom d'hôte | maindb.wakapp-ab12cd-dev.svc.cluster.local |
port | port | 5432 |
database | nom de la base applicative | monapp_maindb |
username | compte applicatif | monapp_maindb_primary |
password | mot de passe | (32 caractères aléatoires) |
ssl_mode | exigence TLS | disable dans le cluster, require en mode managé (REQUIRED pour MySQL) |
Le schéma de l'URL dépend du moteur et du mode :
| Moteur | Dans le cluster | Managée |
|---|---|---|
| PostgreSQL | postgresql://…:5432/<base> | postgresql://…:<port>/<base> |
| MySQL | mysql://…:3306/<base> | mysql://…:<port>/<base> |
| MongoDB | mongodb://…:27017/<base>?authSource=admin&replicaSet=rs0&directConnection=true | mongodb+srv://…/<base>?authSource=admin |
| Valkey | redis://…:6379/0 | rediss://…:<port>/0 |
En mode managé, le port est attribué par OVHcloud : lisez-le dans le champ port.
Nommage
Le nom de la base et des comptes est construit à partir de l'identifiant court de l'application et de celui de la base (le Shortname saisi à la déclaration) :
| Élément | Dans le cluster | Managée |
|---|---|---|
| Base applicative | <app>_<base>, par exemple monapp_maindb | ws<app>_<base>, par exemple wsmonapp_maindb |
| Comptes | <app>_<base>_primary, <app>_<base>_secondary | ws<app>_<base>_primary, ws<app>_<base>_secondary |
| Hôte | <base>.wakapp-<identifiant de l'app>-<environnement>.svc.cluster.local | attribué par OVHcloud |
Le nom de la base est le même dans tous les environnements : seuls l'hôte et les mots de passe changent. Ne codez aucun de ces noms en dur : lisez-les toujours dans les variables.
Comment ça marche
- À la création de l'instance, Wakastart génère les deux comptes et écrit leurs sept champs dans le coffre de secrets de l'application.
- Quand la base est prête, chaque champ apparaît dans l'onglet Configuration de l'environnement, filtre Base, sous une clé
<BASE>_<CHAMP>en majuscules :MAINDB_URL,MAINDB_HOST,MAINDB_PORT,MAINDB_DATABASE,MAINDB_USERNAME,MAINDB_PASSWORD,MAINDB_SSL_MODE. Un tiret dans le shortname devient un tiret bas. - Les entrées
…_URLet…_PASSWORDsont sensibles : leur valeur n'est pas affichée. Les entrées sont en Lecture seule (auto-générée). - Dans la configuration d'un service, vous reliez une variable attendue, par exemple
DATABASE_URL, à l'une de ces entrées. - Au déploiement, le conteneur reçoit la valeur sous forme de référence de secret Kubernetes, rafraîchie depuis le coffre toutes les 5 minutes.
Les variables reliées depuis la console portent les identifiants du compte primary. Le compte secondary est créé et synchronisé en même temps, mais il n'est pas proposé dans la configuration des services.
Exemples
- Un back NestJS avec Prisma : la définition du service déclare
DATABASE_URL; dans chaque environnement, la variable est reliée àMAINDB_URL. Le même code tourne en dev et en prod. - Un client qui veut les champs séparés : le service déclare
DB_HOST,DB_PORT,DB_NAME,DB_USER,DB_PASSWORD, reliés aux entrées…_HOST,…_PORT,…_DATABASE,…_USERNAME,…_PASSWORD.