# docker-webdis

**Repository Path**: xiagw/docker-webdis

## Basic Information

- **Project Name**: docker-webdis
- **Description**: Webdis in a tiny Docker container 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-04-23
- **Last Updated**: 2022-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![](https://img.shields.io/docker/automated/anapsix/webdis.svg)](https://hub.docker.com/r/anapsix/webdis)  
[![Docker Pulls](https://img.shields.io/docker/pulls/anapsix/webdis.svg?style=round-square)](https://hub.docker.com/r/anapsix/webdis/)

[Webdis](http://webd.is) (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](http://webd.is/#http).

## Usage

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

## Known Issues
`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
```

## TODO
Make configurable via ENV/args