Verbindungsendpunkte finden in ElastiCache

Wenn ein Valkey-, Valkey- oder Redis OSS-Cluster (Clustermodus deaktiviert) nur einen Knoten hat, wird der Endpunkt des Knotens sowohl für Lese- als auch für Schreibvorgänge verwendet. Wenn ein Valkey- oder Valkey- oder Redis OSS-Cluster (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 auf den 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 Reader-Endpunkt verteilt eingehende Verbindungen zum Endpunkt gleichmäßig auf alle Read Replicas in einem für Redis OSS bestimmten Cluster. ElastiCache 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.

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.

Ein primärer Endpunkt von Valkey, 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 OSS-Cluster (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.

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 

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 OSS 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 Redis OSS-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.

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

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

{
   "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"
        }
    ]   
}

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

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

{
    "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 Redis OSS-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 dieser Operation sollte etwa wie nachfolgend dargestellt aussehen (JSON-Format).

{
   "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 unter describe-replication-groups in der Referenz zum AWS CLI -Befehl.

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

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

Suche nach Endpunkten für Knoten und Cluster (API) ElastiCache

Sie können die ElastiCache API verwenden, um mit der Aktion die Endpunkte für einen Cluster und seine Knoten zu ermitteln. DescribeCacheClusters Für Valkey- oder Redis OSS-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.

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>

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

Mithilfe der ElastiCache API können Sie mithilfe der Aktion 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.

Der folgende Vorgang ruft den primären Endpunkt (PrimaryEndpoint), den Leser-Endpunkt (ReaderEndpoint) und die einzelnen Knotenendpunkte (ReadEndpoint) für die Replikationsgruppe ab. 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.