# Bases de données

> Créez des bases PostgreSQL, MySQL, MongoDB ou Valkey pour votre application, dans le cluster Wakastart ou managées chez OVHcloud.

Wakastart crée et maintient les bases de données de votre application. Vous déclarez une base une fois dans l'[architecture](/v1.0/glossaire#architecture) de l'application, puis vous la provisionnez dans chaque [environnement](/v1.0/glossaire#environnement) : dev, staging, prod. Wakastart génère les comptes et les mots de passe, et les transmet à vos services sans que vous ayez à les manipuler.

Quatre moteurs sont proposés : **PostgreSQL**, **MySQL**, **MongoDB** et **Valkey** (compatible Redis).

## Comment ça marche

Une base existe à deux niveaux. La déclaration, dans l'architecture, fixe le moteur et les valeurs par défaut. L'[instance](/v1.0/glossaire#instance), dans un environnement, est la base réelle : elle hérite des valeurs par défaut et peut en surcharger certaines. Quand l'instance est prête, Wakastart dépose ses identifiants dans la configuration de l'environnement. Il vous reste à relier les variables de vos services à ces identifiants.

```mermaid
flowchart LR
  D["Déclaration<br/>Architecture › Dépendances<br/>moteur, valeurs par défaut"]
  subgraph ENV["Environnement (ex. prod)"]
    I["Instance de base<br/>onglet Databases"]
    C["Identifiants générés<br/>MAINDB_URL, MAINDB_HOST…<br/>onglet Configuration"]
    S["Service<br/>variable DATABASE_URL"]
  end
  D -- "Nouvelle instance" --> I
  I -- "statut Prêt" --> C
  C -- "liaison" --> S
```

1. Vous déclarez la base dans **Architecture › Dépendances** (moteur, mode par défaut).
2. Dans un environnement, vous provisionnez une instance depuis l'onglet **Databases**.
3. Wakastart crée la base, deux comptes applicatifs et leurs mots de passe.
4. Les sept champs de connexion apparaissent dans l'onglet **Configuration** de l'environnement, filtre **Base**.
5. Dans la configuration du service, vous reliez une variable (par exemple `DATABASE_URL`) au champ voulu.

## Choisissez votre mode

::::cards{cols=2}
:::card{title="Dans le cluster" href="/v1.0/bases-de-donnees/dans-le-cluster-ou-managee" icon="Container"}
Un conteneur dans le cluster Wakastart, à côté de vos services. Prêt en quelques minutes, ressources réglables. Adapté au développement et aux environnements de test.
:::
:::card{title="Managée" href="/v1.0/bases-de-donnees/dans-le-cluster-ou-managee" icon="Cloud"}
Une base OVHcloud Public Cloud Databases, connexion chiffrée en TLS, version et offre au choix. Adaptée à la production.
:::
::::

Le mode se choisit à la déclaration et peut être surchargé environnement par environnement. Le [comparatif des modes](/v1.0/bases-de-donnees/dans-le-cluster-ou-managee) détaille les versions, les offres et les régions.

## Commencer

::::cards{cols=3}
:::card{title="Déclarer une base" href="/v1.0/bases-de-donnees/declarer-une-base" icon="Layers"}
Ajouter une base à l'architecture de l'application.
:::
:::card{title="Provisionner une base" href="/v1.0/bases-de-donnees/provisionner-une-base" icon="Database"}
Créer la base réelle dans un environnement.
:::
:::card{title="Connecter un service" href="/v1.0/bases-de-donnees/connecter-un-service" icon="Cable"}
Transmettre les identifiants à votre code par une liaison de variable.
:::
::::

## Fonctionnalités

::::cards{cols=3}
:::card{title="Identifiants générés" href="/v1.0/bases-de-donnees/identifiants-de-connexion" icon="KeyRound"}
Deux comptes par base, sept champs de connexion, aucun mot de passe à saisir ni à recopier.
:::
:::card{title="Ressources réglables" href="/v1.0/bases-de-donnees/modifier-les-ressources" icon="Gauge"}
CPU et mémoire d'une base dans le cluster, jusqu'à 2 cœurs et 8 Gio.
:::
:::card{title="Santé en continu" href="/v1.0/supervision" icon="Activity"}
Une pastille Sain, Dégradé ou Non sain pour chaque base, et une vérification à la demande.
:::
:::card{title="Sauvegardes" href="/v1.0/sauvegardes" icon="ArchiveRestore"}
Sauvegardes manuelles ou planifiées, restauration en place ou dans une nouvelle base.
:::
:::card{title="Cycle de vie suivi" href="/v1.0/bases-de-donnees/cycle-de-vie" icon="RefreshCw"}
Des statuts lisibles, de la création à la suppression, et une reprise automatique après échec.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Variables et secrets" href="/v1.0/variables-et-secrets" icon="Lock"}
Relier les variables d'un service aux valeurs de l'environnement.
:::
:::card{title="Sauvegardes" href="/v1.0/sauvegardes" icon="ArchiveRestore"}
Protéger les données de vos bases.
:::
:::card{title="Stockage objet" href="/v1.0/stockage" icon="HardDrive"}
Stocker les fichiers de votre application dans des buckets compatibles S3.
:::
::::

## Ressources

- [Référence des écrans et des champs](/v1.0/bases-de-donnees/reference)
- [Liste de contrôle avant la production](/v1.0/bases-de-donnees/liste-de-controle)
- [Résoudre les problèmes de bases de données](/v1.0/bases-de-donnees/depannage)
- [Limites et quotas](/v1.0/limites)
