Uso di Individuazione automatica

Per iniziare a utilizzare Individuazione automatica, segui le fasi sottostanti:

• Fase 1: ottenere l'endpoint di configurazione

• Fase 2: scaricare il cluster del client ElastiCache

• Fase 3: modificare il programma dell'applicazione

Fase 1: ottenere l'endpoint di configurazione

Per connettersi a un cluster, i programmi client devono conoscere l'endpoint di configurazione del cluster. Consulta l'argomento Individuazione degli endpoint di un cluster (console)

Puoi anche utilizzare il comando aws elasticache describe-cache-clusters con il parametro --show-cache-node-info:

Qualunque sia il metodo utilizzato per trovare gli endpoint del cluster, l'indirizzo dell'endpoint di configurazione conterrà sempre .cfg.

Esempio Individuazione di endpoint utilizzando la AWS CLI per ElastiCache

Per Linux, macOS o Unix:

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

Per Windows:

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

Questa operazione genera un output simile al seguente (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"
        }
    ]
}

Fase 2: scaricare il cluster del client ElastiCache

Per sfruttare Individuazione automatica, i programmi client devono utilizzare il Client del cluster ElastiCache. Il Client del cluster ElastiCache è disponibile per Java, PHP e .NET e contiene tutta la logica necessaria per l'individuazione e la connessione a tutti i nodi di cache.

Download del client del cluster ElastiCache

1. Accedi alla console di gestione AWS e apri la console ElastiCache all'indirizzo https://console.aws.amazon.com/elasticache/.

2. Dalla console ElastiCache, scegli Client del cluster ElastiCache, quindi scegli Scarica.

Il codice fonte per il Client del cluster ElastiCache per Java è disponibile all'indirizzo https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java. Questa libreria è basata sul client Spymemcached di uso comune. Il Client del cluster ElastiCache viene rilasciato con licenza del software Amazon https://aws.amazon.com/asl. Sei libero di modificare il codice fonte come meglio credi. Puoi persino incorporare il codice in altre librerie Memcached open source o nel tuo codice client.

Nota

Per utilizzare il Client del cluster ElastiCache per PHP, devi innanzitutto installarlo sull'istanza Amazon EC2. Per ulteriori informazioni, consulta Installazione del client del cluster ElastiCache per PHP.

Per un client con supporto TLS, scarica il file binario con PHP versione 7.4 o superiore.

Per utilizzare il Client del cluster ElastiCache per .NET, devi innanzitutto installarlo sull'istanza Amazon EC2. Per ulteriori informazioni, consulta Installazione del client del cluster ElastiCache per .NET.

Fase 3: modificare il programma dell'applicazione

Modifica il programma dell'applicazione in modo che utilizzi Individuazione automatica. Nelle seguenti sezioni viene illustrato come utilizzare il Client del cluster ElastiCache per Java, PHP e .NET.

Importante

Durante la specifica dell'endpoint di configurazione del cluster, assicurati che l'indirizzo dell'endpoint contenga ".cfg" come mostrato qui. Non utilizzare un CNAME o un endpoint che non contiene ".cfg" al suo interno.

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

La mancata specifica esplicita dell'endpoint di configurazione del cluster determina la configurazione di un nodo specifico.