Aller au contenu

Déclarer une base dans l'architecture

Ajoutez une base de données à l'architecture de votre application, avec son moteur et ses valeurs par défaut pour tous les environnements.

GuideDéveloppeur
Accès requis
Profil Infra (droit « Infra Client »)
Durée
3 min
Voir en Markdown

Déclarez une base une seule fois, au niveau de l'application. La déclaration fixe le moteur et les valeurs par défaut que chaque environnement reprendra quand vous y provisionnerez la base. Elle ne crée encore aucune base réelle.

Avant de commencer

  • Votre application existe dans la console. Elle est créée par Wakastart : contactez-nous pour en ouvrir une.
  • Vous voyez les entrées Architecture, Environnements et Backups sous le nom de l'application, dans le menu latéral.
  • Vous avez choisi le moteur et le mode par défaut. En cas de doute, lisez Bases dans le cluster ou managées.

Déclarer la base

Ouvrir les dépendances de l'application

Dans le menu latéral, sous le nom de votre application, cliquez sur Architecture, puis dans la colonne Infrastructure, sur Dépendances.

La page Dépendances s'ouvre sur l'onglet Bases de données (N).

Créer la déclaration

Cliquez sur Nouvelle base.

La page Nouvelle base de données s'affiche.

Nommer la base

  1. Dans Nom *, saisissez un nom lisible, par exemple Base principale.
  2. Vérifiez le Shortname * proposé à partir du nom, par exemple baseprincipa, et remplacez-le si besoin par un identifiant plus parlant, par exemple maindb.

Le shortname compte 12 caractères au plus, commence par une lettre et ne contient que des minuscules, des chiffres et des tirets. Il ne pourra plus être modifié : il sert à nommer la base, ses comptes et ses variables (MAINDB_URL, MAINDB_HOST…).

Choisir le moteur

Dans Type de base de données *, choisissez PostgreSQL, MySQL, MongoDB ou Valkey (Redis).

Le moteur ne pourra plus être modifié.

Fixer les valeurs par défaut

Dans Paramètres par défaut (optionnel) :

  1. Dans Mode par défaut, choisissez IN_CLUSTER ou MANAGED. Sans choix, la base sera créée dans le cluster.
  2. Si vous avez choisi MANAGED, renseignez au besoin Version par défaut (par exemple 16), Plan par défaut (par exemple essential), Région par défaut (par exemple gra) et Taille disque par défaut (GB) (50 si vide).
  3. Si vous avez choisi IN_CLUSTER, renseignez au besoin Taille stockage par défaut, par exemple 20Gi.

Laissez un champ vide pour appliquer la valeur par défaut de Wakastart. Les valeurs acceptées sont listées dans la référence.

Enregistrer

Cliquez sur Créer.

Le message Base de données créée s'affiche et vous revenez sur la page Dépendances.

Vérifier le résultat

Sur la page Dépendances, onglet Bases de données (N), la base apparaît avec son Nom, son Shortname, son moteur (colonne Engine), sa Version et son Mode.

La base n'existe encore dans aucun environnement. Provisionnez-la maintenant dans chaque environnement où vous en avez besoin.

Dépannage

  • Le message « Format invalide » s'affiche : le shortname ne respecte pas le format. Il doit commencer par une lettre et ne contenir que des minuscules, des chiffres et des tirets.
  • Le message « Impossible de créer la base de données » s'affiche : une base porte déjà ce shortname dans l'application. Choisissez-en un autre.

Autres cas : Résoudre les problèmes de bases de données.

Voir aussi