Recherche de points de terminaison de connexion dans ElastiCache

Votre application se connecte à votre ElastiCache cluster à l'aide de points de terminaison. Un point de terminaison est l'adresse unique d'un nœud ou d'un cluster.

Quels terminaux utiliser avec Valkey ou Redis OSS

nœud autonome, utilisez le point de terminaison du nœud pour les opérations de lecture et d'écriture.
Clusters Valkery, Valkey ou Redis OSS (mode cluster désactivé), utilisez le point de terminaison principal pour toutes les opérations d'écriture. Utilisez le Point de terminaison du lecteur pour répartir également les connexions entrantes vers le point de terminaison entre toutes les réplicas lues. Utilisez les points de terminaison de nœud individuels pour les opérations de lecture (dans leAPI/, ils CLI sont appelés points de terminaison de lecture).
Clusters Valkey ou Redis OSS (mode cluster activé), utilisez le point de terminaison de configuration du cluster pour toutes les opérations prenant en charge les commandes activées en mode cluster. Vous devez utiliser un client compatible avec Valkey Cluster ou Redis OSS Cluster (Redis OSS 3.2). Vous pouvez toujours lire à partir des points de terminaison de nœuds individuels (dans leAPI/, ils CLI sont appelés points de terminaison de lecture).

Les sections suivantes vous guident à travers la découverte de points de terminaison dont vous aurez besoin pour le moteur utilisé.

Quels points de terminaison utiliser avec Memcached

Pour le cache ElastiCache sans serveur avec Memcached, il suffit d'acquérir le point de terminaison DNS et le port du cluster depuis la console.

À partir du AWS CLI, utilisez la describe-serverless-caches commande pour obtenir les informations du point de terminaison.

Linux


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

Windows


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

Le résultat de l'opération ci-dessus devrait ressembler à ceci (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"
        }
    ]
}

Pour une instance basée sur un cluster Memcached, si vous utilisez la découverte automatique, vous pouvez utiliser le point de terminaison de la configuration du cluster pour configurer votre client Memcached. Cela signifie que vous devez utiliser un client qui prend en charge la découverte automatique.

Si vous n'utilisez pas la découverte automatique, vous devez configurer votre client pour utiliser les points de terminaison des nœuds individuels pour les lectures et écritures. Vous devez également garder des traces de ces dernières lorsque vous ajoutez ou supprimez des nœuds.

Si un cluster Valkery, Valkey ou Redis OSS (mode cluster désactivé) ne possède qu'un seul nœud, le point de terminaison du nœud est utilisé à la fois pour les lectures et les écritures. Si un cluster Valkery, Valkey ou Redis OSS (mode cluster désactivé) possède plusieurs nœuds, il existe trois types de points de terminaison : le point de terminaison principal, le point de terminaison du lecteur et les points de terminaison du nœud.

Le point de terminaison principal est un DNS nom qui correspond toujours au nœud principal du cluster. Le point de terminaison principal n'est pas affecté par les changements apportés à votre cluster, tels que la promotion d'un réplica en lecture au rang de réplica principal. Pour l'activité d'écriture, il est préférable que vos applications se connectent au point de terminaison principal.

Un point de terminaison de lecteur répartira de manière égale les connexions entrantes vers le point de terminaison entre toutes les répliques de lecture d'un ElastiCache cluster (RedisOSS). Des facteurs supplémentaires, comme le moment où l'application crée les connexions ou la façon dont l'application utilise ou réutilise les connexions, détermineront la distribution du trafic. Les points de terminaison du lecteur suivent les changements de cluster en temps réel au fur et à mesure que des réplicas sont ajoutés ou supprimés. Vous pouvez placer les multiples répliques de lecture de votre cluster ElastiCache (RedisOSS) dans différentes zones de AWS disponibilité (AZ) pour garantir la haute disponibilité des points de terminaison des lecteurs.

Note

Un point de terminaison du lecteur n'est pas un équilibreur de charge. Il s'agit d'un DNS enregistrement qui sera résolu en une adresse IP de l'un des nœuds répliqués de manière circulaire.

Pour l'activité de lecture, les applications peuvent également se connecter à n'importe quel nœud du cluster. Contrairement au point de terminaison principal, les points de terminaison des nœuds sont résolus dans des points de terminaison spécifiques. En cas de modification dans votre cluster, comme l'ajout ou la suppression d'un réplica, vous devez mettre à jour les points de terminaison des nœuds de votre application.

Pour rechercher les points de terminaison d'un cluster Valkery, Valkey ou Redis OSS (mode cluster désactivé)

Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/elasticache/.
Dans le volet de navigation, choisissez Valkey clusters ou Redis OSS clusters.

