mirage is reverse proxy for docker container and container manager.

mirage can launch and terminate docker container and serve http request with specified subdomain. Additionaly, mirage passes variable to Dockerfile using environment variables.

1. Setup mirage and edit configuration (see Setup section for detail.)
2. Run mirage.

Following instructions use below settings.

host:
  webapi: docker.dev.example.net
  reverse_proxy_suffix: .dev.example.net
listen:
  HTTP: 80

Prerequisite: you should resolve *.dev.example.net to your docker host.

3. Launch docker container using curl.

curl http://docker.dev.example.net/api/launch \
  -d subdomain=cool-feature \
  -d branch=feature/cool \
  -d image=myapp:latest

4. Now, you can access to container using "http://cool-feature.dev.exmaple.net/".

5. Terminate container using curl.

curl http://docker.dev.example.net/api/terminate \
  -d subdomain=cool-feature

3. Access to mirage web interface via "http://docker.dev.example.net/".
4. Press "Launch New Container".
5. Fill launch options.

• subdomain: cool-feature
• branch: feature/cool
• image: myapp:latest

6. Now, you can access to container using "http://cool-feature.dev.exmaple.net/".
7. Press "Terminate" button.

Mirage now supports custom parameter. Write your parameter on config.yml.

Mirage contains default parameter "branch" as below.

parameters:
  - name: branch
    env: GIT_BRANCH
    rule: ""
    required: true

You can add custom parameter. "rule" option is regexp string.

1. Download binary or go get
2. Rename config_sample.yml to config.yml
3. Edit config.yml to your environment
4. Change your domain setting to fit your config.yml
5. Run mirage

The MIT License (MIT)

(c) 2014 acidlemon. (c) 2014 KAYAC Inc.