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 Client-Bibliothek
Die Konfigurationsinformationen für Auto Discovery werden in jedem Cache-Cluster-Knoten redundant 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 von ElastiCache zu den Memcached-ASCII- und -Binärprotokollen hinzugefügt und ist im ElastiCache-Cluster-Client implementiert. 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 zwar auf das ASCII-Protokoll, der Befehl config unterstützt jedoch sowohl das ASCII- als auch das Binärprotokoll. Wenn Sie Auto-Discovery-Support unter Verwendung des binären Protokolls hinzufügen möchten, lesen Sie den 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 |
Ja |
key |
Der Schlüssel, mit dem die Cluster-Konfiguration gespeichert ist. Für Auto Discovery lautet dieser Schlüssel |
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
Nehmen Sie keine unerlaubten Änderungen am "AmazonElastiCache:cluster"-Schlüssel vor, da hiermit die Cluster-Konfigurationsinformationen gespeichert sind. Wenn Sie diesen Schlüssel überschreiben, kann der Client für eine kurze Zeit (nicht mehr als 15 Sekunden) falsch konfiguriert sein, bevor ElastiCache die Konfigurationsinformationen automatisch und korrekt aktualisiert.
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\nJeder Knoten wird sowohl mit dem CNAME als auch der privaten IP-Adresse angezeigt. Der CNAME ist immer vorhanden. Wenn die private IP-Adresse nicht verfügbar ist, wird sie nicht angezeigt. Die Pipe-Zeichen "|" werden dennoch 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\nAnmerkung
-
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.
