Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Búsqueda de puntos finales de conexión en ElastiCache
La aplicación se conecta al ElastiCache clúster mediante puntos finales. Un punto de conexión es un nodo o la dirección única del clúster.
También puede establecer una conexión privada entre los puntos de enlace de la VPC y la ElastiCache API mediante la creación de una interfaz a través de la cual el punto de enlace de la VPC. AWS PrivateLink Para obtener más información, consulte ElastiCache Puntos finales de VPC de API e interfaz ()AWS PrivateLink.
Qué puntos de conexión usar con Valkey o Redis OSS.
-
En el caso de un nodo independiente, utilice el punto final del nodo para las operaciones de lectura y escritura.
-
Para los clústeres de Valkey, Valkey o Redis OSS (modo de clúster desactivado), utilice el punto final principal para todas las operaciones de escritura. Use el punto de conexión de lector para dividir de manera uniforme las conexiones entrantes al punto de enlace entre todas las réplicas de lectura. Use los puntos de conexión del nodo para las operaciones de lectura (en la API/CLI, estas se denominan puntos de conexión de lectura).
-
En el caso de los clústeres OSS (modo de clúster activado) de Valkey o Redis, utilice el punto de conexión de configuración del clúster para todas las operaciones que admitan comandos activados en modo de clúster. Debe utilizar un cliente que sea compatible con Valkey Cluster o con Redis OSS Cluster en Redis OSS 3.2 y versiones posteriores. También podrá realizar operaciones de lectura desde puntos de conexión de nodos individuales (en la API/CLI, estas se denominan puntos de conexión de lectura).
Las secciones siguientes le guiarán en el proceso de detección de los puntos de conexión que necesitará para el motor que esté usando.
Qué terminales usar con Memcached.
Para la caché ElastiCache sin servidor de Memcached, basta con adquirir el DNS y el puerto del punto final del clúster desde la consola.
Desde allí AWS CLI, utilice el describe-serverless-caches comando para obtener la información del punto final.
Linux
aws elasticache describe-serverless-caches --serverless-cache-name CacheName
Windows
aws elasticache describe-serverless-caches --serverless-cache-name CacheName
La salida de la operación anterior tendrá un aspecto similar al siguiente (formato 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" } ] }
En el caso de un clúster de Memcached basado en instancias, si utiliza Automatic Discovery, puede utilizar el punto final de configuración del clúster para configurar su cliente de Memcached. Esto significa que debe usar un cliente que admita la función de detección automática.
Si opta por no usar la función de detección automática, deberá configurar su cliente para usar los puntos de conexión individuales para las operaciones de lectura y escritura. También deberá realizar un seguimiento conforme agregue y elimine nodos.
Si un clúster de Valkey, Valkey o Redis OSS (modo de clúster desactivado) tiene solo un nodo, el punto final del nodo se utiliza tanto para las lecturas como para las escrituras. Si un clúster de Valkey, Valkey o Redis OSS (modo de clúster desactivado) tiene varios nodos, hay tres tipos de puntos finales: el punto final principal, el punto final del lector y los puntos finales del nodo.
El punto de conexión principal es un nombre de DNS que siempre se resuelve en el nodo principal del clúster. El punto de conexión principal es inmune a los cambios en el clúster, como la promoción de una réplica de lectura a la función principal. Para una actividad de escritura, recomendamos que sus aplicaciones se conecten al punto de conexión principal.
Un punto final del lector dividirá equitativamente las conexiones entrantes al punto final entre todas las réplicas de lectura de un clúster de OSS para Redis. ElastiCache Factores adicionales como cuando la aplicación crea las conexiones o cómo la aplicación (re)utiliza las conexiones determinará la distribución del tráfico. Los puntos de enlace de lector se mantienen actualizados con los cambios del clúster en tiempo real cuando se añaden o eliminan réplicas. Puede colocar las múltiples réplicas ElastiCache de lectura de su clúster OSS de Redis en diferentes zonas de AWS disponibilidad (AZ) para garantizar una alta disponibilidad de los puntos finales de los lectores.
nota
Un punto de conexión del lector no es un equilibrador de carga. Se trata de un registro de DNS que se resolverá en una dirección IP de uno de los nodos de réplica en forma de turno rotativo.
Para la actividad de lectura, las aplicaciones pueden conectarse también a cualquier nodo del clúster. A diferencia del punto de conexión principal, los puntos de conexión de nodo se resuelven en puntos de enlace específicos. Si realiza un cambio en su clúster, como añadir o eliminar una réplica, debe actualizar los puntos de enlace del nodo en su aplicación.
Para encontrar los puntos finales de un clúster de Valkey, Valkey o Redis OSS (modo de clúster desactivado)
-
Inicie sesión en AWS Management Console y abra la consola en. ElastiCache https://console.aws.amazon.com/elasticache/
-
En el panel de navegación, elija Clústeres de Valkey o Clústeres de Redis OSS.
Aparecerá la pantalla de clústeres con una lista de clústeres de Valkey, Valkey o Redis OSS (modo de clúster desactivado) y de Valkey o Redis OSS (modo de clúster activado).
-
Para buscar los puntos de conexión principal o de lector, elija el nombre del clúster (no el botón a su izquierda).
Puntos de conexión principales y de lectura para un clúster de Valkey, Valkey o Redis OSS (modo de clúster desactivado)
Si el clúster tiene solo un nodo, quiere decir que no hay punto de conexión principal y, por lo tanto, puede continuar con el paso siguiente.
-
Si el clúster de Valkey, Valkey o Redis OSS (modo de clúster desactivado) tiene nodos de réplica, puede encontrar los puntos finales de los nodos de réplica del clúster seleccionando el nombre del clúster y, a continuación, seleccionando la pestaña Nodos.
Aparecerá la pantalla de nodos con los nodos del clúster, principal y réplicas; cada uno con su punto de conexión.
Puntos de enlace de nodo de un clúster de Valkey, Valkey o Redis OSS (modo de clúster desactivado)
-
Para copiar un punto de conexión al portapapeles:
-
Un punto de conexión cada vez, encuentre el punto de conexión que desea copiar.
-
Elija el icono de copia directamente delante del punto de conexión.
El punto de conexión se ha copiado ahora en el portapapeles. Para obtener información sobre el uso del punto de conexión a fin de conectarse a un nodo, consulte Conexión a los nodos de Memcached.
-
El punto final principal de Valkey, Valkey o Redis OSS (modo de clúster desactivado) tiene un aspecto similar al siguiente. Existe una diferencia dependiendo de si está habilitado el cifrado en tránsito o no lo está.
Cifrado en tránsito no habilitado
clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port
redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379Cifrado en tránsito habilitado
master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port
master.ncit.ameaqx.use1.cache.amazonaws.com:6379Un clúster de Valkey o Redis OSS (modo de clúster habilitado) tiene un único punto de conexión de configuración. Al conectarse al punto de conexión de configuración, la aplicación puede detectar los puntos de conexión principal y de lectura de cada partición del clúster.
Búsqueda de puntos de conexión del clúster de Valkey o Redis OSS (modo de clúster habilitado)
-
Inicie sesión en AWS Management Console y abra la consola en ElastiCache . https://console.aws.amazon.com/elasticache/
-
En el panel de navegación, elija Clústeres de Valkey o Clústeres de Redis OSS.
Aparecerá la pantalla de clústeres con una lista de clústeres. Haga clic en el clúster al que desea conectarse.
-
Para buscar el punto de conexión de configuración del clúster, elija el nombre del clúster (no el botón de opción).
-
El Configuration endpoint (Punto de conexión de configuración) se muestra en Cluster details(Detalles de clúster). Para copiarlo, elija el ícono copiar a la izquierda del punto de conexión.
Todos los puntos de conexión de Memcached son de lectura/escritura. Para conectarse a los nodos de un clúster de Memcached, su aplicación puede usar los puntos de conexión de cada nodo o el punto de conexión de configuración del clúster con la función de detección automática. Para usar la función de detección automática, debe usar un cliente que admita la función de detección automática.
Cuando se usa la función de detección automática, la aplicación cliente se conecta a su clúster de Memcached mediante el punto de conexión de configuración. A medida que amplíe su clúster agregando o quitando nodos, su aplicación "sabrá" automáticamente los nodos que hay en el clúster y se podrá conectar a cualquiera de ellos. Sin la función de detección automática, su aplicación tendría que averiguar los nodos existentes o tendría que actualizar manualmente los puntos de conexión de su aplicación cada vez que se agrega o quita un nodo.
Para copiar un punto de conexión, elija el icono de copia situado justo delante de la dirección del punto de conexión. Para obtener información sobre el uso del punto de conexión a fin de conectarse a un nodo, consulte Conexión a los nodos de Memcached.
Los puntos de conexión de configuración y del nodo son muy similares. A continuación se muestran las diferencias resaltadas en negrita.
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 importante
Si decide crear un CNAME para su punto de conexión de Memcached, para que el cliente de detección automática reconozca el CNAME como un punto de conexión de configuración, deberá incluir .cfg. en el CNAME.
En el caso de Memcached, puede utilizar AWS CLI Amazon ElastiCache para descubrir los puntos finales de los nodos y los clústeres.
Para Redis OSS, puede usar Amazon AWS CLI ElastiCache para descubrir los puntos finales de los nodos, los clústeres y también los grupos de replicación.
Temas
Búsqueda de puntos de conexión para nodos y clústeres (AWS CLI)
Puede utilizar el AWS CLI para descubrir los puntos finales de un clúster y sus nodos con el comando. describe-cache-clusters Para clústeres de Valkey o Redis OSS, el comando devuelve el punto de conexión del clúster. Para clústeres de Memcached, el comando devuelve el punto de conexión de configuración. Si incluye el parámetro opcional --show-cache-node-info, el comando también devolverá los puntos de conexión de los nodos individuales del clúster.
El comando siguiente recupera el punto de conexión de configuración (ConfigurationEndpoint) y los puntos de conexión de nodos individuales (Endpoint) para el clúster de Memcached mycluster.
Para Linux, macOS o Unix:
aws elasticache describe-cache-clusters \ --cache-cluster-idmycluster\ --show-cache-node-info
Para Windows:
aws elasticache describe-cache-clusters ^ --cache-cluster-idmycluster^ --show-cache-node-info
La salida de la operación anterior tendrá un aspecto similar al siguiente (formato 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"
}
]
}importante
Si decide crear un CNAME para su punto de conexión de Memcached, a fin de que el cliente de detección automática reconozca el CNAME como un punto de conexión de configuración, deberá incluir .cfg. en el CNAME. Por ejemplo, incluya mycluster en el archivo php.ini en el parámetro .cfg.localsession.save_path.
Para Valkey o Redis OSS, el siguiente comando recupera información del clúster para el clúster de nodo único mycluster.
importante
El parámetro --cache-cluster-id se puede utilizar con el ID de clúster de Valkey o Redis OSS (modo de clúster deshabilitado) con un solo nodo o con los ID de un nodo específico de los grupos de replicación. El valor de --cache-cluster-id de un grupo de replicación es un valor de 4 dígitos; por ejemplo, 0001. Si --cache-cluster-id es la identificación de un clúster (nodo) de un grupo de replicación, replication-group-id se incluye en la salida.
Para Linux, macOS o Unix:
aws elasticache describe-cache-clusters \ --cache-cluster-idredis-cluster\ --show-cache-node-info
Para Windows:
aws elasticache describe-cache-clusters ^ --cache-cluster-idredis-cluster^ --show-cache-node-info
La salida de la operación anterior tendrá un aspecto similar al siguiente (formato 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"
}
]
}Para obtener más información, consulte el tema describe-cache-clusters.
Búsqueda de los puntos de conexión de los grupos de replicación de Valkey o Redis OSS (AWS CLI)
Puede utilizar el AWS CLI para descubrir los puntos finales de un grupo de replicación y sus clústeres con el describe-replication-groups comando. El comando devuelve el punto de conexión principal del grupo de reproducción y una lista de todos los clústeres (nodos) del grupo de reproducción con sus puntos de conexión, junto con el punto de conexión de lector.
La operación siguiente recupera el punto de conexión principal y el punto de conexión de lector para el grupo de reproducción myreplgroup. Use el punto de conexión principal para todas las operaciones de escritura.
aws elasticache describe-replication-groups \ --replication-group-idmyreplgroup
Para Windows:
aws elasticache describe-replication-groups ^ --replication-group-idmyreplgroup
La salida de esta operación anterior tendrá un aspecto similar al siguiente (formato 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": {}
}
]
}Para obtener más información, consulte describe-replication-groups en la Referencia de los comandos de AWS CLI .
En el caso de Memcached, puede utilizar la ElastiCache API de Amazon para descubrir los puntos finales de los nodos y los clústeres.
En el caso de Redis OSS, puede utilizar la ElastiCache API de Amazon para descubrir los puntos finales de los nodos, los clústeres y también los grupos de replicación.
Temas
Búsqueda de puntos de enlace para nodos y clústeres (API) ElastiCache
Puede usar la ElastiCache API para descubrir los puntos finales de un clúster y sus nodos con la DescribeCacheClusters acción. Para clústeres de Valkey o Redis OSS, el comando devuelve el punto de conexión del clúster. Para clústeres de Memcached, el comando devuelve el punto de conexión de configuración. Si incluye el parámetro opcional ShowCacheNodeInfo, la acción también devuelve los puntos de conexión de los nodos individuales del clúster.
Para Memcached, el comando siguiente recupera el punto de conexión de configuración (ConfigurationEndpoint) y los puntos de conexión de nodos individuales (Endpoint) para el clúster de 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>
importante
Si decide crear un CNAME para su punto de conexión de Memcached, a fin de que el cliente de detección automática reconozca el CNAME como un punto de conexión de configuración, deberá incluir .cfg. en el CNAME. Por ejemplo, incluya mycluster en el archivo php.ini en el parámetro .cfg.localsession.save_path.
Búsqueda de puntos finales para los grupos de replicación (API) de Valkey o Redis OSS ElastiCache
Con esta acción, puede utilizar la ElastiCache API para descubrir los puntos finales de un grupo de replicación y sus clústeres. DescribeReplicationGroups La acción devuelve el punto de conexión principal del grupo de reproducción y una lista de todos los clústeres del grupo de reproducción con sus puntos de enlace, junto con el punto de conexión de lector.
La siguiente operación recupera el punto final principal (PrimaryEndpoint), el punto final del lector (ReaderEndpoint) y los puntos finales del nodo individual (ReadEndpoint) del grupo de replicación. myreplgroup Use el punto de conexión principal para todas las operaciones de escritura.
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>
Para obtener más información, consulte DescribeReplicationGroups.
