Verbindungsendpunkte finden in ElastiCache - 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.

Verbindungsendpunkte finden in ElastiCache

Ihre Anwendung stellt über Endpunkte eine Verbindung zu Ihrem ElastiCache Cluster her. Ein Endpunkt ist die eindeutige Adresse eines Knotens oder Clusters.

Welche Endpunkte sollen mit Valkey oder Redis verwendet werden OSS
  • eigenständiger Knoten, verwendet den Endpunkt des Knotens sowohl für Lese- als auch für Schreiboperationen.

     

  • Valkery-, Valkey- oder Redis-Cluster OSS (Clustermodus deaktiviert) verwenden den primären Endpunkt für alle Schreibvorgänge. Verwenden Sie Leser-Endpunkt, um am Endpunkt ankommende Verbindungen auf alle Lesereplikate zu verteilen. Verwenden Sie die einzelnen Node-Endpoints für Lesevorgänge (im FeldAPI/werden CLI diese als Lese-Endpunkte bezeichnet).

     

  • Valkey- oder Redis-Cluster OSS (Clustermodus aktiviert) verwenden den Konfigurationsendpunkt des Clusters für alle Operationen, die Befehle mit aktiviertem Clustermodus unterstützen. Sie müssen einen Client verwenden, der Valkey Cluster oder Redis OSS Cluster (Redis 3.2) unterstützt. OSS Sie können immer noch von einzelnen Knotenendpunkten lesen (In der DateiAPI/werden CLI diese als Read-Endpunkte bezeichnet).

     

Die folgenden Abschnitte führen Sie durch die Erkennung der Endpunkte, die Sie für die von Ihnen ausgeführte Engine benötigen.

Welche Endpunkte sollen mit Memcached verwendet werden

Für ElastiCache serverlosen Cache mit Memcached rufen Sie einfach den Cluster-Endpunkt DNS und den Port von der Konsole ab.

Verwenden Sie von der aus den describe-serverless-caches Befehl AWS CLI, um die Endpunktinformationen abzurufen.

Linux

aws elasticache describe-serverless-caches --serverless-cache-name CacheName

Windows

aws elasticache describe-serverless-caches --serverless-cache-name CacheName

Die Ausgabe der obigen Operation sollte ungefähr so aussehen (JSONFormat):

{ "ServerlessCaches": [ { "ServerlessCacheName": "serverless-memcached", "Description": "test", "CreateTime": 1697659642.136, "Status": "available", "Engine": "memcached", "MajorEngineVersion": "1.6", "FullEngineVersion": "21", "SecurityGroupIds": [ "sg-083eda453e1e51310" ], "Endpoint": { "Address": "serverless-memcached-01.amazonaws.com", "Port":11211 }, "ARN": "<the ARN>", "SubnetIds": [ "subnet-0cf759df15bd4dc65", "subnet-09e1307e8f1560d17" ], "SnapshotRetentionLimit": 0, "DailySnapshotTime": "03:00" } ] }

Instance-basierter Memcached-Cluster – Wenn Sie Automatic Discovery verwenden, können Sie Ihren Memcached-Client über den Konfigurationsendpunkt des Clusters konfigurieren. Dies bedeutet, dass Sie einen Client verwenden müssen, der Automatic Discovery unterstützt.

Wenn Sie Automatic Discovery nicht verwenden, müssen Sie den Client so konfigurieren, dass er die einzelnen Knotenendpunkte für Lese- und Schreibvorgänge verwendet. Auch müssen Sie sie beim Hinzufügen und Entfernen von Knoten verfolgen.

Wenn ein Valkery-, Valkey- oder Redis-Cluster OSS (Clustermodus deaktiviert) nur einen Knoten hat, wird der Endpunkt des Knotens sowohl für Lese- als auch für Schreibvorgänge verwendet. Wenn ein Valkery-, Valkey- oder Redis-Cluster OSS (Cluster-Modus deaktiviert) mehrere Knoten hat, gibt es drei Arten von Endpunkten: den primären Endpunkt, den Reader-Endpunkt und die Knotenendpunkte.

