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

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.

Qué puntos de conexión usar

Para la caché sin servidor de ElastiCache con Memcached, basta con adquirir el DNS del punto de conexión del clúster y el puerto desde la consola.

Desde AWS CLI, utilice el comando describe-serverless-caches para adquirir información sobre el punto de conexión.

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" } ] }

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.

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.

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.

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.

Puede utilizar la AWS CLI de Amazon ElastiCache para detectar los puntos de enlace de los nodos y los clústeres.

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 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-id mycluster \ --show-cache-node-info

Para Windows:

aws elasticache describe-cache-clusters ^ --cache-cluster-id mycluster ^ --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", } ] }
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.cfg.local en el archivo php.ini en el parámetro session.save_path.

Para obtener más información, consulte el tema describe-cache-clusters.

Puede utilizar la API de Amazon ElastiCache para detectar los puntos de enlace de los nodos y los clústeres.

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

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.cfg.local en el archivo php.ini en el parámetro session.save_path.