Adicionando o Auto Discovery à sua biblioteca de cliente do Memcached - Amazon ElastiCache

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á.

Adicionando o Auto Discovery à sua biblioteca de cliente do Memcached

As informações de configuração do Auto Discovery são armazenadas de forma redundante em cada nó do cluster de cache Memcached. 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 Memcached ASCII e aos protocolos binários por ElastiCache, e é implementado no ElastiCache Cluster Client. 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 documentação a seguir se refere ao ASCII protocolo; no entanto, o config comando oferece suporte a ambos ASCII e ao binário. Se você quiser adicionar suporte à descoberta automática usando o protocolo binário, consulte o código-fonte do ElastiCache Cluster Client.

Sintaxe

config [sub-command] [key]

Opções

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 altere a chave “:clusterAmazonElastiCache”, pois é aqui que residem as informações de configuração do cluster. Se você sobrescrever essa chave, o cliente poderá ser configurado incorretamente por um breve período de tempo (não mais que 15 segundos) antes de atualizar ElastiCache 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 endereço IP privado CNAME e o endereço IP. Sempre CNAME estará presente; se o endereço IP privado não estiver disponível, ele não será exibido; no entanto, os caracteres de barra vertical "|" ainda serão 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.