Pour les scénarios de migration vers le cloud et de test, activez la création automatique de topics afin de les créer par programmation sans utiliser la console.
Prérequis
Vous avez acheté et déployé une instance Message Queue for Apache Kafka qui répond aux exigences suivantes :
|
Élément |
Description |
|
Status |
Running |
|
Version |
La version majeure est 2.2.0 ou ultérieure, et la version mineure est la plus récente. |
Vous pouvez consulter l'état et la version de votre instance dans la section Basic Information de la page Instance Details de la console Message Queue for Apache Kafka.
Notes d'utilisation
Important : Cette fonctionnalité est destinée uniquement aux scénarios de migration et de test. Nous vous recommandons vivement de ne pas activer la création automatique de topics dans les environnements de production. Si vous devez l'activer pour un environnement de production, ne l'utilisez pas pour les services de production critiques.
Pour une instance Professional Edition avec ACL activée, vous ne pouvez pas créer automatiquement un topic en envoyant un message.
Procédure
Connectez-vous à la console ApsaraMQ for Kafka. Sur la page Overview, sélectionnez une région dans la section Resource Distribution.
Sur la page Instances, cliquez sur le nom de l'instance cible.
-
Sur la page Instance Details, dans la section Configuration Information, activez le commutateur Automatic Topic Creation.
RemarqueConventions de nommage pour les topics créés automatiquement :
La longueur doit être comprise entre 3 et 64 caractères.
Le nom ne peut contenir que des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_), et doit contenir au moins une lettre ou un chiffre.
Sur une instance Standard Edition avec cette fonctionnalité activée, l'envoi d'un message vers un topic inexistant le crée automatiquement. Le nouveau topic apparaît ensuite dans la console.
FAQ
Les topics peuvent-ils être créés automatiquement ?
Oui, mais nous le déconseillons fortement. Dans Message Queue for Apache Kafka, gérez les topics à l'aide de la console Message Queue for Apache Kafka et de l'OpenAPI. Nous vous déconseillons d'activer la création automatique de topics dans un environnement de production pour les raisons suivantes :
La création automatique de topics ne prend pas en charge le contrôle d'accès granulaire ni l'audit des opérations sur les ressources, ce qui pose des risques en matière de sécurité et de gouvernance.
Elle peut entraîner une consommation incontrôlée des ressources, compromettant ainsi la stabilité du système.
La réussite de la création automatique de topics n'est pas garantie et les échecs peuvent perturber vos services. Pour plus d'informations, consultez la rubrique Que faire en cas d'échec de la création automatique de topics ?
Quand dois-je activer la création automatique de topics ?
Activez cette fonctionnalité uniquement pour des cas d'utilisation spécifiques, tels que la migration rapide vers le cloud et les tests. Ne l'utilisez pas au-delà de ces scénarios.
Gestion des échecs de création automatique de topics
Si la création automatique de topics échoue, essayez les solutions suivantes :
Si vous n'avez besoin de créer que quelques topics, nous vous recommandons de les créer manuellement dans la console ou via l'OpenAPI.
-
Vérifiez les journaux ou résolvez le problème en vous basant sur les causes possibles suivantes :
-
Opérations non valides : Une opération non valide peut empêcher la création ou l'utilisation correcte du topic, affectant ainsi vos services. Voici quelques exemples :
Nom de topic non valide : Le nom de topic spécifié par l'application ne respecte pas les conventions de nommage. Par exemple, le nom contient des caractères non valides ou dépasse la limite de longueur.
Configuration de topic non valide : Le moteur broker est mal sélectionné, ou les quotas pour les topics ou les partitions sont insuffisants.
ACL activée : Si la fonctionnalité ACL est activée, vous ne pouvez pas créer automatiquement un topic en envoyant un message.
Facteurs incontrôlables : Des facteurs externes tels que les fluctuations du réseau, les mises à niveau du serveur, la maintenance de la plateforme de gestion ou les pannes d'instances ECS peuvent augmenter considérablement le temps de création des topics et entraîner des échecs.
Conflits de service : La création automatique de topics peut provoquer des conflits de nommage entre les services, mélangeant ainsi les données. De tels problèmes sont difficiles à détecter et à résoudre, pouvant entraîner une perte de données irréversible.
Problèmes de latence : La création d'un topic à la demande prend beaucoup plus de temps que l'utilisation d'un topic existant, ce qui peut provoquer de brèves interruptions de service.
Limites de quota : la création de topic échoue si le quota pour les topics ou les partitions est dépassé.
-
Références
Pour les étapes détaillées de migration vers le cloud, consultez la rubrique Migration vers le cloud.
Si vous souhaitez créer des topics à l'aide de la console ou de l'API, consultez les rubriques Créer un topic et CreateTopic.