Ansible Role: Dokku

Version: 2019.04.3

This Ansible role helps install Dokku on Debian/Ubuntu variants. Apart from installing Dokku, it also provides various modules that can be used to interface with dokku from your own Ansible playbooks.

Requirements

Minimum Ansible Version: 2.2

Platform Requirements

Supported Platforms

Ubuntu: trusty
Ubuntu: utopic
Ubuntu: vivid
Ubuntu: wily
Ubuntu: xenial
Ubuntu: yakkety
Ubuntu: zesty
Ubuntu: artful
Ubuntu: bionic
Debian: wheezy
Debian: jessie
Debian: stretch
Debian: buster

Dependencies

Dokku version 0.16.1 (for library usage)

Role Variables

docker_apt_key_sig

default: 58118E89F3A912897C070ADBF76221572C52609D
type: string
description: apt.docker repository key signature

docker_apt_key_url

default: hkp://p80.pool.sks-keyservers.net:80
type: string
description: Location to retrieve the apt.docker key

docker_download_key_sig

default: 9DC858229FC7DD38854AE2D88D81803C0EBFCD88
type: string
description: download.docker repository key signature

docker_download_key_url

default: https://download.docker.com/linux/ubuntu/gpg
type: string
description: Location for download.docker key

dokku_daemon_install

default: True
type: boolean
description: Whether to install the dokku-daemon

dokku_daemon_version

default: f3b7b0ab1b6368d49e569de03af28e497ce0a0c9
type: string
description: Version of dokku-daemon to install

dokku_hostname

default: dokku.me
type: string
description: Hostname, used as vhost domain and for showing app URL after deploy

dokku_key_file

default: /root/.ssh/id_rsa.pub
type: string
description: Path on disk to an SSH key to add to the Dokku user (Will be ignored on dpkg-reconfigure)

dokku_manage_nginx

default: True
type: boolean
description: Whether we should manage the 00-default nginx site

dokku_plugins

default: {}
type: list
description: A list of plugins to install. The host must have network access to the install url, and git access if required. Plugins should be specified in the following format:

- name: postgres
  url: https://github.com/dokku/dokku-postgres.git

- name: redis
  url: https://github.com/dokku/dokku-redis.git

dokku_skip_key_file

default: false
type: string
description: Do not check for the existence of the dokku/key_file. Setting this to "true", will require you to manually add an SSH key later on.

dokku_users

default: None
type: list
description: A list of users who should have access to Dokku. This will not grant them generic SSH access, but rather only access as the dokku user. Users should be specified in the following format:

- name: Jane Doe
  username: jane
  ssh_key: JANES_PUBLIC_SSH_KEY
- name: Camilla
  username: camilla
  ssh_key: CAMILLAS_PUBLIC_SSH_KEY

dokku_version

default: 0.16.1
type: version
description: The version of Dokku to install

dokku_vhost_enable

default: true
type: string
description: Use vhost-based deployments (e.g., .dokku.me)

dokku_web_config

default: false
type: string
description: Use web-based config for hostname and keyfile

herokuish_version

default: 0.5.0
type: version
description: The version of herokuish to install

plugn_version

default: 0.3.0
type: version
description: The version of plugn to install

sshcommand_version

default: 0.7.0
type: version
description: The version of sshcommand to install

Libraries

dokku_app

Create or destroy dokku apps

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
state	Choices: present (default) absent	The state of the app

Example

- name: Create a dokku app
  dokku_app:
    app: hello-world

- name: Delete that repo
  dokku_app:
    app: hello-world
    state: absent

dokku_certs

Manages ssl configuration for an app.

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
cert ^required		Path to the ssl certificate
key ^required		Path to the ssl certificate key
state	Choices: present (default) absent	The state of the ssl configuration

Example

- name: Adds an ssl certificate and key to an app
  dokku_certs:
    app: hello-world
    key: /etc/nginx/ssl/hello-world.key
    cert: /etc/nginx/ssl/hello-world.crt

- name: Removes an ssl certificate and key from an app
  dokku_certs:
    app: hello-world
    state: absent

dokku_clone

Deploys a repository to an undeployed application

Requirements

the dokku-clone plugin

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
repository ^required		Git repository url

Example

- name: clone a repo
  dokku_clone:
    app: hello-world
    repository: https://github.com/hello-world/hello-world.git

dokku_config

Manage environment variables for a given dokku application

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
config ^required	Default: {}	A map of environment variables where key => value

Example

- name: set KEY=VALUE
  dokku_config:
    app: hello-world
    config:
      KEY: VALUE_1
      KEY_2: VALUE_2

dokku_consul

Manage the consul configuration for a given dokku application

Requirements

