Ajout de la découverte automatique à votre bibliothèque client - Amazon ElastiCache

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ajout de la découverte automatique à votre bibliothèque client

Les informations de configuration pour la découverte automatique sont stockées de manière redondante dans chaque nœud du cluster de cache. Les applications client peuvent interroger chaque nœud de cache pour obtenir les informations de configuration de tous les nœuds du cluster.

La façon de laquelle une application effectue cette tâche dépend de la version du moteur de cache :

  • Si la version du moteur de cache est 1.4.14 ou supérieure, utilisez la commande config.

  • Si la version du moteur de cache est inférieure à 1.4.14, utilisez la commande get AmazonElastiCache:cluster.

Les résultats de ces deux commandes sont identiques et sont décrits dans la section Résultat ci-dessous.

Version du moteur de cache 1.4.14 ou supérieure

Dans le cas d'une version 1.4.14 ou supérieure du moteur de cache, utilisez la commande config. Cette commande a été ajoutée aux protocoles binaires et ASCII Memcached par ElastiCache, et elle est implémentée dans le client de cluster ElastiCache. Si vous souhaitez utiliser la découverte automatique avec une autre bibliothèque client, alors cette bibliothèque devra être étendue pour prendre en charge la commande config.

Note

La documentation suivante concerne le protocole ASCII ; toutefois, la commande config prend en charge le protocole ASCII aussi bien que le protocole binaire. Si vous voulez ajouter la prise en charge de la découverte automatique par l'intermédiaire du protocole binaire, reportez-vous au code source du client de cluster ElastiCache.

Syntaxe

config [sub-command] [key]

Options

Name (Nom) Description Obligatoire
sub-command

La sous-commande utilisée pour interagir avec un nœud de cache. Pour la découverte automatique, cette sous-commande est get.

Oui
key

La clé sous laquelle la configuration du cluster est sauvegardée. Pour la découverte automatique, cette clé est appelée cluster.

Oui

Pour obtenir les informations de configuration du cluster, utilisez la commande suivante :

config get cluster

Version du moteur de cache inférieure à 1.4.14

Pour obtenir les informations de configuration du cluster, utilisez la commande suivante :

get AmazonElastiCache:cluster
Note

Ne modifiez pas la clé « AmazonElastiCache:cluster », car c'est là que résident les informations de configuration du cluster. Si vous remplacez cette clé, la configuration du client pourrait être incorrectement configurée pendant un court laps de temps (moins de 15 secondes) avant qu'ElastiCache corrige et mette à jour les informations de configuration automatiquement.

Résultat

Que vous utilisiez config get cluster ou get AmazonElastiCache:cluster, la réponse tient deux lignes :

  • Le numéro de version des informations de configuration. Chaque fois qu'un nœud est ajouté ou supprimé du cluster de cache, le numéro de la version s'incrémente d'une unité.

  • Une liste des nœuds de cache. Chaque nœud dans la liste est représenté par un groupe hostname|ip-address|port et chaque nœud est séparé par un espace.

Un retour à la ligne et un saut de ligne (CR + LF) figurent à la fin de chaque ligne. La ligne de données se termine par un retour à la ligne, puis un retour à la ligne et un saut de ligne (CR + LF) sont ajoutés. La ligne où figure la version de configuration se termine par saut de ligne (LF) sans retour à la ligne (CR).

Un cluster de cache contenant trois nœuds est représenté comme suit :

configversion\n hostname|ip-address|port hostname|ip-address|port hostname|ip-address|port\n\r\n

Pour chaque nœud, sont affichés le CNAME et l'adresse IP privée. Le CNAME est toujours affiché ; l'adresse IP n'est affichée que si elle existe. Cependant, les barres verticales « | »seront tout de même affichées.

Exemple

Voici un exemple de la charge utile transmise lorsque vous interrogez les informations de configuration :

CONFIG cluster 0 136\r\n 12\n myCluster.pc4ldq.0001.use1.cache.amazonaws.com|10.82.235.120|11211 myCluster.pc4ldq.0002.use1.cache.amazonaws.com|10.80.249.27|11211\n\r\n END\r\n
Note
  • La deuxième ligne indique que les informations de configuration a été modifiées douze fois jusqu'à présent.

  • Sur la troisième ligne, la liste de nœuds est triée alphabétiquement par nom d'hôte. Cet ordre peut être différent de celui que vous utilisez habituellement dans votre application client.