Agregar la función de detección automática a la biblioteca de su cliente - Amazon ElastiCache

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Agregar la función de detección automática a la biblioteca de su cliente

La información de configuración de la función Auto Discovery se almacena en cada nodo de clúster de caché de manera redundante. Las aplicaciones cliente pueden consultar cualquier nodo de caché y obtener la información de configuración para todos los nodos del clúster.

El modo en que una aplicación realiza esta consulta depende de la versión del motor de caché:

  • Si la versión del motor de caché es la 1.4.14 o superior, use el comando config.

  • Si la versión del motor de caché es inferior a la 1.4.14, use el comando get AmazonElastiCache:cluster.

Las salidas de estos dos comandos son idénticas y se describen en la sección Output Format (Formato de salida) siguiente.

Versión del motor de caché 1.4.14 o superior

Si la versión del motor de caché es la 1.4.14 o superior, use el comando config. ElastiCache ha agregado este comando a los protocolos binarios y ASCII de Memcached y dicho comando se implementa en ElastiCache Cluster Client. Si desea usar la función Auto Discovery con otra biblioteca de cliente, dicha biblioteca deberá ampliarse para ser compatible con el comando config.

nota

La documentación siguiente pertenece al protocolo ASCII; sin embargo, el comando config también admite el código ASCII y binario. Si desea agregar la detección automática mediante el protocolo binario, consulte el código fuente de ElastiCache Cluster Client.

Sintaxis

config [sub-command] [key]

Opciones

Nombre Descripción Obligatorio
sub-command

Subcomando que se usa para interactuar con un nodo de caché. Para la función Auto Discovery, el subcomando es get.

key

Clave en la que se almacena la configuración del clúster. Para la función Auto Discovery, la clave se denomina cluster.

Para obtener la información de configuración del clúster, use el comando siguiente:

config get cluster

Versión del motor de caché inferior a la 1.4.14

Para obtener la información de configuración del clúster, use el comando siguiente:

get AmazonElastiCache:cluster
nota

No modifique la clave "AmazonElastiCache: cluster", ya que en esta clave es donde reside la información de configuración del clúster. Si sobrescribe esta clave, la configuración del cliente será incorrecta durante un breve periodo (no más de 15 segundos). Transcurrido dicho periodo, ElastiCache actualizará y corregirá de forma automática la información de configuración.

Output Format (Formato de salida)

Tanto si usa config get cluster o get AmazonElastiCache:cluster, la respuesta se compone de dos líneas:

  • Número de versión de la información de configuración. Cada vez que se agrega o elimina un nodo del clúster de caché, el número de versión aumenta un valor.

  • Lista de nodos de caché. Cada nodo de la lista se representa con un grupo hostname|ip-address|port y cada se delimita con un espacio.

Al final de cada línea encontrará un retorno de carro y un carácter de salto de línea (CR + LF). La línea de datos contiene un carácter de salto de línea (LF) y se le agregan el retorno de carro y el carácter de salto de línea (CR + LF). La línea de la versión de configuración termina con el carácter de salto de línea (LF) sin retorno de carro (CR).

A continuación se muestra cómo se representaría un clúster de caché con tres nodos:

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

Cada nodo se muestra con el CNAME y la dirección IP privada. El CNAME siempre estará presente; si la dirección IP privada no está disponible, esta no se mostrará, aunque sí se imprimirán los caracteres de barra vertical "|".

ejemplo

A continuación se muestra un ejemplo de la carga que se obtiene al consultar la información de configuración:

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
  • La segunda línea indica que la información de configuración se ha modificado doce veces hasta el momento.

  • En la tercera línea, la lista de nodos se muestra por orden alfabético según el nombre de host. Este orden puede ser distinto del que usa actualmente en su aplicación cliente.