Référence des bases de données
Écrans, champs, valeurs acceptées, statuts et entrées de configuration d'une base de données Wakastart.
Les bases de données se pilotent depuis la console Wakastart. Il n'existe pas d'API publique d'hébergement pour les clients.
Écrans
| Écran | Chemin dans la console | Droit requis à l'écran |
|---|---|---|
| Déclarations | app › Architecture › Dépendances, onglet Bases de données (N) | « Infra Client » |
| Nouvelle déclaration | Dépendances › Nouvelle base | « Infra Client » |
| Instances d'un environnement | app › Environnements › environnement › onglet Databases | « Infra Client » |
| Nouvelle instance | onglet Databases › Nouvelle instance | « Provisionner une base de données » |
| Détail d'une instance | clic sur une ligne de l'onglet Databases ; onglets Vue générale et Backups | « Infra Client » |
| Modifier les ressources | détail › carte Ressources › Modifier (bases dans le cluster) | « Provisionner une base de données » |
| Supprimer une instance | corbeille de l'onglet Databases | « Supprimer une base de données » |
Dans un environnement de production, chaque action demande en plus le droit « Accès infrastructure en production ».
Déclaration d'une base
| Champ à l'écran | Obligatoire | Valeurs acceptées | Par défaut | Modifiable ensuite |
|---|---|---|---|---|
| Nom * | oui | 100 caractères au plus | — | non, depuis la console |
| Shortname * | oui | 12 caractères au plus, ^[a-z][a-z0-9-]*$, unique dans l'application | dérivé du nom | non |
| Type de base de données * | oui | PostgreSQL, MySQL, MongoDB, Valkey (Redis) | PostgreSQL | non |
| Mode par défaut | non | IN_CLUSTER, MANAGED | IN_CLUSTER | non, depuis la console |
| Version par défaut | non | voir versions ; sans effet dans le cluster | selon le moteur | non, depuis la console |
Plan par défaut (MANAGED) | non | voir offres | essential | non, depuis la console |
Région par défaut (MANAGED) | non | gra, sbg, bhs, waw, de, uk | gra | non, depuis la console |
Taille disque par défaut (GB) (MANAGED) | non | nombre entier de Go | 50 | non, depuis la console |
Taille stockage par défaut (IN_CLUSTER) | non | quantité Kubernetes, par exemple 10Gi | 10Gi | non, depuis la console |
Instance dans un environnement
| Champ à l'écran | Valeurs acceptées | Vide |
|---|---|---|
| Définition * | une déclaration sans instance dans l'environnement | — |
| Mode | In-Cluster, Managed | mode de la déclaration |
| Version (managée) | voir versions | version de la déclaration, sinon défaut du moteur |
| Plan (managée) | voir offres | offre de la déclaration, sinon essential |
| Région (managée) | code OVHcloud en minuscules | région de la déclaration, sinon gra |
| Taille disque (Go) (managée) | nombre entier de Go | taille de la déclaration, sinon 50 |
Une seule instance active par déclaration et par environnement.
Ressources (bases dans le cluster)
| Champ | Format | Maximum | Vide |
|---|---|---|---|
| CPU demandé, CPU maximum | entier + m | 2000m | valeur par défaut du chart |
| Mémoire demandée, Mémoire maximum | nombre + Mi ou Gi | 8Gi | valeur par défaut du chart |
Versions et offres
| Moteur | Dans le cluster | Versions managées | Offres managées |
|---|---|---|---|
| PostgreSQL | 16 | 14, 15, 16 (défaut 16) | essential, business, enterprise |
| MySQL | 8.0 | 8 | essential, business, enterprise |
| MongoDB | 7 | 6.0, 7.0 (défaut 7.0) | discovery, production, advanced |
| Valkey | 8.0 | 8.0, 8.1 (défaut 8.1) | essential, business, enterprise |
Statuts
| Code | Libellé | Terminal |
|---|---|---|
PENDING | En attente | non |
PROVISIONING | Provisionnement | non |
READY | Prêt | non |
FAILED | Échec | non, nouvel essai automatique |
DESTROYING | Suppression | non |
DESTROYED | Supprimé | oui |
Santé : Sain, Non sain, Inconnu, N/A. Voir Cycle de vie d'une base de données.
Propriétés affichées sur la page d'une instance
Moteur, Version, Mode, Région, Host, Port, Plan, Taille disque, Slot actif, Instance ID, Créé le.
Entrées de configuration générées
Pour une base de shortname maindb, l'onglet Configuration de l'environnement, filtre Base, contient :
| Clé | Champ | Valeur visible |
|---|---|---|
MAINDB_URL | url | non (sensible) |
MAINDB_HOST | host | oui |
MAINDB_PORT | port | oui |
MAINDB_DATABASE | database | oui |
MAINDB_USERNAME | username | oui |
MAINDB_PASSWORD | password | non (sensible) |
MAINDB_SSL_MODE | ssl_mode | oui |
Ports par défaut dans le cluster : 5432 (PostgreSQL), 3306 (MySQL), 27017 (MongoDB), 6379 (Valkey).
Limites
| Élément | Valeur |
|---|---|
| Instances par déclaration et par environnement | 1 |
| Comptes applicatifs par instance | 2 (primary, secondary) |
| Réplicas d'une base dans le cluster | 1 |
| Nœuds d'une base MongoDB managée | 3 au minimum |
| Durée maximale de création avant échec | 60 minutes |
| Délai entre deux essais après échec | de 30 secondes à 15 minutes |
| Rafraîchissement des identifiants dans les conteneurs | 5 minutes |