A naive http server container that tells who is serving your requests.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



A minimal(5.0MB+) docker image with a http server that echos hostname(identifies itself) with health check support.

This docker image can be used to demostrate and validate load balance ability of your service.


Run a simple server

$ docker run -d --name echo -p 80:3000 cizixs/whoami
$ curl

By default container exposes port 3000, and returns container hostname(short id) as response.

Control what is returned

You can control what is returned by setting MESSAGE environment variable(the following example is illustrated under docker 1.12 swarm mode):

➜  docker service create -e MESSAGE="viola" -p 3000:3000 --replicas=2 whoami:v0.4
➜  curl
viola from bf8cf715445d
➜  curl
viola from 15d94216ff07

Check the logs

And every container outputs requests to stdout, which is accessible by standard docker logs:

➜  docker logs bf8cf7
2016/11/04 03:25:35 start serving...
2016/11/04 03:25:51 [GET] at "/" takes 41.015µs
2016/11/04 03:25:53 [GET] at "/" takes 26.656µs

Health Check

whoami exposes a health check endpoint at /health, which tells you if the service is working well. If the service is ok, it will return ok with status 200, otherwise it will return Oops! with status 500. You can toggle the health status by send a post request to /toggle.hz:

➜  curl                  
➜  curl -X POST 
➜  curl                

NOTE: The health endpoint is only for test purpose, it does not affect other endpoints.


Create the binaries with go build:

CGO_ENABLED=0 go build -a -ldflags '-s' .

For more infromation about the parameters, please refer to this blog.

Then, build the docker image:

docker build -t whoami:v1.0 .