Redis Filter

In this example, we show how a Redis filter can be used with the Envoy proxy. The Envoy proxy configuration includes a Redis filter that routes egress requests to redis server.

Running the Sandboxes

The following documentation runs through the setup of both services.

Step 1: Install Docker

Ensure that you have a recent versions of docker and docker-compose.

A simple way to achieve this is via the Docker Desktop.

Step 2: Clone the Envoy repo and start all of our containers

If you have not cloned the Envoy repo, clone it with git clone git@github.com:envoyproxy/envoy or git clone https://github.com/envoyproxy/envoy.git

Terminal 1

  1. $ pwd
  2. envoy/examples/redis
  3. $ docker-compose pull
  4. $ docker-compose up --build -d
  5. $ docker-compose ps
  7.     Name                   Command               State                             Ports
  8. ------------------------------------------------------------------------------------------------------------------
  9. redis_proxy_1   /docker-entrypoint.sh /bin       Up      10000/tcp, 0.0.0.0:1999->1999/tcp, 0.0.0.0:8001->8001/tcp
  10. redis_redis_1   docker-entrypoint.sh redis       Up      0.0.0.0:6379->6379/tcp

Step 3: Issue Redis commands

Issue Redis commands using your favourite Redis client, such as redis-cli, and verify they are routed via Envoy.

Terminal 1

  1. $ redis-cli -h localhost -p 1999 set foo foo
  2. OK
  3. $ redis-cli -h localhost -p 1999 set bar bar
  4. OK
  5. $ redis-cli -h localhost -p 1999 get foo
  6. "foo"
  7. $ redis-cli -h localhost -p 1999 get bar
  8. "bar"

Step 4: Verify egress stats

Go to http://localhost:8001/stats?usedonly&filter=redis.egress_redis.command and verify the following stats:

  1. redis.egress_redis.command.get.total: 2
  2. redis.egress_redis.command.set.total: 2