Utilisation de la découverte automatique

Pour commencer à utiliser la découverte automatique, suivez la procédure suivante :

• Étape 1 : Obtenir le point de terminaison de configuration

• Étape 2 : Télécharger le client de cluster ElastiCache

• Étape 3 : Modifier votre programme d'application

Étape 1 : Obtenir le point de terminaison de configuration

Pour se connecter à un cluster, les programmes clients doivent connaître le point de terminaison de configuration du cluster. Consultez la rubrique Recherche des points de terminaison d'un cluster (console)

Vous pouvez également utiliser la commande aws elasticache describe-cache-clusters avec le paramètre --show-cache-node-info :

Quelle que soit la méthode que vous utilisez pour trouver les points de terminaison du cluster, le point de terminaison de configuration aura toujours .cfg dans son adresse.

Exemple Recherche de points de terminaison à l'aide de la AWS CLI pour ElastiCache

Pour Linux, macOS ou Unix :

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

Pour Windows :

aws elasticache describe-cache-clusters ^
    --cache-cluster-id mycluster ^
    --show-cache-node-info

Cette opération produit une sortie similaire à la sortie suivante (format 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"
        }
    ]
}

Étape 2 : Télécharger le client de cluster ElastiCache

Pour pouvoir bénéficier de la découverte automatique, les programmes clients doivent utiliser le client de cluster ElastiCache. Le client de cluster ElastiCache est disponible pour Java, PHP et .NET et contient toute la logique nécessaire pour découvrir et se connecter à tous vos nœuds de cache.

Pour télécharger le client de cluster ElastiCache

1. Connectez-vous à la Console de gestion AWS et ouvrez la console ElastiCache à l'adresse https://console.aws.amazon.com/elasticache/.

2. Dans la console ElastiCache, choisissez ElastiCache Cluster Client (Client de cluster), puis Télécharger.

Le code source du client de cluster ElastiCache pour Java est disponible à l'adresse https://github.com/amazonwebservices/aws-ElastiCache-cluster-client-memcached-for-java. Cette bibliothèque est basée sur le client Spymemcached populaire. Le client de cluster ElastiCache est publié sous la licence Amazon Software https://aws.amazon.com/asl. Vous êtes libre de modifier le code source selon vos besoins. Vous pouvez même incorporer le code dans d'autres bibliothèques Memcached open source, ou dans votre propre code client.

Note

Pour utiliser le client de cluster ElastiCache pour PHP, vous devez d'abord l'installer sur votre instance Amazon EC2. Pour de plus amples informations, veuillez consulter Installation du client de cluster ElastiCache pour .NET.

Pour un client qui prend en charge TLS, téléchargez le binaire avec PHP version 7.4 ou supérieure.

Pour utiliser le client de cluster ElastiCache pour .NET, vous devez d'abord l'installer sur votre instance Amazon EC2. Pour de plus amples informations, veuillez consulter Installation du client de cluster ElastiCache pour .NET.

Étape 3 : Modifier votre programme d'application

Modifiez votre programme d'application afin qu'il utilise la découverte automatique. Les sections suivantes expliquent comment utiliser le client de cluster ElastiCache pour Java, PHP et .NET.

Important

Lorsque vous spécifiez le point de terminaison de configuration du cluster, assurez-vous que le point de terminaison a « .cfg » dans son adresse comme illustré ici. N'utilisez pas un CNAME ou un point de terminaison sans « .cfg ».

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

Si vous ne spécifiez pas explicitement le point de terminaison de configuration du cluster, la configuration se fait sur un nœud spécifique.