Hinzufügen von Auto Discovery zu Ihrer Memcached-Clientbibliothek - Amazon ElastiCache

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Hinzufügen von Auto Discovery zu Ihrer Memcached-Clientbibliothek

Die Konfigurationsinformationen für Auto Discovery werden redundant in jedem Memcached-Cache-Clusterknoten gespeichert. Client-Anwendungen können jeden Cache-Knoten abfragen und die Konfigurationsinformationen für alle Knoten im Cluster abrufen.

Die jeweilige Methode, die eine Anwendung dazu nutzt, hängt von der Cache-Engine-Version ab:

  • Wenn die Cache-Engine-Version 1.4.14 oder höher ist, verwenden Sie den Befehl config.

  • Wenn die Cache-Engine-Version älter als 1.4.14 ist, verwenden Sie den Befehl get AmazonElastiCache:cluster.

Die Ausgaben dieser beiden Befehle sind identisch und werden im Abschnitt Ausgabeformat beschrieben.

Cache-Engine-Version 1.4.14 oder höher

Für die Cache-Engine-Version 1.4.14 oder höher verwenden Sie den Befehl config. Dieser Befehl wurde den Memcached ASCII - und Binärprotokollen von hinzugefügt und ist im ElastiCache Cluster-Client implementiert. ElastiCache Wenn Sie Auto Discovery mit einer anderen Client-Bibliothek verwenden möchten, muss diese Bibliothek um den Support für den Befehl config erweitert werden.

Anmerkung

Die folgende Dokumentation bezieht sich auf ASCII das Protokoll. Der config Befehl unterstützt jedoch beide ASCII Protokolle und Binärdateien. Wenn Sie Auto Discovery-Unterstützung mithilfe des Binärprotokolls hinzufügen möchten, finden Sie weitere Informationen im Quellcode für den ElastiCache Cluster-Client.

Syntax

config [sub-command] [key]

Optionen

Name Beschreibung Erforderlich
sub-command

Der Unterbefehl, der zum Interagieren mit einem Cache-Knoten verwendet wird. Für Auto Discovery lautet dieser Unterbefehl get.

Ja
key

Der Schlüssel, mit dem die Cluster-Konfiguration gespeichert ist. Für Auto Discovery lautet dieser Schlüssel cluster.

Ja

Verwenden Sie zum Abrufen der Cluster-Konfigurationsinformationen den folgenden Befehl:

config get cluster

Cache-Engine-Version älter als 1.4.14

Verwenden Sie zum Abrufen der Cluster-Konfigurationsinformationen den folgenden Befehl:

get AmazonElastiCache:cluster
Anmerkung

Verändern Sie nicht den Schlüssel „:clusterAmazonElastiCache“, da sich dort die Cluster-Konfigurationsinformationen befinden. Wenn Sie diesen Schlüssel überschreiben, ist der Client möglicherweise für einen kurzen Zeitraum (nicht länger als 15 Sekunden) falsch konfiguriert, bevor die Konfigurationsinformationen ElastiCache automatisch und korrekt aktualisiert werden.

Ausgabeformat

Wenn Sie config get cluster oder get AmazonElastiCache:cluster verwenden, umfasst die Antwort zwei Zeilen:

  • Die Versionsnummer der Konfigurationsinformationen. Jedes Mal, wenn ein Knoten hinzugefügt oder aus dem Cache-Cluster entfernt wird, wird die Versionsnummer um eins erhöht.

  • Eine Liste der Cache-Knoten. Jeder Knoten in der Liste wird durch eine hostname|ip-address|port-Gruppe repräsentiert und durch ein Leerzeichen getrennt.

Am Ende jeder Zeile erscheint ein Wagenrücklauf- und Zeilenvorschubzeichen (CR + LF). Die Datenzeile enthält am Ende ein Zeilenvorschubzeichen (LF), dem die Zeichen CR + LF hinzugefügt werden. Die Config-Versionszeile wird durch LF ohne CR beendet.

Ein Cache-Cluster mit drei Knoten wird wie folgt dargestellt:

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

Jeder Knoten wird sowohl mit der als auch mit der privaten IP-Adresse angezeigt. CNAME Die CNAME wird immer vorhanden sein. Wenn die private IP-Adresse nicht verfügbar ist, wird sie nicht angezeigt. Die Pipezeichen "|" werden jedoch trotzdem gedruckt.

Beispiel

Das nachfolgende Beispiel zeigt die Nutzlast, die zurückgegeben wird, wenn Sie die Konfigurationsinformationen abfragen:

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
Anmerkung
  • Die zweite Zeile gibt an, dass die Konfigurationsinformationen bisher zwölfmal geändert wurden.

  • In der dritten Zeile wird die Liste der Knoten in alphabetischer Reihenfolge nach Hostname angegeben. Diese Reihenfolge kann sich von der Sequenz unterscheiden, die Sie derzeit in Ihrer Client-Anwendung verwenden.