Comment modifier la configuration d'un cluster RabbitMQ

Ce guide explique quels paramètres d'un cluster RabbitMQ peuvent être modifiés après sa création depuis la console Hikube, et comment procéder.

Prérequis

• Un cluster RabbitMQ créé dans votre projet
• Un quota de projet suffisant si vous augmentez la taille du disque
• Pour l'onglet API : une clé d'API admin du projet et les variables HIKUBE_API, HIKUBE_API_KEY et PROJECT_ID (voir Préparer l'environnement) ; les exemples utilisent curl et jq

Paramètres modifiables

Paramètre	Modifiable après création	Remarque
Version RabbitMQ	Oui	Version actuelle et versions supérieures parmi 4.2, 4.1, 4.0, 3.13
Taille du disque (Go)	Oui	Capacité par nœud, à la hausse uniquement, dans la limite du quota de stockage du projet
Accès externe	Oui	Voir Configurer l'accès externe
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 »

Étapes

Console

1. Ouvrir le formulaire de modification

1. Dans le menu DB & Messaging → RabbitMQ, cliquez sur le cluster.
2. Cliquez sur Modifier. Vous pouvez aussi ouvrir le menu d'actions du cluster dans la liste et choisir Modifier.

La page Modifier RabbitMQ affiche la carte Paramètres du cluster. Les champs Préconfiguration (Preset) et Nombre de réplicas y sont grisés.

2. Ajuster les paramètres

• Version RabbitMQ : sélectionnez la version cible. Le formulaire ne propose que la version actuelle et les versions supérieures.
• Taille du disque (Go) : saisissez la nouvelle capacité par nœud. La taille ne peut qu'augmenter : une valeur inférieure affiche « La taille du disque ne peut pas être réduite : N Go minimum. » et n'est pas enregistrée.
• Accès externe : activez ou désactivez l'interrupteur.

Changement de version

Quand vous changez la version, l'avertissement « Les instances du cluster vont redémarrer » s'affiche : une version mise à niveau ne peut plus être abaissée. Le changement de version recrée les nœuds RabbitMQ un par un : avec un seul réplica, le cluster est indisponible pendant le redémarrage (de l'ordre d'une à deux minutes) et les clients doivent se reconnecter. Les adresses des zones Interne et Externe ne changent pas. Testez le changement de version sur un cluster hors production avant de l'appliquer à un cluster de production, et vérifiez la compatibilité de vos clients avec la version cible.

3. Enregistrer

Cliquez sur Sauvegarder. Le message « Cluster mis à jour » confirme que les paramètres ont été appliqués et la console revient à la page de détail.

Si le quota du projet ne permet pas la nouvelle configuration, le bouton Sauvegarder reste inactif.

API

1. Lire la configuration actuelle

curl -sS "$HIKUBE_API/rabbitmq/v1alpha1/projects/$PROJECT_ID/clusters/rabbitdemo" \
  -H "X-Hikube-Api-Key: $HIKUBE_API_KEY" | jq '{version, size, external, replicas, preset}'

2. Envoyer la nouvelle configuration

PATCH /rabbitmq/v1alpha1/projects/{projectId}/clusters/{name} est une mise à jour partielle : seuls les champs envoyés changent, et l'accès externe reste tel quel s'il est absent. Le corps n'a pas de champ preset. Par exemple, pour passer le disque à 20 Go :

curl -sS -X PATCH "$HIKUBE_API/rabbitmq/v1alpha1/projects/$PROJECT_ID/clusters/rabbitdemo" \
  -H "X-Hikube-Api-Key: $HIKUBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"size": 20}'

• version : v3.13, v4.0, v4.1 ou v4.2 ; une version inférieure à la version actuelle est refusée (code 140203) ;
• size : taille du disque de chaque nœud, en Go ; comme dans la console, elle ne peut qu'augmenter : une taille inférieure est refusée (code 140204) ;
• replicas : l'API refuse de passer d'un nœud unique à plusieurs nœuds, ou l'inverse (code 140201).

La réponse décrit le cluster mis à jour. Le changement de version a les mêmes effets que depuis la console (voir l'avertissement de l'onglet Console).

Changer de preset ou de nombre de réplicas

La préconfiguration et le nombre de réplicas sont fixés à la création. Deux possibilités :

• Créer un nouveau cluster avec la configuration voulue, recréer les vhosts et utilisateurs, puis basculer vos applications ;
• Contacter le support : ces options ne sont pas proposées dans la console ; contactez le support.

Vérification

Sur la page de détail du cluster, la section Informations générales affiche la Version et la Taille du volume mises à jour, et la section Connexion l'état de l'Accès externe.

Pour aller plus loin

• Concepts : modes de déploiement et préconfigurations
• Gérer les vhosts et utilisateurs