Der primäre Endpunkt ist ein DNS Name, der immer zum primären Knoten im Cluster aufgelöst wird. Der primäre Endpunkt ist Änderungen an Ihrem Cluster, wie Heraufstufen einer Read Replica in die Rolle des primären Knotens, gegenüber immun. Für Schreibvorgänge empfehlen wir, dass Anwendungen sich ausschließlich mit dem primären Endpunkt verbinden.

Ein Leser-Endpunkt teilt eingehende Verbindungen zum Endpunkt gleichmäßig auf alle Read Replicas in einem ElastiCache (Redis OSS -) Cluster auf. Zusätzliche Faktoren, z. B. wenn die Anwendung die Verbindungen erstellt oder wie die Anwendung die Verbindungen (erneut) verwendet, bestimmen die Verteilung des Datenverkehrs. Reader-Endpunkte bleiben hinsichtlich der Cluster-Änderungen beim Hinzufügen oder Entfernen von Replicas in Echtzeit auf dem aktuellen Stand. Sie können die mehreren Read Replicas Ihres ElastiCache (Redis-OSS) Clusters in verschiedenen AWS Availability Zones (AZ) platzieren, um eine hohe Verfügbarkeit der Leser-Endpunkte sicherzustellen.

Anmerkung

Ein Leser-Endpunkt ist kein Load Balancer. Es handelt sich um einen DNS Datensatz, der nach dem Round-Robin-Verfahren in die IP-Adresse eines der Replikatknoten aufgelöst wird.

Für Lesevorgänge können Anwendungen Verbindungen zu jedem Knoten im Cluster herstellen. Im Gegensatz zum primären Endpunkt werden Knotenendpunkte auf bestimmte Endpunkte aufgelöst. Wenn Sie eine Änderung am Cluster vornehmen, wie z. B. Hinzufügen oder Löschen eines Replikats, müssen Sie die Knotenendpunkte in Ihrer Anwendung aktualisieren.

So finden Sie die Endpunkte eines Valkery-, Valkey- oder Redis-Clusters OSS (Clustermodus deaktiviert)
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Konsole unter. ElastiCache https://console.aws.amazon.com/elasticache/

  2. Wählen Sie im Navigationsbereich Valkey-Cluster oder OSSRedis-Cluster aus.

    Der Cluster-Bildschirm wird mit einer Liste von Valkery- oder Valkey- oder Redis-Clustern OSS (Cluster-Modus deaktiviert) und Valkey- oder Redis-Clustern (Cluster-Modus aktiviert) angezeigt. OSS

  3. Um den primären und/oder den Reader-Endpunkt des Clusters zu ermitteln, wählen Sie den Namen des Clusters aus (nicht die Schaltfläche links davon).

    Bild: Primärer Endpunkt für einen Valkery-, Valkey- oder Redis-Cluster (Cluster-Modus deaktiviert) OSS

    Primäre Endpunkte und Reader-Endpunkte für einen Valkery-, Valkey- oder Redis-Cluster (Clustermodus deaktiviert) OSS

    Wenn sich im Cluster nur ein Knoten befindet, ist kein primärer Endpunkt vorhanden. Sie können mit dem nächsten Schritt fortfahren.

  4. Wenn der Valkery-, Valkey- oder Redis-Cluster OSS (Clustermodus deaktiviert) über Replikatknoten verfügt, können Sie die Replikatknotenendpunkte des Clusters finden, indem Sie den Namen des Clusters und dann die Registerkarte Knoten auswählen.

    Auf dem angezeigten Knotenbildschirm wird jeder Knoten im Cluster, –primärer Knoten und Replikate, – mit seinem Endpunkt aufgelistet.

    Bild: Knotenendpunkte für einen Valkery-, Valkey- oder Redis-Cluster (Clustermodus deaktiviert) OSS

    Knotenendpunkte für einen Valkery-, Valkey- oder Redis-Cluster (Clustermodus deaktiviert) OSS

  5. So kopieren Sie einen Endpunkt in Ihre Zwischenablage:

    1. Suchen Sie einen Endpunkt nach dem anderen nach dem zu kopierenden Endpunkt.

    2. Wählen Sie das Kopiersymbol direkt vor dem Endpunkt aus.

    Der Endpunkt wird nun in Ihre Zwischenablage kopiert. Informationen zur Verwendung des Endpunkts zur Verbindung mit einem Knoten finden Sie unter Verbindung zu Memcached-Knoten herstellen.

