/docker-manager

An application to programmatically manage docker containers

Primary LanguageClojure

Docker Controller

This is an application to programmatically manage the docker containers through a simple HTTP interface.

My initial idea was to be able to start/stop applications running in docker using Amazon's Alexa voice assistant. And, obviously, to practice some clojure.

Running

Download the latest jar from the releases page and run:

$ java -jar docker-controller.jar

After you've started the app, you can send some http requests to manage docker containers:

$ curl --request POST \
    --url http://localhost:3000/containers/%my-awesome-app% \
    --header 'content-type: application/json' \
    --data '{"action": "start"}'

$ curl --request POST \
    --url http://localhost:3000/containers/%my-awesome-app% \
    --header 'content-type: application/json' \
    --data '{"action": "stop"}'

Available commands

You can use following commands to juggle your containers:

GET /containers lists all running containers

GET /containers/%container-id% shows the container info

POST /containers/%container-id% with {"action": "start"} in payload starts the container

POST /containers/%container-id% with {"action": "restart"} in payload restarts the container

POST /containers/%container-id% with {"action": "stop"} in payload stops the container

GET /version shows application version. Does not require security token

Securing the application

It is recommended to set the TOKEN env variable with a unique string to protect your API from unauthorized access:

$ TOKEN=53de47d3c01e648b4a72938a33846af8d3680dce java -jar docker-controller.jar

Then, use the same string in token query string or payload parameter:

 $ curl --request POST \
     --url http://localhost:3000/containers/%my-awesome-app% \
     --header 'content-type: application/json' \
     --data '{"action": "stop", "token": "53de47d3c01e648b4a72938a33846af8d3680dce"}'

Additional settings

By default an application runs on port 3000 and connects to docker's socket at unix://var/run/docker.sock You can change these settings by setting the PORT and UNIX_SOCKET environment variables, e.g.:

$ PORT=8080 java -jar docker-controller.jar

To me, the most convenient way to keep the app running is using some process control system, e.g. Supervisor. It would take care of running the app in the background and restoring it after system reboot.

CircleCI