L'écran des clusters apparaîtra avec une liste de clusters Valkery, Valkey ou Redis OSS (mode cluster désactivé) et Valkey ou Redis OSS (mode cluster activé).
Pour rechercher les points de terminaison principaux et/ou lecteurs du cluster, choisissez le nom du cluster (et non le bouton à sa gauche).

Points de terminaison principaux et de lecture pour un cluster Valkery, Valkey ou Redis OSS (mode cluster désactivé)

S'il y a un seul nœud dans le cluster, il n'y a aucun point de terminaison principal et vous pouvez passer à l'étape suivante.
Si le cluster Valkery, Valkey ou Redis OSS (mode cluster désactivé) possède des nœuds répliques, vous pouvez trouver les points de terminaison des nœuds répliques du cluster en choisissant le nom du cluster, puis en choisissant l'onglet Nœuds.

L'écran des nœuds s'affiche avec chaque nœud du cluster, principal et de réplica, répertorié avec son point de terminaison.

Points de terminaison de nœuds pour un cluster Valkery, Valkey ou Redis OSS (mode cluster désactivé)
Pour copier un point de terminaison dans le presse-papiers :
1. Un point de terminaison à la fois, recherchez le point de terminaison que vous souhaitez copier.
2. Cliquez sur l'icône de copie située juste devant le point de terminaison.
Le point de terminaison est maintenant copié dans votre presse-papiers. Pour en savoir plus sur l’utilisation du point de terminaison pour se connecter à un nœud, consultez Connexion aux nœuds Memcached.

Un point de terminaison principal Valkery, Valkey ou Redis OSS (mode cluster désactivé) ressemble à ce qui suit. Il existe une différence selon que le chiffrement en transit est activé ou pas.

Chiffrement en transit non activé


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

Chiffrement en transit activé


master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port

master.ncit.ameaqx.use1.cache.amazonaws.com:6379

Un cluster Valkey ou Redis OSS (mode cluster activé) possède un point de terminaison de configuration unique. En se connectant au point de terminaison de configuration, votre application est en mesure de découvrir les points de terminaison principal et de lecture pour chaque partition du cluster.

Pour trouver le point de terminaison d'un cluster Valkey ou Redis OSS (mode cluster activé)

Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/elasticache/.
Dans le volet de navigation, choisissez Valkey clusters ou Redis OSS clusters.

L'écran des clusters apparaîtra avec une liste de clusters. Choisissez le cluster auquel vous souhaitez vous connecter.
Pour rechercher le point de terminaison de la configuration du cluster, choisissez le nom du cluster (et non le bouton radio).
Le Configuration endpoint (point de terminaison de la configuration) est affiché sous Cluster details (Détails du cluster). Pour le copier, choisissez l'icône de copie à gauche du point de terminaison.

Tous les points de terminaison Memcached sont des points de terminaison de lecture/écriture. Pour vous connecter aux nœuds dans un cluster Memcached, votre application peut utiliser les points de terminaison de chaque nœud ou le point de terminaison de configuration du cluster avec la découverte automatique. Pour utiliser la découverte automatique, vous devez avoir recours à un client qui prend en charge la découverte automatique.

Lorsque vous utilisez la découverte automatique, votre application client se connecte à votre cluster Memcached en utilisant le point de terminaison de configuration. Lorsque vous redimensionnez votre cluster en ajoutant ou supprimant des nœuds, votre application « connaîtra » automatiquement tous les nœuds du cluster et sera en mesure de se connecter à l'un d'eux. Sans la fonction de découverte automatique, votre application devra faire cela ou vous devrez mettre à jour manuellement les points de terminaison de votre application après chaque ajout ou suppression d'un nœud.

Pour copier un point de terminaison, cliquez sur l'icône de copie située juste devant l'adresse du point de terminaison. Pour en savoir plus sur l’utilisation du point de terminaison pour se connecter à un nœud, consultez Connexion aux nœuds Memcached.

La configuration et les points de terminaison des nœuds sont très similaires. Les différences sont mises en évidence en gras comme suit.


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

Important

Si vous choisissez de créer un point de terminaison CNAME pour votre configuration Memcached, afin que votre client de découverte automatique le reconnaisse CNAME comme un point de terminaison de configuration, vous devez inclure .cfg. dans le. CNAME

Pour Memcached, vous pouvez utiliser le for AWS CLI Amazon ElastiCache pour découvrir les points de terminaison des nœuds et des clusters.

Pour Redis, vous pouvez utiliser le AWS CLI for Amazon ElastiCache pour découvrir les points de terminaison des nœuds, des clusters et également des groupes de réplication.

Rubriques

Recherche des points de terminaison des nœuds et des clusters (AWS CLI)
Trouver les points de terminaison pour les groupes de OSS réplication Valkey ou Redis ()AWS CLI

Recherche des points de terminaison des nœuds et des clusters (AWS CLI)

