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 Envoy described above.

Step 1: Install Docker

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

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

Step 2: Clone the Envoy repo

If you have not cloned the Envoy repo, clone it with:

SSH

HTTPS

  1. git clone git@github.com:envoyproxy/envoy
  1. git clone https://github.com/envoyproxy/envoy.git

Step 3: Build the sandbox

Terminal 1

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

Step 4: 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 5: 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