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 puedes establecer una conexión privada entre los puntos finales de la VPC y la ElastiCache API creando un punto de enlace de la VPC de interfaz a través de él. AWS PrivateLink Para obtener más información, consulte ElastiCache Puntos finales de VPC de API e interfaz (AWS PrivateLink).
Puntos de conexión que se deben usar con Valkey o Redis OSS.
-
Para el Nodo independiente, use el punto de conexión del nodo para las operaciones de lectura y escritura.
-
En el caso de los clústeres de Valkey o Redis OSS (modo de clúster desactivado), utiliza 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. Utilice los puntos finales de nodo individuales para las operaciones de lectura (en API/CLI ellos se denominan puntos finales de lectura).
-
Para Clústeres de Valkey o Redis OSS (modo de clúster activado), utilice el Punto de conexión de configuración del clúster para todas las operaciones que admiten comandos del modo de clúster activado. Debe utilizar un cliente que sea compatible con Valkey Cluster o Redis OSS Cluster. Aún puede leer desde los puntos finales de los nodos individuales (en API/CLI ellos se denominan puntos finales 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.
Puntos de conexión que se deben usar con Memcached.
Para almacenar en caché ElastiCache sin servidor Memcached, basta con adquirir el DNS y el puerto del punto final del clúster desde la consola.
Desde el 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 usas la detección automática, puedes usar el punto final de configuración del clúster para configurar tu 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 o Redis OSS (modo de clúster desactivado) solo tiene un nodo, el punto final del nodo se usa tanto para la lectura como para la escritura. Si un clúster de 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 de lectura dividirá equitativamente las conexiones entrantes al punto final entre todas las réplicas de lectura de un ElastiCache clúster de OSS para Redis. 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 réplicas de lectura múltiple de su clúster de OSS ElastiCache para 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 de enlace de un clúster de Valkey o Redis OSS (modo de clúster desactivado)
-
Inicie sesión en Consola de administración de AWS 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 o Redis OSS (modo de clúster desactivado) y de Valkey o Redis OSS (modo de clúster activado).
-
Para encontrar los puntos finales del and/or lector principal del clúster, elija el nombre del clúster (no el botón de la izquierda).
Puntos finales principales y de lectura para un clúster de 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 o Redis OSS (modo de clúster desactivado) tiene nodos de réplica, puede encontrar los extremos 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 finales de nodo para un clúster de 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.
-
Un punto final principal de Valkey o Redis OSS (modo de clúster desactivado) tiene un aspecto similar al siguiente. Hay una diferencia en función de si el In-Transit cifrado está habilitado o no.
In-transit el cifrado no está habilitado
clusterName.xxxxxx.nodeId.regionAndAz.cache.amazonaws.com:port
redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379In-transit encriptación habilitada
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 Consola de administración de AWS y abra la ElastiCache consola en 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 finales de Memcached son puntos finales. read/write 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 el de Amazon AWS CLI ElastiCache para descubrir los puntos de enlace de los nodos y los clústeres.
En el caso de Redis OSS, puede utilizar el de Amazon AWS CLI ElastiCache para descubrir los puntos de enlace 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 (AWS CLI)
Puede utilizarla AWS CLI para descubrir los puntos finales de un clúster y sus nodos con el describe-cache-clusters comando. 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.
ejemplo
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.
ejemplo
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.redis7"
},
"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": "7.1",
"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 enlace para los grupos de replicación de Valkey o Redis OSS (AWS CLI)
Puede utilizarla AWS CLI para descubrir los puntos finales de un grupo de replicación y sus clústeres con el comando. describe-replication-groups 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 la AWS CLI .
En el caso de Memcached, puede usar 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 de enlace 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
Puedes 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.
ejemplo
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 de enlace para los grupos de replicación (API) de Valkey o Redis OSS ElastiCache
Con esta acción, puede usar 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 de los nodos individuales (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.
