Aller au contenu

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.

ConceptDéveloppeur
Voir en Markdown

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, primary et secondary, 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

ChampContenuExemple (PostgreSQL dans le cluster)
urlURL de connexion complète, mot de passe incluspostgresql://monapp_maindb_primary:…@maindb.wakapp-ab12cd-dev.svc.cluster.local:5432/monapp_maindb
hostnom d'hôtemaindb.wakapp-ab12cd-dev.svc.cluster.local
portport5432
databasenom de la base applicativemonapp_maindb
usernamecompte applicatifmonapp_maindb_primary
passwordmot de passe(32 caractères aléatoires)
ssl_modeexigence TLSdisable dans le cluster, require en mode managé (REQUIRED pour MySQL)

Le schéma de l'URL dépend du moteur et du mode :

MoteurDans le clusterManagée
PostgreSQLpostgresql://…:5432/<base>postgresql://…:<port>/<base>
MySQLmysql://…:3306/<base>mysql://…:<port>/<base>
MongoDBmongodb://…:27017/<base>?authSource=admin&replicaSet=rs0&directConnection=truemongodb+srv://…/<base>?authSource=admin
Valkeyredis://…:6379/0rediss://…:<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émentDans le clusterManagée
Base applicative<app>_<base>, par exemple monapp_maindbws<app>_<base>, par exemple wsmonapp_maindb
Comptes<app>_<base>_primary, <app>_<base>_secondaryws<app>_<base>_primary, ws<app>_<base>_secondary
Hôte<base>.wakapp-<identifiant de l'app>-<environnement>.svc.cluster.localattribué 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

Chargement du schéma…
  1. À 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.
  2. 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.
  3. Les entrées …_URL et …_PASSWORD sont sensibles : leur valeur n'est pas affichée. Les entrées sont en Lecture seule (auto-générée).
  4. Dans la configuration d'un service, vous reliez une variable attendue, par exemple DATABASE_URL, à l'une de ces entrées.
  5. 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.

Pour aller plus loin