Como usar a Descoberta automática - Amazon ElastiCache
Obter o endpoint de configuraçãoBaixe o cliente de cluster do ElastiCacheModificar seu programa aplicativo

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como usar a Descoberta automática

Para começar a usar a Descoberta automática com o ElastiCache para Memcached, siga estas etapas:

Obter o endpoint de configuração

Para se conectar a um cluster, os programas cliente devem conhecer o endpoint de configuração de cluster. Consulte o tópico Localização de endpoints de um cluster (console) (Memcached)

Você também pode usar o comando aws elasticache describe-cache-clusters com o parâmetro --show-cache-node-info:

Seja qual for o método usado para encontrar os endpoints do cluster, o endpoint de configuração sempre terá .cfg em seu endereço.

exemplo Localização de endpoints usando a AWS CLI para o ElastiCache

Para Linux, macOS ou 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 operação produz uma saída semelhante à seguinte (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"
        }
    ]
}

Baixe o cliente de cluster do ElastiCache

Para tirar proveito da Descoberta automática, os programas cliente devem usar o cliente de cluster do ElastiCache. O cliente de cluster do ElastiCache está disponível para Java, PHP e .NET e contém toda a lógica necessária para descobrir e conectar-se a todos os seus nós de cache.

Para baixar o cliente de cluster do ElastiCache

  1. Faça login no Console de Gerenciamento da AWS e abra o console do ElastiCache em https://console.aws.amazon.com/elasticache/.

  2. No console do ElastiCache, escolha Cliente de cluster do ElastiCache, e depois escolha Baixar.

O código-fonte do cliente de cluster do ElastiCache para Java está disponível em https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java. Essa biblioteca se baseia no popular cliente Spymemcached. O cliente de cluster do ElastiCache é lançado sob a Licença de software da Amazon https://aws.amazon.com/asl. Você tem a liberdade de modificar o código-fonte como você bem entender. Você pode até mesmo incorporar o código em outras bibliotecas Memcached de código aberto ou no seu próprio código de cliente.

nota

Para usar o cliente de cluster do ElastiCache para PHP, você precisa primeiro instalá-lo na sua instância do Amazon EC2. Para obter mais informações, consulte Instalação do cliente de cluster do ElastiCache para PHP.

Para clientes compatíveis com TLS, baixe o binário com PHP versão 7.4 ou superior.

Para usar o cliente de cluster do ElastiCache para .NET, você precisa primeiro instalá-lo na sua instância do Amazon EC2. Para obter mais informações, consulte Instalação do cliente de cluster do ElastiCache para .NET.

Modificar seu programa aplicativo

Modifique seu programa aplicativo para que ele use a Descoberta automática. As seções a seguir mostram como usar o cliente de cluster do ElastiCache para Java, PHP e .NET.

Importante

Ao especificar o endpoint de configuração do cluster, certifique-se de que o endpoint tenha ".cfg" em seu endereço, conforme mostrado aqui. Não use um CNAME ou um endpoint sem ".cfg". 

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

Se o endpoint de configuração de cluster não for especificado explicitamente, a configuração ocorrerá para um nó específico.