Ein primärer Endpunkt von Valkery, Valkey oder Redis OSS (Clustermodus deaktiviert) sieht etwa wie folgt aus. Abhängig davon, ob die Verschlüsselung während der Übertragung aktiviert ist oder nicht, unterscheidet sich dies.

Verschlüsselung während der Übertragung nicht aktiviert

clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379

Verschlüsselung während der Übertragung aktiviert

master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port master.ncit.ameaqx.use1.cache.amazonaws.com:6379

Ein Valkey- oder Redis-Cluster OSS (Clustermodus aktiviert) hat einen einzigen Konfigurationsendpunkt. Über die Verbindung zum Konfigurationsendpunkt findet die Anwendung für jede Shard im Cluster die primären Endpunkte sowie jene für Schreibvorgänge.

Um den Endpunkt eines Valkey- oder Redis-Clusters OSS (Clustermodus aktiviert) zu finden
  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die ElastiCache Konsole unter. https://console.aws.amazon.com/elasticache/

  2. Wählen Sie im Navigationsbereich Valkey-Cluster oder OSSRedis-Cluster aus.

    Der Cluster-Bildschirm mit einer Liste von Clustern wird angezeigt. Wählen Sie den Cluster aus, zu dem Sie eine Verbindung herstellen möchten.

  3. Um den Konfigurationsendpunkt des Clusters zu suchen, wählen Sie den Namen des Clusters (nicht das Optionsfeld) aus.

  4. Der Configuration endpoint (Konfigurationsendpunkt) wird unter Cluster details (Cluster-Details) angezeigt. Wählen Sie zum Kopieren das Symbol Copy (Kopieren) links vom Endpunkt aus.

Alle Memcached-Endpunkte sind Lese-/Schreib-Endpunkte. Zum Herstellen einer Verbindung mit Knoten in einem Memcached-Cluster kann Ihre Anwendung entweder die Endpunkte für jeden Knoten oder den Konfigurationsendpunkt des Clusters zusammen mit Automatic Discovery verwenden. Um Automatic Discovery verwenden zu können, benötigen Sie einen Client, der Automatic Discovery unterstützt.

Wenn Automatic Discovery verwendet wird, stellt Ihre Client-Anwendung über den Konfigurationsendpunkt eine Verbindung mit Ihrem Memcached-Cluster her. Während Sie Ihren Cluster durch Hinzufügen oder Entfernen von Knoten skalieren, „kennt“ Ihre Anwendung automatisch alle Knoten im Cluster und kann zu beliebigen von ihnen eine Verbindung herstellen. Ohne Automatic Discovery wäre das Ihre Aufgabe oder Sie müssten die Endpunkte Ihrer Anwendung jedes Mal manuell aktualisieren, wenn Sie einen Knoten hinzufügen oder löschen würden.

Wenn Sie einen Endpunkt kopieren möchten, wählen Sie das Kopiersymbol direkt vor der Endpunktadresse aus. Informationen zur Verwendung des Endpunkts zur Verbindung mit einem Knoten finden Sie unter Verbindung zu Memcached-Knoten herstellen.

Die Konfiguration und die Knotenendpunkte sehen sehr ähnlich aus. Es folgen die mit Fettdruck hervorgehobenen Unterschiede.

myclustername.xxxxxx.cfg.usw2.cache.amazonaws.com:port # configuration endpoint contains "cfg" myclustername.xxxxxx.0001.usw2.cache.amazonaws.com:port # node endpoint for node 0001
Wichtig

