Instant Whales

API Server to run/kill Docker containers with expires time. This server is for internal use. Don't publish the server on the Internet directly.

The benefit of this server is that it can handle 'expires' of containers. Instant Whales shouldn't handle backends too much. Basically, it should be solved by Kubernetes, AWS ECS or so.

API

GET /containers

Return running containers.

POST /containers

Run a new container. Requests should be like this.

{
  "image": "redis",
  "expires": 60,
  "memory": 32
}

• image: Docker image name to run
• expires: Seconds to run the container. After specified seconds, the container will be killed.
  • Specify 0 not to expire the container
• memory: Memory amount to allocate for the container (as MB).

Responses will be like this.

{
    "containerId": "90b4833113325a234fb7c4477a2fcd0c40bcda183527bc68c9aad51ac3a4eb52",
    "image": "redis",
    "port": "32776",
    "ports": {
        "6379/tcp": [
            {
                "HostIP": "0.0.0.0",
                "HostPort": "32776"
            }
        ]
    },
    "expires": 180
}

DELETE /containers/<container_id>

Kill specified container.

Responses will be always 204 No Content.

GET /images

Return stored images.

Development

go build
./instant-whales

Build

make build

Run

make run

Versions

$ go version    
go version go1.6 darwin/amd64

$ make --version
GNU Make 3.81

$ docker-compose version
docker-compose version 1.7.0rc1, build 1ad8866
docker-py version: 1.8.0-rc2

$ docker version
Client:
 Version:      1.9.0
 API version:  1.21
 Go version:   go1.4.3
 Git commit:   76d6bc9
 Built:        Tue Nov  3 19:20:09 UTC 2015
 OS/Arch:      darwin/amd64

Server:
 Version:      1.11.0-rc3
 API version:  1.23
 Go version:   go1.5.3
 Git commit:   eabf97a
 Built:        2016-04-01T23:33:49.977963402+00:00
 OS/Arch:      linux/amd64