Búsqueda de puntos de conexión - Amazon ElastiCache para Redis

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 de conexión

Su aplicación se conecta a su clúster mediante puntos de conexión. Un punto de conexión es un nodo o la dirección única del clúster.

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.

Qué puntos de conexión usar
  • Nodo independiente de Redis. Use el punto de conexión del nodo para las operaciones de lectura y escritura.

     

  • Clústeres de Redis (modo de clúster deshabilitado), utilice el punto de conexión 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).

     

  • Clústeres de Redis (modo de clúster habilitado), utilice el punto de conexión de configuración del clúster para todas las operaciones que admiten comandos del modo de clúster habilitado. Debe usar un cliente que admita clústeres de Redis (Redis 3.2). 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.

Si un clúster de Redis (modo de clúster deshabilitado) solo tiene un nodo, el punto de conexión de dicho nodo es el que se utiliza tanto para las operaciones de lectura como de escritura. Si un clúster de Redis (modo de clúster deshabilitado) tiene varios nodos, hay tres tipos de punto de conexión: el punto de enlace principal, el punto de enlace del lector y los puntos de enlace de 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 de conexión del lector dividirá de manera uniforme las conexiones entrantes al punto de conexión entre todas las réplicas de lectura de un clúster de ElastiCache for 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 diferentes réplicas de lectura del clúster de ElastiCache for Redis en distintas zonas de disponibilidad (AZ) de AWS para garantizar la alta disponibilidad de los puntos de enlace del lector.

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 buscar puntos de enlace de un clúster de Redis (modo de clúster deshabilitado)
  1. Inicie sesión en la AWS Management Console y abra la consola de ElastiCache en https://console.aws.amazon.com/elasticache/.

  2. En el panel de navegación, seleccione Redis clusters (Clústeres Redis).

    Aparecerá la pantalla de clústeres con una lista de clústeres de Redis (modo de clúster deshabilitado) y Redis (modo de clúster habilitado).

  3. Para buscar los puntos de conexión principal o de lector, elija el nombre del clúster (no el botón a su izquierda).

    Imagen: punto de conexión principal de un clúster de Redis (modo de clúster deshabilitado)

    Puntos de enlace del lector y principales para un clúster de Redis (modo de clúster deshabilitado)

    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.

  4. Si el clúster de Redis (modo de clúster desactivado) tiene nodos de réplica, puede encontrar los puntos de conexión del nodo de réplica del clúster eligiendo el nombre del clúster y, a continuación, elegir la pestaña de Nodes (Nodos).

    Aparecerá la pantalla de nodos con los nodos del clúster, principal y réplicas; cada uno con su punto de conexión.

    Imagen: puntos de enlace del nodo de un clúster de Redis (modo de clúster deshabilitado)

    Puntos de enlace del nodo de un clúster de Redis (modo de clúster deshabilitado)

  5. Para copiar un punto de conexión al portapapeles:

    1. Un punto de conexión cada vez, encuentre el punto de conexión que desea copiar.

    2. 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.

Un punto de conexión principal de Redis (modo de clúster deshabilitado) tiene un aspecto parecido 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:6379

Cifrado en tránsito habilitado

master.clusterName.xxxxxx.regionAndAz.cache.amazonaws.com:port master.ncit.ameaqx.use1.cache.amazonaws.com:6379

Un clúster de Redis (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 fragmento del clúster.

Para buscar puntos de conexión del clúster de Redis (modo de clúster habilitado)
  1. Inicie sesión en la AWS Management Console y abra la consola de ElastiCache en https://console.aws.amazon.com/elasticache/.

  2. En el panel de navegación, seleccione Redis clusters (Clústeres Redis).

    Aparecerá la pantalla de clústeres con una lista de clústeres de Redis (modo de clúster deshabilitado) y Redis (modo de clúster habilitado). Elija el clúster de Redis (modo de clúster habilitado) al que desee conectarse.

  3. 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).

  4. 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.

Puede utilizar la AWS CLI de Amazon ElastiCache para detectar los puntos de enlace de los nodos, los clústeres y los grupos de reproducción.

Búsqueda de puntos de conexión para nodos y clústeres (AWS CLI)

Puede usar AWS CLI para detectar los puntos de enlace de un clúster y sus nodos con el comando describe-cache-clusters. Para clústeres de Redis, el comando devuelve el punto de conexión del clúster. 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 siguiente comando recupera información del cluster de Redis (modo de clúster deshabilitado) mycluster con un único nodo.

importante

El parámetro --cache-cluster-id se puede utilizar con el ID de clúster de Redis (modo de clúster deshabilitado) con un único nodo o con los ID de un nodo específico de los grupos de reproducción de Redis. El valor de --cache-cluster-id de un grupo de reproducción de Redis 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 reproducción de Redis, replication-group-id se incluye en la salida.

Para Linux, macOS o Unix:

aws elasticache describe-cache-clusters \ --cache-cluster-id redis-cluster \ --show-cache-node-info

Para Windows:

aws elasticache describe-cache-clusters ^ --cache-cluster-id redis-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 enlace de grupos de reproducción (AWS CLI)

Puede usar la AWS CLI para detectar los puntos de enlace de un grupo de reproducció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-id myreplgroup

Para Windows:

aws elasticache describe-replication-groups ^ --replication-group-id myreplgroup

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.

Puede utilizar la API de Amazon ElastiCache para detectar los puntos de enlace de los nodos, los clústeres y los grupos de reproducción.

Búsqueda de puntos de enlace para nodos y clústeres (API de ElastiCache)

Puede utilizar la API de ElastiCache para detectar los puntos de enlace de un clúster y sus nodos con la acción DescribeCacheClusters. Para clústeres de Redis, el comando devuelve el punto de conexión del clúster. 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.

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>

Búsqueda de los puntos de enlace de grupos de reproducción (API de ElastiCache)

Puede utilizar la API de ElastiCache para detectar los puntos de enlace de un grupo de reproducció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 operación siguiente recupera el punto de conexión principal (PrimaryEndpoint), el punto de conexión de lector (ReaderEndpoint) y los punto de conexión de nodo (ReadEndpoint) del grupo de reproducció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.