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
<a name="AutoDiscovery.Using"></a>

Para começar a usar o Auto Discovery com ElastiCache o Memcached, siga estas etapas:
+ [Obter o endpoint de configuração](#AutoDiscovery.Using.ConfigEndpoint)
+ [Baixe o ElastiCache Cluster Client](#AutoDiscovery.Using.ClusterClient)
+ [Modificar seu programa aplicativo](#AutoDiscovery.Using.ModifyApp)

## Obter o endpoint de configuração
<a name="AutoDiscovery.Using.ConfigEndpoint"></a>

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)](Endpoints.md#Endpoints.Find.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.

**Example Encontrando endpoints usando o AWS CLI para 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 ElastiCache Cluster Client
<a name="AutoDiscovery.Using.ClusterClient"></a>

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

**Para baixar o ElastiCache Cluster Client**

1. Faça login no AWS Management Console e abra o ElastiCache console em [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. No ElastiCache console, escolha **ElastiCache Cluster Client** e escolha **Download**.

O código-fonte do ElastiCache Cluster Client for Java está disponível em [https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java](https://github.com/amazonwebservices/aws-elasticache-cluster-client-memcached-for-java). Essa biblioteca se baseia no popular cliente Spymemcached. O ElastiCache Cluster Client é lançado sob a licença de software da Amazon [https://aws.amazon.com/asl](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 ElastiCache Cluster Client para PHP, primeiro você precisará instalá-lo na sua instância do Amazon EC2. Para obter mais informações, consulte [Instalando o cliente de ElastiCache cluster para PHP](Appendix.PHPAutoDiscoverySetup.md).  
Para clientes compatíveis com TLS, baixe o binário com PHP versão 7.4 ou superior.  
Para usar o ElastiCache Cluster Client para.NET, primeiro você precisará instalá-lo na sua instância do Amazon EC2. Para obter mais informações, consulte [Instalando o cliente ElastiCache de cluster para.NET](Appendix.DotNETAutoDiscoverySetup.md).

## Modificar seu programa aplicativo
<a name="AutoDiscovery.Using.ModifyApp"></a>

Modifique seu programa aplicativo para que ele use a Descoberta automática. As seções a seguir mostram como usar o ElastiCache Cluster Client 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.