Wenn Sie einen Konfigurationsendpunkt CNAME für Ihren Memcached erstellen möchten, damit Ihr Automatic Discovery Client ihn CNAME als Konfigurationsendpunkt erkennt, müssen Sie in den .cfg. CNAME

Für Memcached können Sie AWS CLI for Amazon verwenden, ElastiCache um die Endpunkte für Knoten und Cluster zu ermitteln.

Für Redis können Sie AWS CLI for Amazon verwenden, ElastiCache um die Endpunkte für Knoten, Cluster und auch Replikationsgruppen zu ermitteln.

Suchen von Endpunkten für Knoten und Cluster (AWS CLI)

Sie können den verwenden AWS CLI , um die Endpunkte für einen Cluster und seine Knoten mit dem Befehl zu ermitteln. describe-cache-clusters Für Valkey- oder OSS Redis-Cluster gibt der Befehl den Cluster-Endpunkt zurück. Für Memcached-Cluster gibt der Befehl den Konfigurationsendpunkt zurück. Wenn Sie den optionalen Parameter --show-cache-node-info einschließen, gibt der Befehl auch die Endpunkte der einzelnen Knoten im Cluster zurück.

Der folgende Befehl ruft den Konfigurationsendpunkt (ConfigurationEndpoint) und einzelne Knotenendpunkte (Endpoint) für den Memcached-Cluster mycluster ab.

Für Linux, macOS oder Unix:

aws elasticache describe-cache-clusters \ --cache-cluster-id mycluster \ --show-cache-node-info

Für Windows:

aws elasticache describe-cache-clusters ^ --cache-cluster-id mycluster ^ --show-cache-node-info

Die Ausgabe des obigen Vorgangs sollte ungefähr so aussehen (JSONFormat).

{ "CacheClusters": [ { "Engine": "memcached", "CacheNodes": [ { "CacheNodeId": "0001", "Endpoint": { "Port": 11211, "Address": "mycluster.amazonaws.com" }, "CacheNodeStatus": "available", "ParameterGroupStatus": "in-sync", "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", "CustomerAvailabilityZone": "us-west-2b" }, { "CacheNodeId": "0002", "Endpoint": { "Port": 11211, "Address": "mycluster.amazonaws.com" }, "CacheNodeStatus": "available", "ParameterGroupStatus": "in-sync", "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", "CustomerAvailabilityZone": "us-west-2b" }, { "CacheNodeId": "0003", "Endpoint": { "Port": 11211, "Address": "mycluster.amazonaws.com" }, "CacheNodeStatus": "available", "ParameterGroupStatus": "in-sync", "CacheNodeCreateTime": "2016-09-22T21:30:29.967Z", "CustomerAvailabilityZone": "us-west-2b" } ], "CacheParameterGroup": { "CacheNodeIdsToReboot": [], "CacheParameterGroupName": "default.memcached1.4", "ParameterApplyStatus": "in-sync" }, "CacheClusterId": "mycluster", "PreferredAvailabilityZone": "us-west-2b", "ConfigurationEndpoint": { "Port": 11211, "Address": "mycluster.amazonaws.com" }, "CacheSecurityGroups": [], "CacheClusterCreateTime": "2016-09-22T21:30:29.967Z", "AutoMinorVersionUpgrade": true, "CacheClusterStatus": "available", "NumCacheNodes": 3, "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheSubnetGroupName": "default", "EngineVersion": "1.4.24", "PendingModifiedValues": {}, "PreferredMaintenanceWindow": "mon:09:00-mon:10:00", "CacheNodeType": "cache.m4.large", "DataTiering": "disabled" } ] }
Wichtig

Wenn Sie einen Konfigurationsendpunkt CNAME für Ihren Memcached erstellen möchten, damit Ihr Auto Discovery-Client ihn CNAME als Konfigurationsendpunkt erkennt, müssen Sie ihn .cfg. in den aufnehmen. CNAME Zum Beispiel mycluster.cfg.local in Ihrer php.ini-Datei für den Parameter session.save_path.

