Uso de la detección automática - Amazon ElastiCache
Obtención del punto de conexión de configuraciónDescarga de ElastiCache Cluster ClientModificación de su programa de aplicación

Uso de la detección automática

Para empezar a usar la detección automática con ElastiCache para Memcached, siga estos pasos:

Obtención del punto de conexión de configuración

Para conectarse a un clúster, los programas cliente deben conocer el punto de conexión de configuración del clúster. Consulte el tema Búsqueda de puntos de conexión de un clúster (consola) (Memcached)

También puede usar el comando aws elasticache describe-cache-clusters con el parámetro --show-cache-node-info:

Sea cual sea el método que use para buscar los puntos de enlace del clúster, el punto de conexión de configuración siempre tendrá la cadena .cfg en su dirección.

ejemplo Búsqueda de puntos de enlace con la AWS CLI de ElastiCache

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

Esta operación produce un resultado similar al siguiente (formato JSON):

{
    "CacheClusters": [
        {
            "Engine": "memcached", 
            "CacheNodes": [
                {
                    "CacheNodeId": "0001", 
                    "Endpoint": {
                        "Port": 11211, 
                        "Address": "mycluster.fnjyzo.cfg.0001.use1.cache.amazonaws.com"
                    }, 
                    "CacheNodeStatus": "available", 
                    "ParameterGroupStatus": "in-sync", 
                    "CacheNodeCreateTime": "2016-10-12T21:39:28.001Z", 
                    "CustomerAvailabilityZone": "us-east-1e"
                }, 
                {
                    "CacheNodeId": "0002", 
                    "Endpoint": {
                        "Port": 11211, 
                        "Address": "mycluster.fnjyzo.cfg.0002.use1.cache.amazonaws.com"
                    }, 
                    "CacheNodeStatus": "available", 
                    "ParameterGroupStatus": "in-sync", 
                    "CacheNodeCreateTime": "2016-10-12T21:39:28.001Z", 
                    "CustomerAvailabilityZone": "us-east-1a"
                }
            ], 
            "CacheParameterGroup": {
                "CacheNodeIdsToReboot": [], 
                "CacheParameterGroupName": "default.memcached1.4", 
                "ParameterApplyStatus": "in-sync"
            }, 
            "CacheClusterId": "mycluster", 
            "PreferredAvailabilityZone": "Multiple", 
            "ConfigurationEndpoint": {
                "Port": 11211, 
                "Address": "mycluster.fnjyzo.cfg.use1.cache.amazonaws.com"
            }, 
            "CacheSecurityGroups": [], 
            "CacheClusterCreateTime": "2016-10-12T21:39:28.001Z", 
            "AutoMinorVersionUpgrade": true, 
            "CacheClusterStatus": "available", 
            "NumCacheNodes": 2, 
            "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", 
            "CacheSubnetGroupName": "default", 
            "EngineVersion": "1.4.24", 
            "PendingModifiedValues": {}, 
            "PreferredMaintenanceWindow": "sat:06:00-sat:07:00", 
            "CacheNodeType": "cache.r3.large"
        }
    ]
}

Descarga de ElastiCache Cluster Client

Para sacar el máximo partido a la detección automática, los programas de cliente deben utilizar ElastiCache Cluster Client. ElastiCache Cluster Client se encuentra disponible para Java, PHP y .NET, y contiene toda la lógica necesaria a fin de detectar todos los nodos de caché y conectarse a ellos.

Para descargar ElastiCache Cluster Client

  1. Inicie sesión en la consola de administración de AWS y abra la consola de ElastiCache en https://console.aws.amazon.com/elasticache/.

  2. Desde la consola de ElastiCache, elija ElastiCache Cluster Client y, a continuación, Download (Descargar).

El código fuente de ElastiCache Cluster Client para Java se encuentra disponible en https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java. Esta biblioteca se basa en el popular cliente Spymemcached. ElastiCache Cluster Client se encuentra sujeto a la licencia de software de Amazon https://aws.amazon.com/asl. Podrá modificar el código fuente de la manera que estime más conveniente. Podrá incluso incorporar el código a bibliotecas de Memcached de código abierto o al código de su propio cliente.

nota

A fin de utilizar ElastiCache Cluster Client para PHP, primero debe instalarlo en su instancia de Amazon EC2. Para obtener más información, consulte Instalación de ElastiCache Cluster Client para .PHP.

Para un cliente compatible con TLS, descargue el binario con PHP versión 7.4 o superior.

A fin de utilizar ElastiCache Cluster Client para .NET, primero debe instalarlo en su instancia de Amazon EC2. Para obtener más información, consulte Instalación de ElastiCache Cluster Client para .NET.

Modificación de su programa de aplicación

Modifique su programa de aplicación para que pueda usar la función Auto Discovery. Las siguientes secciones muestran cómo utilizar ElastiCache Cluster Client para Java, PHP y .NET.

importante

Cuando especifique el punto de conexión de la configuración del clúster, asegúrese de que el punto de conexión tenga la cadena ".cfg" en su dirección, tal como se muestra aquí. No use un CNAME o un punto de conexión que no tengan la cadena ".cfg". 

"mycluster.fnjyzo.cfg.use1.cache.amazonaws.com";

Si no especifica de forma explícita el punto de conexión de la configuración del clúster, realizará la configuración de un nodo específico.