View a markdown version of this page

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

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.

Uso de la detección automática

Para empezar a usar Auto Discovery con ElastiCache Memcached, sigue 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 finales mediante el AWS CLI para 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.r5.large"
        }
    ]
}

Descargue el ElastiCache Cluster Client

Para sacar el máximo partido a la función Auto Discovery, los programas cliente deben usar ElastiCache Cluster Client. El ElastiCache Cluster Client está disponible para Java, PHP y.NET y contiene toda la lógica necesaria para descubrir y conectarse a todos los nodos de la caché.

Para descargar el ElastiCache Cluster Client

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

  2. En la ElastiCache consola, seleccione ElastiCache Cluster Client y, a continuación, seleccione Descargar.

El código fuente del ElastiCache Cluster Client para Java está disponible en https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java. Esta biblioteca se basa en el popular cliente Spymemcached. El cliente de ElastiCache clúster se publica bajo 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

Para utilizar el cliente de ElastiCache clúster para PHP, primero tendrá que instalarlo en su instancia de Amazon EC2. Para obtener más información, consulte Instalación del cliente de ElastiCache clúster para PHP.

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

Para usar el cliente de ElastiCache clúster para .NET, primero tendrá que instalarlo en su instancia de Amazon EC2. Para obtener más información, consulte Instalación del cliente ElastiCache de clúster 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. En las siguientes secciones se muestra cómo usar el cliente de ElastiCache clúster 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.