# Bases dans le cluster ou managées

> Les deux modes d'hébergement d'une base, leurs versions, leurs offres et leurs régions, et comment choisir.

Chaque base Wakastart tourne dans l'un de deux modes : **dans le cluster**, comme un conteneur à côté de vos services, ou **managée**, comme un service de base de données OVHcloud. Le mode se fixe par défaut dans la déclaration de la base, et chaque environnement peut le surcharger.

## Définition

| | Dans le cluster | Managée |
|---|---|---|
| Libellé dans la console | `IN_CLUSTER` (déclaration), **In-Cluster** (instance) | `MANAGED` (déclaration), **Managed** (instance) |
| Où tourne la base | un conteneur dans l'espace de l'environnement, sur le cluster Wakastart | un service OVHcloud Public Cloud Databases dédié à l'instance |
| Qui l'exploite | Wakastart, comme vos services | OVHcloud pour le moteur, Wakastart pour la création, les comptes et la suppression |
| Connexion | réseau interne du cluster, sans TLS (`ssl_mode` vaut `disable`) | TLS exigé (`ssl_mode` vaut `require`, ou `REQUIRED` pour MySQL) |
| Mode par défaut | oui | non |

Le mode ne change pas la façon dont vos services reçoivent les identifiants : dans les deux cas, ils arrivent par les mêmes [variables de connexion](/v1.0/bases-de-donnees/identifiants-de-connexion).

## Versions proposées

| Moteur | Dans le cluster | Managée | Managée, champ **Version** vide |
|---|---|---|---|
| PostgreSQL | 16 | `14`, `15` ou `16` | 16 |
| MySQL | 8.0 | `8` | 8 |
| MongoDB | 7, en replica set à un nœud (`rs0`) | `6.0` ou `7.0` | 7.0 |
| Valkey | 8.0 | `8.0` ou `8.1` | 8.1 |

Dans le cluster, la version est fixée par moteur : le champ **Version** n'a pas d'effet. En mode managé, saisissez la version exactement sous la forme du tableau, par exemple `7.0` et non `7` pour MongoDB.

## Offres et régions des bases managées

| Moteur | Offres (champ **Plan**) | Offre appliquée si le champ est vide |
|---|---|---|
| PostgreSQL, MySQL, Valkey | `essential`, `business`, `enterprise` | `essential` |
| MongoDB | `discovery`, `production`, `advanced` | `production` |

Pour MongoDB, `essential` et `business` sont convertis en `production`, et `enterprise` en `advanced`. Une base MongoDB managée compte toujours au moins trois nœuds.

La région se saisit en code OVHcloud, en minuscules : `gra` (Gravelines, par défaut), `sbg` (Strasbourg), `bhs` (Beauharnois), `waw` (Varsovie), `de` ou `uk`.

## Comment ça marche

**Dans le cluster**, Wakastart déploie le moteur dans l'espace Kubernetes de l'environnement, avec un volume persistant (`10Gi` par défaut, réglable par le champ **Taille stockage par défaut** de la déclaration). La base tourne sur un seul réplica : quand vous changez ses ressources, l'ancien conteneur s'arrête avant que le nouveau démarre, et la base est injoignable pendant ce redémarrage. Ses CPU et mémoire se règlent depuis la console, jusqu'à `2000m` et `8Gi`.

**En mode managé**, Wakastart commande la base à OVHcloud, crée la base applicative et les deux comptes, puis récupère l'hôte et le port attribués. La création prend plus longtemps qu'en mode cluster : comptez plusieurs minutes, parfois quelques dizaines. Le gabarit de machine ne se règle pas depuis la console ; seule la taille du disque se choisit, 50 Go par défaut.

Dans les deux modes, la base passe par les mêmes [statuts](/v1.0/bases-de-donnees/cycle-de-vie) et se sauvegarde de la même façon avec les [sauvegardes Wakastart](/v1.0/sauvegardes).

## Exemples

- **Une application en cours de développement** : PostgreSQL dans le cluster pour `dev` et `staging`, prête en quelques minutes, ressources réduites.
- **La même application en production** : la déclaration reste en mode cluster, et l'instance de `prod` est provisionnée en mode **Managed**, version `16`, offre `business`, région `gra`.
- **Un cache de sessions** : Valkey dans le cluster dans tous les environnements, sans sauvegarde planifiée.

## Comparaison : quand choisir quoi

| Critère | Dans le cluster | Managée |
|---|---|---|
| Délai de création | quelques minutes | plusieurs minutes à quelques dizaines de minutes |
| Choix de la version | non, version fixe par moteur | oui |
| Choix de l'offre et de la région | non | oui |
| Connexion chiffrée | non, trafic interne au cluster | oui, TLS exigé |
| CPU et mémoire réglables | oui, depuis la console | non |
| Interruption lors d'un changement de ressources | oui, le temps du redémarrage | sans objet |
| Usage conseillé | dev, staging, caches, tests | production, données critiques |

Nous recommandons le mode managé pour les données de production, et le mode cluster pour tout ce qui peut être recréé.

## Pour aller plus loin

- [Déclarer une base](/v1.0/bases-de-donnees/declarer-une-base)
- [Provisionner une base dans un environnement](/v1.0/bases-de-donnees/provisionner-une-base)
- [Identifiants de connexion](/v1.0/bases-de-donnees/identifiants-de-connexion)
- [Référence des écrans et des champs](/v1.0/bases-de-donnees/reference)
