Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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.
Vous pouvez également établir une connexion privée entre votre VPC et les points de terminaison d' ElastiCache API en créant un point de terminaison VPC d'interface via. AWS PrivateLink Pour de plus amples informations, veuillez consulter ElastiCache Points de terminaison VPC de l'API et de l'interface ()AWS PrivateLink.
Quels points de terminaison utiliser avec Valkey ou Redis OSS.
-
Pour un nœud autonome, utilisez le point de terminaison du nœud pour les opérations de lecture et d'écriture.
-
Pour les clusters Valkey, 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 d'écriture (dans l'API/la CLI, ils sont appelés points de terminaison de lecture).
-
Pour les 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 qui prend en charge Valkey Cluster ou Redis OSS Cluster sur Redis OSS 3.2 et versions ultérieures. Vous pouvez toujours lire à partir des points individuels de terminaison de nœuds (dans l'API/CLI, ceux-ci sont appelés Read Endpoints).
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 pour Memcached, il suffit d'acquérir le DNS et le port du point de terminaison 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 doit ressembler à cet exemple (format JSON) :
{ "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 un cluster Memcached basé sur une instance, si vous utilisez Automatic Discovery, vous pouvez utiliser le point de terminaison de 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 Valkey, 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 Valkey, 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 nom DNS qui est toujours résolu dans le 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 ElastiCache d'un cluster Redis OSS. 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 ElastiCache les multiples répliques de lecture de votre cluster Redis OSS dans différentes zones de AWS disponibilité (AZ) afin de 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 enregistrement DNS qui se résoudra à une adresse IP de l'un des nœuds de réplica en mode round robin.
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 Valkey, 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 Valkey, 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 lecteurs pour un cluster Valkey, 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 Valkey, Valkey ou Redis OSS (mode cluster désactivé) possède des nœuds de réplication, vous pouvez trouver les points de terminaison des nœuds de réplication 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 Valkey, Valkey ou Redis OSS (mode cluster désactivé)
-
Pour copier un point de terminaison dans le presse-papiers :
-
Un point de terminaison à la fois, recherchez le point de terminaison que vous souhaitez copier.
-
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 Valkey, 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:6379Chiffrement en transit activé
master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port
master.ncit.ameaqx.use1.cache.amazonaws.com:6379Un 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 enregistrement CNAME pour votre point de terminaison de configuration Memcached, afin que votre client de découverte automatique reconnaisse l'enregistrement CNAME comme 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 OSS, 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)
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 clusters Valkey ou Redis OSS, 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-idmycluster\ --show-cache-node-info
Pour Windows :
aws elasticache describe-cache-clusters ^ --cache-cluster-idmycluster^ --show-cache-node-info
Le résultat de l'opération ci-dessus doit ressembler à cet exemple (format JSON).
{
"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
Si vous choisissez de créer un enregistrement CNAME pour votre point de terminaison de configuration Memcached, afin que votre client de découverte automatique reconnaisse l'enregistrement CNAME comme point de terminaison de configuration, vous devez inclure .cfg. dans le CNAME. Par exemple, mycluster dans votre fichier php.ini pour le paramètre .cfg.localsession.save_path.
Pour Valkey et Redis OSS, la commande suivante récupère les informations de cluster pour le cluster à nœud unique mycluster.
Important
Le paramètre --cache-cluster-id peut être utilisé avec un identifiant de cluster Valkey ou Redis OSS (mode cluster désactivé) à nœud unique 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-idredis-cluster\ --show-cache-node-info
Pour Windows :
aws elasticache describe-cache-clusters ^ --cache-cluster-idredis-cluster^ --show-cache-node-info
Le résultat de l'opération ci-dessus doit ressembler à cet exemple (format JSON).
{
"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 de plus amples informations, consultez la rubrique describe-cache-clusters.
Recherche des points de terminaison pour les groupes de réplication Valkey ou Redis OSS ()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-idmyreplgroup
Pour Windows :
aws elasticache describe-replication-groups ^ --replication-group-idmyreplgroup
Le résultat de cette opération doit ressembler à cet exemple (format JSON).
{
"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-groups dans la Référence des commandes de l’AWS CLI .
Pour Memcached, vous pouvez utiliser l' ElastiCache API Amazon pour découvrir les points de terminaison des nœuds et des clusters.
Pour Redis OSS, vous pouvez utiliser l' ElastiCache API Amazon 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)
Vous pouvez utiliser l' ElastiCache API pour découvrir les points de terminaison d'un cluster et de ses nœuds grâce à l'DescribeCacheClustersaction. Pour les clusters Valkey ou Redis OSS, 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
Si vous choisissez de créer un enregistrement CNAME pour votre point de terminaison de configuration Memcached, afin que votre client de découverte automatique reconnaisse l'enregistrement CNAME comme point de terminaison de configuration, vous devez inclure .cfg. dans le CNAME. Par exemple, mycluster dans votre fichier php.ini pour le paramètre .cfg.localsession.save_path.
Recherche de points de terminaison pour les groupes de réplication (API) Valkey ou Redis OSS ElastiCache
Vous pouvez utiliser l' ElastiCache API pour découvrir les points de terminaison d'un groupe de réplication et de ses clusters grâce à l'DescribeReplicationGroupsaction. 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 de plus amples informations, veuillez consulter DescribeReplicationGroups.
