Comment modifier les ressources d'un cluster
Ce guide explique comment ajuster un cluster MariaDB existant depuis la console Hikube : taille du disque, version et accès externe.
Prérequis
- Un cluster MariaDB existant dans votre projet
- Des quotas de projet suffisants pour la nouvelle configuration
- Pour l'onglet API : une clé d'API
admindu projet et les variablesHIKUBE_API,HIKUBE_API_KEYetPROJECT_ID(voir Préparer l'environnement) ; les exemples utilisentcurletjq
Ce qui est modifiable
| Paramètre | Modifiable après création |
|---|---|
| Version MariaDB | Oui, vers une version supérieure uniquement |
| Taille du disque (Go) | Oui, à la hausse uniquement |
| Accès externe | Oui |
| Préconfiguration (Preset) | Non, « La préconfiguration ne peut pas être modifiée après création » |
| Nombre de réplicas | Non, « Le mode ne peut pas être modifié après création » |
Pour changer la préconfiguration (CPU et mémoire) ou le nombre de réplicas d'un cluster existant, contactez le support.
Étapes
1. Ouvrir le formulaire de modification
- Console
- API
- Ouvrez DB & Messaging → MariaDB.
- Ouvrez le cluster, puis cliquez sur Modifier (ou utilisez Actions → Modifier dans la liste).
La page Modifier MariaDB affiche la carte Paramètres du cluster et l'impact sur les quotas du projet.
Récupérez la configuration actuelle du cluster :
curl -sS "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '{version, replicas, size, external, preset}'
2. Ajuster les paramètres
- Console
- API
- Taille du disque (Go) : saisissez la nouvelle capacité, au moins égale à la taille actuelle. Une valeur inférieure affiche « La taille du disque ne peut pas être réduite : N Go minimum. » et n'est pas enregistrée.
- Version MariaDB : sélectionnez la version cible. Le formulaire ne propose que la version actuelle et les versions supérieures : MariaDB ne prend pas en charge la rétrogradation.
- Accès externe : activez ou désactivez l'exposition sur l'Internet public.
Quand vous changez la version, l'avertissement « Les instances du cluster vont redémarrer » s'affiche : le changement redémarre les instances du cluster dès l'enregistrement, et une version mise à niveau ne peut plus être abaissée. Planifiez-le en dehors des périodes de forte activité.
La modification passe par PATCH /mariadb/v1alpha1/projects/{projectId}/clusters/{name}, une mise à jour partielle : seuls les champs envoyés changent. Le corps accepte quatre champs :
| Champ | Règle |
|---|---|
version | v10.6, v10.11, v11.4 ou v11.8 ; une version inférieure à la version actuelle est refusée (code 110203) |
size | 1 à 4096 Go, au moins la taille actuelle : une taille inférieure est refusée (code 110204) |
replicas | Un passage entre standalone (1) et cluster (2 à 8) est refusé (400, code 110201) |
external | true ou false |
La préconfiguration (preset) n'est pas modifiable par l'API. Par exemple, pour passer le disque à 20 Go :
curl -sS -X PATCH "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"size": 20}'
3. Enregistrer
- Console
- API
Cliquez sur Sauvegarder. Le message « Cluster mis à jour » confirme la prise en compte. Si la nouvelle configuration dépasse les quotas du projet, le bouton reste inactif.
La réponse 200 décrit le cluster avec ses nouvelles valeurs. Si external passe à true alors qu'aucune adresse IP publique n'est disponible, la requête est refusée (400). Vérifiez au préalable que la nouvelle configuration tient dans les quotas du projet.
Augmentez la taille du disque avant qu'il ne soit plein. Pour mesurer l'espace utilisé par base :
SELECT table_schema, ROUND(SUM(data_length + index_length) / 1024 / 1024, 1) AS size_mb
FROM information_schema.tables
GROUP BY table_schema;
Vérification
- Console
- API
La page du cluster affiche les nouvelles valeurs dans les cartes Version MariaDB et Taille allouée, et l'état de l'Accès externe dans la carte Connexion et réseau.
curl -sS "$HIKUBE_API/mariadb/v1alpha1/projects/$PROJECT_ID/clusters/demomariadb" \
-H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '{status, version, size, external, host}'
Les valeurs reflètent la nouvelle configuration, et status revient à ready une fois la mise à jour appliquée.
Pour aller plus loin
- Concepts MariaDB : réplication, préconfigurations, accès réseau
- Gérer les utilisateurs et bases de données