Vous pouvez utiliser le AWS CLI pour découvrir les points de terminaison d'un cluster et de ses nœuds à l'aide de la describe-cache-clusters commande. Pour les OSS clusters Valkey ou Redis, la commande renvoie le point de terminaison du cluster. Pour les clusters Memcached, la commande renvoie le point de terminaison de configuration. Si vous ajoutez le paramètre facultatif --show-cache-node-info, la commande renvoie également les points de terminaison de chaque nœud figurant dans le cluster.

La commande suivante extrait le point de terminaison de configuration (ConfigurationEndpoint) et les points de terminaison des nœuds individuels (Endpoint) pour le cluster Memcached mycluster.

Pour Linux, macOS ou Unix :


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

Pour Windows :


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

La sortie de l'opération ci-dessus devrait ressembler à ceci (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"
        }
    ]   
}

Important

Pour Valkey et RedisOSS, la commande suivante permet de récupérer les informations du cluster à nœud unique mycluster.

Important

Le paramètre --cache-cluster-id peut être utilisé avec un identifiant de cluster Valkey ou Redis à nœud unique OSS (mode cluster désactivé) ou des identifiants de nœud spécifiques dans les groupes de réplication. Le --cache-cluster-id d'un groupe de réplication est une valeur à 4 chiffres telle que0001. S'il s'--cache-cluster-idagit de l'identifiant d'un cluster (nœud) dans un groupe de réplication, replication-group-id il est inclus dans la sortie.

Pour Linux, macOS ou Unix :


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

Pour Windows :


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

La sortie de l'opération ci-dessus devrait ressembler à ceci (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"
        }
    ]
}

Pour plus d'informations, consultez la rubrique describe-cache-clusters.

Trouver les points de terminaison pour les groupes de OSS réplication Valkey ou Redis ()AWS CLI

Vous pouvez utiliser le AWS CLI pour découvrir les points de terminaison d'un groupe de réplication et de ses clusters à l'aide de la describe-replication-groups commande. La commande renvoie le point de terminaison principal du groupe de réplication et une liste de tous les clusters (nœuds) figurant dans le groupe de réplication avec leurs points de terminaison et avec le point de terminaison du lecteur.

L'opération suivante extrait le point de terminaison principal et les points de terminaison du lecteur pour le groupe de réplication myreplgroup. Utilisez le point de terminaison principal pour toutes les opérations d'écriture.


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

Pour Windows :


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

Le résultat de cette opération devrait ressembler à ceci (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": {}
      }
   ]
}

Pour plus d'informations, consultez describe-replication-groupsle manuel de référence des AWS CLI commandes.

Pour Memcached, vous pouvez utiliser Amazon ElastiCache API pour découvrir les points de terminaison des nœuds et des clusters.

Pour Redis, vous pouvez utiliser Amazon ElastiCache API pour découvrir les points de terminaison des nœuds, des clusters et des groupes de réplication.

Rubriques

Recherche de points de terminaison pour les nœuds et les clusters () ElastiCache API
Recherche de points de terminaison pour les groupes de OSS réplication Valkey ou Redis () ElastiCache API

Recherche de points de terminaison pour les nœuds et les clusters () ElastiCache API

Vous pouvez utiliser le ElastiCache API pour découvrir les points de terminaison d'un cluster et de ses nœuds grâce à l'DescribeCacheClustersaction. Pour les OSS clusters Valkey ou Redis, la commande renvoie le point de terminaison du cluster. Pour les clusters Memcached, la commande renvoie le point de terminaison de configuration. Si vous ajoutez le paramètre facultatif ShowCacheNodeInfo, l'action renvoie également les points de terminaison de chaque nœud figurant dans le cluster.

Pour Memcached, la commande suivante récupère le point de terminaison de configuration (ConfigurationEndpoint) et les points de terminaison des nœuds individuels (Endpoint) pour le cluster Memcached mycluster.


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>

Important

Recherche de points de terminaison pour les groupes de OSS réplication Valkey ou Redis () ElastiCache API

Vous pouvez utiliser le ElastiCache API pour découvrir les points de terminaison d'un groupe de réplication et de ses clusters grâce à cette DescribeReplicationGroups action. L'action renvoie le point de terminaison principal du groupe de réplication et une liste de tous les clusters figurant dans le groupe de réplication avec le point de terminaison du lecteur.

L'opération suivante permet de récupérer le point de terminaison principal (PrimaryEndpoint), le point de terminaison du lecteur (ReaderEndpoint) et les points de terminaison des nœuds individuels (ReadEndpoint) pour le groupe de réplication. myreplgroup Utilisez le point de terminaison principal pour toutes les opérations d'écriture.


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>

Pour plus d'informations, consultez DescribeReplicationGroups.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Accès à votre ElastiCache cluster ou à votre groupe de réplication

Des éclats dans ElastiCache