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.
Ajouter Auto Discovery à votre bibliothèque cliente Memcached
Les informations de configuration pour Auto Discovery sont stockées de manière redondante dans chaque nœud de cluster de cache Memcached. 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.
Moteur de cache version 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 ASCII et binaires Memcached par ElastiCache et 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 souhaitez ajouter la prise en charge de la découverte automatique à l'aide du protocole binaire, reportez-vous au code source du client de ElastiCache cluster
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 |
Oui |
key |
La clé sous laquelle la configuration du cluster est sauvegardée. Pour la découverte automatique, cette clé est appelée |
Oui |
Pour obtenir les informations de configuration du cluster, utilisez la commande suivante :
config get cluster
Moteur de cache version 1.4.14 ou inférieure
Pour obtenir les informations de configuration du cluster, utilisez la commande suivante :
get AmazonElastiCache:cluster
Note
Ne modifiez pas la clé « :cluster AmazonElastiCache », car c'est là que se trouvent les informations de configuration du cluster. Si vous remplacez cette clé, il se peut que le client soit mal configuré pendant une courte période (pas plus de 15 secondes) avant de mettre à jour ElastiCache automatiquement et correctement les informations de configuration.
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\nPour 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\nNote
-
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.