Für Valkey und Redis OSS ruft der folgende Befehl die Clusterinformationen für den Einzelknotencluster mycluster ab.

Wichtig

Der Parameter --cache-cluster-id kann mit der Cluster-ID Valkey oder Redis OSS (Clustermodus deaktiviert) mit einem Knoten oder mit bestimmten Knoten-IDs in Replikationsgruppen verwendet werden. Der Wert --cache-cluster-id einer Replikationsgruppe ist ein vierstelliger Wert, wie z. B. 0001 Wenn --cache-cluster-id es sich um die ID eines Clusters (Knotens) in einer Replikationsgruppe handelt, replication-group-id ist der in der Ausgabe enthalten.

Für Linux, macOS oder Unix:

aws elasticache describe-cache-clusters \ --cache-cluster-id redis-cluster \ --show-cache-node-info

Für Windows:

aws elasticache describe-cache-clusters ^ --cache-cluster-id redis-cluster ^ --show-cache-node-info

Die Ausgabe der obigen Operation sollte ungefähr so aussehen (JSONFormat).

{ "CacheClusters": [ { "CacheClusterStatus": "available", "SecurityGroups": [ { "SecurityGroupId": "sg-77186e0d", "Status": "active" } ], "CacheNodes": [ { "CustomerAvailabilityZone": "us-east-1b", "CacheNodeCreateTime": "2018-04-25T18:19:28.241Z", "CacheNodeStatus": "available", "CacheNodeId": "0001", "Endpoint": { "Address": "redis-cluster.amazonaws.com", "Port": 6379 }, "ParameterGroupStatus": "in-sync" } ], "AtRestEncryptionEnabled": false, "CacheClusterId": "redis-cluster", "TransitEncryptionEnabled": false, "CacheParameterGroup": { "ParameterApplyStatus": "in-sync", "CacheNodeIdsToReboot": [], "CacheParameterGroupName": "default.redis3.2" }, "NumCacheNodes": 1, "PreferredAvailabilityZone": "us-east-1b", "AutoMinorVersionUpgrade": true, "Engine": "redis", "AuthTokenEnabled": false, "PendingModifiedValues": {}, "PreferredMaintenanceWindow": "tue:08:30-tue:09:30", "CacheSecurityGroups": [], "CacheSubnetGroupName": "default", "CacheNodeType": "cache.t2.small", "DataTiering": "disabled" "EngineVersion": "3.2.10", "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "CacheClusterCreateTime": "2018-04-25T18:19:28.241Z" } ] }

Weitere Informationen finden Sie im Thema describe-cache-clusters.

Finden der Endpunkte für Valkey- oder OSS Redis-Replikationsgruppen ()AWS CLI

Sie können den verwenden AWS CLI , um die Endpunkte für eine Replikationsgruppe und ihre Cluster mit dem Befehl zu ermitteln. describe-replication-groups Der Befehl gibt den primären Endpunkt der Replikationsgruppe und eine Liste aller Cluster (Knoten) in der Replikationsgruppe mit ihren Endpunkten sowie den Reader-Endpunkt zurück.

Die folgende Operation ruft den primären Endpunkt und den Reader-Endpunkt der Replikationsgruppe myreplgroup ab. Verwenden Sie den primären Endpunkt für alle Schreibvorgänge.

aws elasticache describe-replication-groups \ --replication-group-id myreplgroup

Für Windows:

aws elasticache describe-replication-groups ^ --replication-group-id myreplgroup

Die Ausgabe dieses Vorgangs sollte ungefähr so aussehen (JSONFormat).

{ "ReplicationGroups": [ { "Status": "available", "Description": "test", "NodeGroups": [ { "Status": "available", "NodeGroupMembers": [ { "CurrentRole": "primary", "PreferredAvailabilityZone": "us-west-2a", "CacheNodeId": "0001", "ReadEndpoint": { "Port": 6379, "Address": "myreplgroup-001.amazonaws.com" }, "CacheClusterId": "myreplgroup-001" }, { "CurrentRole": "replica", "PreferredAvailabilityZone": "us-west-2b", "CacheNodeId": "0001", "ReadEndpoint": { "Port": 6379, "Address": "myreplgroup-002.amazonaws.com" }, "CacheClusterId": "myreplgroup-002" }, { "CurrentRole": "replica", "PreferredAvailabilityZone": "us-west-2c", "CacheNodeId": "0001", "ReadEndpoint": { "Port": 6379, "Address": "myreplgroup-003.amazonaws.com" }, "CacheClusterId": "myreplgroup-003" } ], "NodeGroupId": "0001", "PrimaryEndpoint": { "Port": 6379, "Address": "myreplgroup.amazonaws.com" }, "ReaderEndpoint": { "Port": 6379, "Address": "myreplgroup-ro.amazonaws.com" } } ], "ReplicationGroupId": "myreplgroup", "AutomaticFailover": "enabled", "SnapshottingClusterId": "myreplgroup-002", "MemberClusters": [ "myreplgroup-001", "myreplgroup-002", "myreplgroup-003" ], "PendingModifiedValues": {} } ] }

Weitere Informationen finden Sie describe-replication-groupsin der AWS CLI Befehlsreferenz.

Für Memcached können Sie Amazon verwenden, ElastiCache API um die Endpunkte für Knoten und Cluster zu ermitteln.

Für Redis können Sie Amazon verwenden, ElastiCache API um die Endpunkte für Knoten, Cluster und auch Replikationsgruppen zu ermitteln.

Endpunkte für Knoten und Cluster finden () ElastiCache API

Mit der ElastiCache API Aktion können Sie die Endpunkte für einen Cluster und seine Knoten ermitteln. DescribeCacheClusters Für Valkey- oder OSS Redis-Cluster gibt der Befehl den Cluster-Endpunkt zurück. Für Memcached-Cluster gibt der Befehl den Konfigurationsendpunkt zurück. Wenn Sie den optionalen Parameter ShowCacheNodeInfo einschließen, gibt die Aktion auch die Endpunkte der einzelnen Knoten im Cluster zurück.

Für Memcached ruft der folgende Befehl den Konfigurationsendpunkt (ConfigurationEndpoint) und die einzelnen Knotenendpunkte (Endpoint) für den Memcached-Cluster mycluster ab.

https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeCacheClusters &CacheClusterId=mycluster &ShowCacheNodeInfo=true &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>
Wichtig

Wenn Sie einen Konfigurationsendpunkt CNAME für Ihren Memcached erstellen möchten, damit Ihr Auto Discovery-Client ihn CNAME als Konfigurationsendpunkt erkennt, müssen Sie ihn .cfg. in den aufnehmen. CNAME Zum Beispiel mycluster.cfg.local in Ihrer php.ini-Datei für den Parameter session.save_path.

Suchen nach Endpunkten für Valkey- oder OSS Redis-Replikationsgruppen () ElastiCache API

Mit der Aktion können Sie ElastiCache API die Endpunkte für eine Replikationsgruppe und ihre Cluster ermitteln. DescribeReplicationGroups Die Aktion gibt den primären Endpunkt der Replikationsgruppe und eine Liste aller Cluster in der Replikationsgruppe mit ihren Endpunkten sowie den Reader-Endpunkt zurück.

Mit dem folgenden Vorgang werden der primäre Endpunkt (PrimaryEndpoint), der Leser-Endpunkt (ReaderEndpoint) und die Endpunkte einzelner Knoten (ReadEndpoint) für die Replikationsgruppe abgerufen. myreplgroup Verwenden Sie den primären Endpunkt für alle Schreibvorgänge.

https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeReplicationGroups &ReplicationGroupId=myreplgroup &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>

Weitere Informationen finden Sie unter. DescribeReplicationGroups