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
Votre application se connecte à votre cluster à l'aide de points de terminaison. Un point de terminaison est l'adresse unique d'un nœud ou d'un cluster.
Quels points de terminaison utiliser
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.
Les sections suivantes vous guident à travers la découverte de points de terminaison dont vous aurez besoin pour le moteur utilisé.
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.
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
Vous pouvez utiliser le AWS CLI for Amazon pour ElastiCache découvrir les points de terminaison des nœuds et des clusters.
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 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
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",
}
]
}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 l'inclure .cfg. dans le. CNAME Par exemple, mycluster dans votre fichier php.ini pour le paramètre .cfg.localsession.save_path.
Pour plus d'informations, consultez la rubrique describe-cache-clusters.
Vous pouvez utiliser Amazon ElastiCache API pour découvrir les points de terminaison des nœuds et des clusters.
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 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.
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.
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 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 l'inclure .cfg. dans le. CNAME Par exemple, mycluster dans votre fichier php.ini pour le paramètre .cfg.localsession.save_path.
