Redis2

El módulo redis2 proporciona la capacidad de interactuar con un servidor Redis 2.x. Implementa el protocolo Redis 2.0 unificado completo, incluyendo soporte para pipelining de Redis.

Instalación

Para instalar el módulo, use uno de los siguientes paquetes:

• Angie: angie-module-redis2

• Angie PRO: angie-pro-module-redis2

Carga del módulo

Para trabajar con el módulo, debe cargarse en el contexto main{}. El ejemplo a continuación también usa directivas del módulo set-misc:

load_module modules/ndk_http_module.so;
load_module modules/ngx_http_set_misc_module.so;
load_module modules/ngx_http_redis2_module.so;

Ejemplo de configuración

upstream redis_upstream {
    server 127.0.0.1:6379;
}

server {
    listen       80;
    server_name  localhost;

    # Establecer valor de clave
    location /foo {
        set $value 'first';
        redis2_query set one $value;
        redis2_pass redis_upstream;
    }

    # Obtener valor por clave
    location /bar {
        redis2_query get one;
        redis2_pass redis_upstream;
    }

    # Establecer valor de clave desde parámetros de consulta
    location /set {
        set_unescape_uri $key $arg_key;
        set_unescape_uri $val $arg_val;
        redis2_query set $key $val;
        redis2_pass 127.0.0.1:6379;
    }

    # Obtener valor por clave desde parámetros de consulta
    location /get {
        set_unescape_uri $key $arg_key;
        redis2_query get $key;
        redis2_pass 127.0.0.1:6379;
    }

    # Ejecutar múltiples comandos en pipeline
    location /pipeline {
        set $value 'first';
        redis2_query set one $value;
        redis2_query get one;
        redis2_query set one 'first first';
        redis2_query get one;
        redis2_pass 127.0.0.1:6379;
    }

    # Ejecutar comando arbitrario pasado en parámetro de consulta
    location /cmd {
        set_unescape_uri $cmd $arg_command;
        redis2_raw_query "$cmd\r\n";
        redis2_pass 127.0.0.1:6379;
    }
}

Advertencia

¡Importante! A diferencia de la directiva proxy_pass en Angie, no está permitido usar variables en el parámetro de la directiva redis2_pass.

Demostración de ejecución de solicitudes

Ejemplos de trabajo con el módulo.

$ curl localhost/foo
+OK

$ curl localhost/bar
$5
first

Aquí $5 es la longitud del valor (5 bytes), y first es el valor mismo.

$ curl 'localhost/set/?key=two&val=second%20value'
+OK

$ curl 'localhost/get/?key=two'
$12
second value

$ curl 'localhost/get/?key=three'
$-1

El valor $-1 indica que la clave three no existe.

$ curl localhost/pipeline
+OK
$5
first
+OK
$11
first first

Ejecutando comandos Redis arbitrarios:

$ curl 'localhost/cmd/?command=set%20three%20"third%20value"'
+OK

$ curl 'localhost/cmd/?command=get%20three'
$11
third value

Información adicional

La documentación detallada y el código fuente están disponibles en: openresty/redis2-nginx-module.