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.
- Accès requis
- Profil Infra (droit « Infra Client »)
- Durée
- 3 min
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
- Dans Nom *, saisissez un nom lisible, par exemple
Base principale. - Vérifiez le Shortname * proposé à partir du nom, par exemple
baseprincipa, et remplacez-le si besoin par un identifiant plus parlant, par exemplemaindb.
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) :
- Dans Mode par défaut, choisissez
IN_CLUSTERouMANAGED. Sans choix, la base sera créée dans le cluster. - Si vous avez choisi
MANAGED, renseignez au besoin Version par défaut (par exemple16), Plan par défaut (par exempleessential), Région par défaut (par exemplegra) et Taille disque par défaut (GB) (50 si vide). - Si vous avez choisi
IN_CLUSTER, renseignez au besoin Taille stockage par défaut, par exemple20Gi.
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.