ApsaraMQ for Kafka prend en charge les versions majeures 0,10.x, 2.2.0 et 2.6.2. Mettez à niveau vers une version plus récente pour bénéficier des améliorations de performances, des corrections de bugs et des nouvelles fonctionnalités, tout en maintenant la compatibilité avec vos SDK et opérations API existants.
Fonctionnement
ApsaraMQ for Kafka propose deux types de mises à niveau de version :
| Type de mise à niveau | Description | Exemple |
|---|---|---|
| Mise à niveau majeure | Passe l'instance d'une version majeure à une autre. | 0,10.x vers 2.x |
| Mise à jour mineure | Applique des correctifs de bugs et des optimisations de performances au sein de la même version majeure. | 2.2.0 vers 2.2.0 optimisé pour le noyau |
La version majeure 0,10.x inclut les versions mineures 0,10 et 0,10.2.
Processus de mise à niveau progressive
Lors d'une mise à niveau, les nœuds sont mis à niveau un par un selon une approche progressive. Chaque nœud est vérifié avant que le suivant ne commence. Dans des conditions normales, cette méthode garantit la disponibilité de l'instance tout au long du processus.
La séquence suivante décrit le déroulement de la mise à niveau :
Un seul nœud entame le processus de mise à niveau.
Le nœud est mis à niveau puis redémarré.
Le système vérifie que le nœud mis à niveau est sain avant de poursuivre.
Le nœud suivant est mis à niveau, et le processus se répète jusqu'à ce que tous les nœuds soient traités.
Étant donné que les nœuds sont mis à niveau de manière séquentielle, le cluster reste disponible. Les producteurs et les consommateurs peuvent subir de brèves déconnexions lors du redémarrage des nœuds individuels, mais les clients Kafka se reconnectent automatiquement et récupèrent les métadonnées actualisées.
Avant de commencer
Les mises à niveau sont gratuites et compatibles avec les SDK et les opérations API existants.
Assurez-vous que :
L'instance ApsaraMQ for Kafka est dans l'état Running
Votre client prend en charge la reconnexion automatique et peut gérer les brèves déconnexions (les clients Kafka prennent cette fonctionnalité en charge par défaut)
Recommandations
Testez la mise à niveau sur une instance hors production avant de mettre à niveau votre instance de production.
Planifiez les mises à niveau pendant les heures creuses afin de minimiser l'impact des brèves reconnexions.
Après une mise à niveau majeure, mettez à jour la version de votre client pour aligner les versions du client et du broker. Aucune mise à jour du client n'est nécessaire après une mise à jour mineure.
Le format de stockage des messages de la version 2.x diffère de celui de la version 0,10.x. Après une mise à niveau de la version 0,10.x vers la version 2.x, il est impossible de revenir à la version 0,10.x. Procédez avec prudence.
Les instances ApsaraMQ for Kafka nouvellement déployées utilisent la version 2.x. Les instances 0,10.x existantes continuent de fonctionner comme prévu.
Durée estimée de la mise à niveau
La durée de la mise à niveau dépend de la spécification de calcul de l'instance.
Pour les instances utilisant la spécification alikafka.hr.30xlarge ou alikafka.hw.30xlarge, ou une spécification inférieure :
| Type de mise à niveau | Durée estimée |
|---|---|
| Mise à niveau majeure | ~25 minutes |
| Mise à jour mineure | ~15 minutes |
Mettre à niveau une instance
Connectez-vous à la console ApsaraMQ for Kafka. Dans la section Resource Distribution de la page Overview, sélectionnez la région où réside l'instance.
Sur la page Instances, cliquez sur le nom de l'instance.
-
Dans la section Basic Information de la page Instance Details, lancez la mise à niveau :
Pour effectuer une mise à niveau majeure, cliquez sur Major Version Upgrade à côté de Major Version.
Pour effectuer une mise à jour mineure, cliquez sur Minor Version Update à côté de Minor Version.
-
Dans le panneau qui s'affiche, suivez les étapes ci-dessous :
Lisez le contenu de la section Read Before Upgrade.
Saisissez votre nom dans le champ Emergency Contact.
Saisissez votre numéro de téléphone d'urgence dans le champ Emergency Contact Number.
Sélectionnez l'heure de début de la mise à niveau dans le champ Started At.
Cliquez sur Confirm.
Après avoir cliqué sur OK, l'instance est mise à niveau immédiatement ou à l'heure planifiée dans un délai de sept jours.
Comportement attendu pendant la mise à niveau
Pendant la mise à niveau, vous pouvez observer les comportements suivants. Ces effets sont temporaires et disparaissent une fois la mise à niveau terminée.
| Comportement | Détails |
|---|---|
| Messages de déconnexion du client | Des messages d'erreur indiquant que le client est déconnecté d'un nœud peuvent apparaître dans les journaux de l'application. Le client se reconnecte automatiquement et récupère les dernières métadonnées. Aucune intervention manuelle n'est requise. |