# 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.

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](/v1.0/bases-de-donnees/dans-le-cluster-ou-managee).

## Déclarer la base

::::steps
### 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](/v1.0/bases-de-donnees/reference#déclaration-dune-base).

### 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](/v1.0/bases-de-donnees/depannage).

## Voir aussi

- [Provisionner une base dans un environnement](/v1.0/bases-de-donnees/provisionner-une-base)
- [Bases dans le cluster ou managées](/v1.0/bases-de-donnees/dans-le-cluster-ou-managee)
- [Applications et environnements](/v1.0/applications)
