dokku-docker-options

Basic docker options for dokku (https://github.com/progrium/dokku).

A number of dokku plugins that add docker options at run/deploy have been created. Some of these make sense to be a seperate plugin as care is required in the options use or perhaps they offer extra functionality around the handling of the options.

Other plugins have also been created that require no special consideration in their use and offer no extra functionality above dokku-docker-options. For exmaple my original docker-persistent-storage (https://github.com/dyson/dokku-persistent-storage) plugin that is almost identical to this plugin; accept it hardcodes the -v option, making it useless for anything else.

Requirements

Development version of dokku at or after https://github.com/progrium/dokku/commit/c77cbf1d3ae07f0eafb85082ed7edcae9e836147.

Installation

$ cd /var/lib/dokku/plugins
$ sudo git clone https://github.com/dyson/dokku-docker-options.git docker-options

Usage

$ dokku help
...
    docker-options <app>                            display docker options for an app
    docker-options:add <app> OPTIONS_STRING         add an option string an app
    docker-options:remove <app> OPTIONS_STRING      remove an option string from an app
...

Add some options

$ dokku docker-options:add myapp "-v /host/path:/container/path"
$ dokku docker-options:add myapp "-v /another/container/path"
$ dokku docker-options:add myapp "-link container_name:alias"

Check what we added

$ dokku docker-options myapp
-link container_name:alias
-v /host/path:/container/path
-v /another/container/path

Remove an option

$ dokku docker-options:remove myapp "-link container_name:alias"

Manual Usage

In your applications folder (/home/dokku/app_name) create a file called DOCKER_OPTIONS.

Inside this file list one docker option per line*. For example:

-link container_name:alias
-v /host/path:/container/path
-v /another/container/path

The above example will result in the following options being passed to docker during deploy and docker run:

-link container_name:alias -v /host/path:/container/path -v /another/container/path

Move information on docker options can be found here: http://docs.docker.io/en/latest/reference/run/ .

* Lines must end with a new line character. You can verify your line endings with: cat -E PERSISTENT_STORAGE and new line characters will be shown as $.

License