Adicionar a Descoberta automática à sua biblioteca de clientes

As informações de configuração para Descoberta automática são armazenadas de forma redundante em cada nó de cluster de cache. Os aplicativos cliente podem consultar qualquer nó de cache e obter as informações de configuração para todos os nós no cluster.

A maneira como um aplicativo faz isso depende da versão do mecanismo de cache:

• Se a versão do mecanismo de cache for 1.4.14 ou superior, use o comando config.

• Se a versão do mecanismo de cache for inferior a 1.4.14, use o comando get AmazonElastiCache:cluster.

As saídas desses dois comandos são idênticas e estão descritas na seção Output Format abaixo.

Versão do mecanismo de cache 1.4.14 ou superior

Para o mecanismo de cache versão 1.4.14 ou superior, use o comando config. Esse comando foi adicionado ao protocolos ASCII e binários do Memcached pelo ElastiCache, e é implementado no cliente de cluster do ElastiCache. Se você quiser usar a Descoberta automática com outra biblioteca de cliente, essa biblioteca precisará ser estendida para oferecer suporte ao comando config.

nota

A seguinte documentação pertence ao protocolo ASCII. No entanto, o comando config oferece suporte para ASCII e binário. Se você deseja adicionar suporte para Descoberta automática usando o protocolo binário, consulte o código-fonte do cliente de cluster do ElastiCache.

Sintaxe

config [sub-command] [key]

Opções

Name (Nome)	Descrição	Obrigatório
sub-command	O subcomando usado para interagir com um nó de cache. Para a Descoberta automática, esse subcomando é get.	Sim
key	A chave na qual a configuração de cluster está armazenada. Para a Descoberta automática, essa chave se chama cluster.	Sim

Para obter as informações de configuração do cluster, use o seguinte comando:

config get cluster

Versão do mecanismo de cache inferior a 1.4.14

Para obter as informações de configuração do cluster, use o seguinte comando:

get AmazonElastiCache:cluster

nota

Não manipule a chave "AmazonElastiCache: cluster", uma vez que ela é onde as informações de configuração de cluster residem. Se você substituir essa chave, o cliente poderá ser incorretamente configurado por um curto período (não mais de 15 segundos) antes que o ElastiCache atualize automaticamente e corretamente as informações de configuração.

Output Format

Se você usar config get cluster ou get AmazonElastiCache:cluster, a resposta consistirá em duas linhas:

• O número de versão das informações de configuração. Cada vez que um nó é adicionado ou removido do cluster de cache, o número da versão aumenta em um.

• Uma lista de nós de cache. Cada nó na lista é representado por um grupo de nome do host|endereço IP|porta, e cada nó é delimitado por um espaço.

Um retorno de carro e um caractere de avanço de linha (CR + LF) aparecem no final de cada linha. A linha de dados contém um caractere de avanço de linha (LF) no final, ao qual o CR+LF é adicionado. A linha de versão de configuração é encerrada por LF sem o CR.

Um cluster de cache contendo três nós seria representado da seguinte maneira:

configversion\n
hostname|ip-address|port hostname|ip-address|port hostname|ip-address|port\n\r\n

Cada nó é mostrado com o CNAME e o endereço IP privado. O CNAME sempre estará presente. Se o endereço IP privado não estiver disponível, ele não será mostrado. Entretanto, os caracteres de barra vertical "|" continuarão a ser impressos.

exemplo

Veja a seguir um exemplo da carga útil retornada quando você consulta as informações de configuração:

CONFIG cluster 0 136\r\n
12\n
myCluster.pc4ldq.0001.use1.cache.amazonaws.com|10.82.235.120|11211 myCluster.pc4ldq.0002.use1.cache.amazonaws.com|10.80.249.27|11211\n\r\n 
END\r\n

nota

• A segunda linha indica que as informações de configuração foram modificadas doze vezes até agora.

• Na terceira linha, a lista de nós está em ordem alfabética por nome de host. Essa ordem pode estar em uma sequência diferente da que você está usando no seu aplicativo cliente.