Webdis (by Nicolas Favre-Félix) is a simple HTTP server which forwards commands to Redis and sends the reply back using a format of your choice. Accessing /COMMAND/arg0/arg1/.../argN[.ext] on Webdis executes the command on Redis and returns the response; the reply format can be changed with the optional extension (.json, .txt…).
Webdis implements ACL by IP/CIDR, by HTTP Auth or both with list of explicitly allowed or disallowed commands a client may use.
Documentation is available at author's site: http://webd.is/#http.
Start all-in-one (includes Redis):
docker run -d -p 7379:7379 -e LOCAL_REDIS=true anapsix/webdis
Link redis container manually and run:
docker run -d --name r4w redis
docker run -d -p 7379:7379 --link r4w:redis anapsix/webdis
Use Docker Compose:
docker-compose up
Try accessing it with curl:
-
directly:
curl http://127.0.0.1:7379/SET/hello/world curl http://127.0.0.1:7379/GET/hello -
or via haproxy:
curl http://127.0.0.1:8080/SET/hello/world curl http://127.0.0.1:8080/GET/hello
SUBSCRIBE endpoint triggers Segmentation fault, when aborting connection and hitting it again..
## Example
## Step 1 (in terminal session #1)
# start container
$ docker run -it --rm -p 7379:7379 -e LOCAL_REDIS=true w
## Step 2 (in terminal session #2)
# curl subscribe endpoint
$ curl 127.0.0.1:7379/subscribe/hello
## Step 3 (in terminal session #2)
# abort previous subscribe curl, and start new one
## Step 4 (in terminal session #1)
# check docker logs
$ docker run -it --rm -p 7379:7379 -e LOCAL_REDIS=true -e WEBSOCKETS=true w
installing redis-server..
starting local redis-server..
18:C 14 Dec 18:13:06.446 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
18:C 14 Dec 18:13:06.446 # Redis version=4.0.11, bits=64, commit=bca38d14, modified=0, pid=18, just started
18:C 14 Dec 18:13:06.446 # Configuration loaded
writing config..
starting webdis..
[22] 14 Dec 18:13:06 35 Webdis 0.1.5-dev up and running
[22] 14 Dec 18:13:08 0 /subscribe/hello
Segmentation fault
Make configurable via ENV/args