the dokku-consul plugin (commercial)

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
endpoint	Default: /	The consul healthcheck endpoint
interval	Default: 60s	The consul healthcheck interval
state	Choices: present (default) absent	The state of the consul integration
timeout ^required	Default: 60s	The consul healthcheck timeout

Example

- name: consul:enable hello-world
  dokku_consul:
    app: hello-world

- name: consul:enable hello-world with args
  dokku_consul:
    app: hello-world
    endpoint: /_status

- name: consul:disable hello-world
  dokku_consul:
    app: hello-world
    state: absent

dokku_docker_options

Manage docker-options for a given dokku application

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
option ^required		A single docker option
phase	Choices: build deploy run	The phase in which to set the options
state	Choices: present (default) absent	The state of the docker options

Example

- name: docker-options:add hello-world deploy
  dokku_docker_options:
    app: hello-world
    phase: deploy
    options:
        - "-v /var/run/docker.sock:/var/run/docker.sock"

- name: docker-options:remove hello-world deploy
  dokku_docker_options:
    app: hello-world
    phase: deploy
    options:
        - "-v /var/run/docker.sock:/var/run/docker.sock"
    state: absent

dokku_domains

Manages domains for a given application

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
domains ^required		A list of domains
state	Choices: enable disable clear present (default) absent	The state of the application's domains

Example

- name: domains:add hello-world dokku.me
  dokku_domains:
    app: hello-world
    domains:
      - dokku.me

- name: domains:remove hello-world dokku.me
  dokku_domains:
    app: hello-world
    domains:
      - dokku.me
    state: absent

- name: domains:clear hello-world
  dokku_domains:
    app: hello-world
    state: clear

- name: domains:enable hello-world
  dokku_domains:
    app: hello-world
    state: enable

- name: domains:disable hello-world
  dokku_domains:
    app: hello-world
    state: disable

dokku_ecr

Manage the ecr configuration for a given dokku application

Requirements

the dokku-ecr plugin (commercial)

Parameters

Parameter	Choices/Defaults	Comments
account-id		The ecr aws account-id
app ^required		The name of the app
image-repo		The image name to use when pushing to ecr
region	Default: us-east-1	The ecr region
state	Choices: present (default) absent	The state of the ecr integration

Example

- name: ecr:enable hello-world
  dokku_ecr:
    app: hello-world

- name: ecr:enable hello-world with args
  dokku_ecr:
    app: hello-world
    image-repo: prod-hello-world

- name: ecr:disable hello-world
  dokku_ecr:
    app: hello-world
    state: absent

dokku_git_sync

Manages syncing git code from a remote repository for an app

Requirements

the dokku-git-sync plugin (commercial)

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
remote		The git remote url to use
state	Choices: present (default) absent	The state of the git-sync integration

Example

- name: git-sync:enable hello-world
  dokku_git_sync:
    app: hello-world
    remote: git@github.com:hello-world/hello-world.git

- name: git-sync:disable hello-world
  dokku_git_sync:
    app: hello-world
    state: absent

dokku_global_cert

Manages global ssl configuration.

Requirements

the dokku-global-cert plugin

Parameters

Parameter	Choices/Defaults	Comments
cert ^required		Path to the ssl certificate
key ^required		Path to the ssl certificate key
state	Choices: present (default) absent	The state of the ssl configuration

Example

- name: Adds an ssl certificate and key
  dokku_global_cert:
    key: /etc/nginx/ssl/global-hello-world.key
    cert: /etc/nginx/ssl/global-hello-world.crt

- name: Removes an ssl certificate and key
  dokku_global_cert:
    state: absent

dokku_service_link

Manage ports for a given dokku application

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
mappings ^required		A list of port mappings
state	Choices: clear present (default) absent	The state of the port mappings

Example

- name: proxy:ports-add hello-world http:80:80
  dokku_service_link:
    app: hello-world
    mappings:
        - http:80:8080

- name: proxy:ports-remove hello-world http:80:80
  dokku_service_link:
    app: hello-world
    mappings:
        - http:80:8080
    state: absent

- name: proxy:ports-clear hello-world
  dokku_service_link:
    app: hello-world
    state: clear

dokku_proxy

Enable or disable the proxy for a dokku app

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
state	Choices: present (default) absent	The state of the proxy

Example

- name: Enable the default proxy
  dokku_proxy:
    app: hello-world

- name: Disable the default proxy
  dokku_proxy:
    app: hello-world
    state: absent

dokku_registry

Manage the registry configuration for a given dokku application

Requirements

the dokku-registry plugin (commercial)

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
image		Alternative to app name for image repository name
password		The registry password (required for 'present' state)
server		The registry server hostname (required for 'present' state)
state	Choices: present (default) absent	The state of the registry integration
username		The registry username (required for 'present' state)

