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, siga estas etapas:
Etapa 1: 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)
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"
}
]
}
Etapa 2: Baixar 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
-
Faça login no Console de Gerenciamento da AWS e abra o console do ElastiCache em https://console.aws.amazon.com/elasticache/
. No console do ElastiCache, escolha ElastiCache Cluster Client (Cliente de cluster do ElastiCache), e depois escolha Download (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
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.
Etapa 3: 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.