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.
Qué puntos finales usar con Valkey o Redis OSS
-
nodo independiente, utilice el punto final del nodo para las operaciones de lectura y escritura.
-
Los clústeres de Valkery, Valkey o Redis OSS (modo de clúster desactivado) utilizan 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 los nodos individuales para las operaciones de lectura (enAPI/, se CLI denominan puntos finales de lectura).
-
En los clústeres de Valkey o Redis OSS (modo de clúster activado), se utiliza el punto de conexión de configuración del clúster para todas las operaciones que admiten comandos activados en modo de clúster. Debe utilizar un cliente que sea compatible con Valkey Cluster o Redis OSS Cluster (Redis 3.2). OSS Aún puede leer desde los puntos finales de los nodos individuales (en laAPI/, se CLI 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.
¿Qué puntos finales usar con Memcached
Para la caché ElastiCache sin servidor con Memcached, basta con adquirir el puerto y el punto final DNS 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
El resultado de la operación anterior debería tener un aspecto similar al siguiente (JSONformato):
{ "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" } ] }
Para un clúster de Memcached basado en instancias, si usa la función de detección automática, puede usar el punto de conexión de configuración del clúster para configurar el 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 Valkery, Valkey o Redis OSS (modo de clúster desactivado) tiene un solo nodo, el punto final del nodo se utiliza tanto para las lecturas como para las escrituras. Si un clúster de Valkery, 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 final principal es un DNS nombre que siempre se traduce 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 ElastiCache (RedisOSS). 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 de lectura de su clúster ElastiCache (RedisOSS) en diferentes zonas de disponibilidad (AZ) para garantizar una alta AWS 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 DNS registro que se convierte en una dirección IP de uno de los nodos de la réplica de forma rotativa.
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 Valkery, 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, selecciona clústeres de Valkey o clústeres de Redis OSS.
Aparecerá la pantalla de clústeres con una lista de clústeres de Valkery, Valkey o Redis OSS (modo de clúster desactivado) y de Valkey o OSS Redis (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 enlace principales y de lectura para un clúster de Valkery, Valkey o Redis (modo de clúster desactivado) OSS
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 Valkery, 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 para un clúster de Valkery, Valkey o Redis (modo de clúster desactivado) OSS
-
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 nodos de Memcached.
-
Un punto final principal de Valkery, 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 activado) tiene un único punto final 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.
Para encontrar el punto final de un clúster de Valkey o Redis OSS (modo de clúster activado)
-
Inicie sesión en AWS Management Console y abra la ElastiCache consola en. https://console.aws.amazon.com/elasticache/
-
En el panel de navegación, selecciona 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 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 opta CNAME por crear un punto final de configuración de Memcached, para que su cliente de detección automática lo reconozca CNAME como punto final de configuración, debe incluirlo en el. .cfg. CNAME
En el caso de Memcached, puede utilizar AWS CLI Amazon ElastiCache para descubrir los puntos finales de los nodos y los clústeres.
En el caso de Redis, puede utilizar 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 En el caso de los OSS clústeres de Valkey o Redis, el comando devuelve el punto final 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
El resultado de la operación anterior debería tener un aspecto similar al siguiente (JSONformato).
{
"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 opta CNAME por crear un punto final de configuración de Memcached, para que su cliente de detección automática lo reconozca CNAME como punto final de configuración, debe incluirlo .cfg. en el. CNAME Por ejemplo, incluya mycluster en el archivo php.ini en el parámetro .cfg.localsession.save_path.
En el caso de Valkey y RedisOSS, el siguiente comando recupera la información del clúster mycluster de un solo nodo.
importante
El parámetro se --cache-cluster-id puede usar con un identificador de clúster de Valkey o Redis OSS (modo de clúster desactivado) de nodo único o con identificadores de nodos específicos en los grupos de replicación. El --cache-cluster-id de un grupo de replicación es un valor de 4 dígitos, como. 0001 Si --cache-cluster-id es el identificador de un clúster (nodo) de un grupo de replicación, replication-group-id se incluye en el resultado.
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
El resultado de la operación anterior debería tener un aspecto similar al siguiente (JSONformato).
{
"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 finales de los grupos de OSS replicación de Valkey o Redis ()AWS CLI
Puede utilizar el 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
El resultado de esta operación debería tener un aspecto similar al siguiente (JSONformato).
{
"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-groupsla Referencia de AWS CLI comandos.
En el caso de Memcached, puede utilizar Amazon ElastiCache API para descubrir los puntos finales de los nodos y los clústeres.
En el caso de Redis, puede utilizar Amazon ElastiCache API para descubrir los puntos finales de los nodos, los clústeres y también los grupos de replicación.
Temas
Búsqueda de puntos finales para nodos y clústeres () ElastiCache API
Puede utilizarla ElastiCache API para descubrir los puntos finales de un clúster y sus nodos con la DescribeCacheClusters acción. En el caso de los OSS clústeres de Valkey o Redis, el comando devuelve el punto final 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.
En el caso de Memcached, el siguiente comando recupera el punto final de configuración (ConfigurationEndpoint) y los puntos finales de los nodos individuales () del clúster mycluster de Memcached. Endpoint
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 opta CNAME por crear un punto final de configuración de Memcached, para que su cliente de detección automática lo reconozca CNAME como punto final de configuración, debe incluirlo .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 conexión para los grupos de replicación de Valkey o OSS Redis () ElastiCache API
Puede utilizarla ElastiCache API para descubrir los puntos finales de un grupo de replicación y sus clústeres con la acción. 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