Example

- name: registry:enable hello-world
  dokku_registry:
    app: hello-world
    password: password
    server: localhost:8080
    username: user

- name: registry:enable hello-world with args
  dokku_registry:
    app: hello-world
    image: other-image
    password: password
    server: localhost:8080
    username: user

- name: registry:disable hello-world
  dokku_registry:
    app: hello-world
    state: absent

dokku_service_create

Creates a given service

Parameters

Parameter	Choices/Defaults	Comments
name ^required		The name of the service
service ^required		The type of service to create

Example

- name: redis:create default
  dokku_service_create:
    name: default
    service: redis

dokku_service_link

Links and unlinks a given service to an application

Parameters

Parameter	Choices/Defaults	Comments
app ^required		The name of the app
name ^required		The name of the service
service ^required		The type of service to link
state	Choices: present (default) absent	The state of the service link

Example

- name: redis:link default hello-world
  dokku_service_link:
    app: hello-world
    name: default
    service: redis

- name: redis:unlink default hello-world
  dokku_service_link:
    app: hello-world
    name: default
    service: redis
    state: absent

dokku_storage

Manage storage for dokku applications

Parameters

Parameter	Choices/Defaults	Comments
app		The name of the app
create_host_dir	Default: False	Whether to create the host directory or not
group	Default: 32767	A group or gid that should own the created folder
mounts	Default: []	A list of mounts to create, colon (:) delimited, in the format: `host_dir:container_dir`
state	Choices: present (default) absent	The state of the service link
user	Default: 32767	A user or uid that should own the created folder

Example

- name: mount a path
  dokku_storage:
    app: hello-world
    mounts:
      - /var/lib/dokku/data/storage/hello-world:/data

- name: mount a path and create the host_dir directory
  dokku_storage:
    app: hello-world
    mounts:
      - /var/lib/dokku/data/storage/hello-world:/data
    create_host_dir: true

- name: unmount a path
  dokku_storage:
    app: hello-world
    mounts:
      - /var/lib/dokku/data/storage/hello-world:/data
    state: absent

- name: unmount a path and destroy the host_dir directory (and contents)
  dokku_storage:
    app: hello-world
    mounts:
      - /var/lib/dokku/data/storage/hello-world:/data
    destroy_host_dir: true
    state: absent

Example Playbooks

Installing Dokku

---
- hosts: all
  roles:
    - dokku

Installing Plugins

---
- hosts: all
  roles:
    - dokku
  vars:
    dokku_plugins:
      - name: clone
        url: https://github.com/crisward/dokku-clone.git
      - name: postgres
        url: https://github.com/dokku/dokku-postgres.git

Deploying a simple word inflector

---
- hosts: all
  tasks:
    - name: dokku apps:create inflector
      dokku_app:
        app: inflector

    - name: dokku clone inflector
      dokku_clone:
        app: inflector
        repository: https://github.com/cakephp/inflector.cakephp.org

License

MIT License

See LICENSE.md for further details.

Name		Name	Last commit message	Last commit date
Latest commit History 25 Commits
bin		bin
defaults		defaults
files		files
handlers		handlers
library		library
meta		meta
tasks		tasks
.ansible-lint		.ansible-lint
LICENSE.md		LICENSE.md
Makefile		Makefile
README.md		README.md
example.yml		example.yml
requirements.txt		requirements.txt

License

pantographe/ansible-dokku

Folders and files

Latest commit

History

Repository files navigation

Ansible Role: Dokku

Table Of Contents

Requirements

Platform Requirements

Dependencies

Role Variables

docker_apt_key_sig

docker_apt_key_url

docker_download_key_sig

docker_download_key_url

dokku_daemon_install

dokku_daemon_version

dokku_hostname

dokku_key_file

dokku_manage_nginx

dokku_plugins

dokku_skip_key_file

dokku_users

dokku_version

dokku_vhost_enable

dokku_web_config

herokuish_version

plugn_version

sshcommand_version

Libraries

dokku_app

Parameters

Example

dokku_certs

Parameters

Example

dokku_clone

Requirements

Parameters

Example

dokku_config

Parameters

Example

dokku_consul

Requirements

Parameters

Example

dokku_docker_options

Parameters

Example

dokku_domains

Parameters

Example

dokku_ecr

Requirements

Parameters

Example

dokku_git_sync

Requirements

Parameters

Example

dokku_global_cert

Requirements

Parameters

Example

dokku_service_link

Parameters

Example

dokku_proxy

Parameters

Example

dokku_registry

Requirements

Parameters

Example

dokku_service_create

Parameters

Example

dokku_service_link

Packages