Ansible role for Dokku

Setup Dokku.

If you want to all-in-one Dokku role, see Dokku official ansible role.

Requirements

• Debian
• Ubuntu

Role Variables

• dokku_vhost_enable: Enable vhost-based deployments. Value of debconf dokku/vhost_enable. (boolean)
• dokku_web_config: Enable the web-based config page. Value of debconf dokku/web_config. (boolean)
• dokku_hostname: Hostname or IP for server. Value of debconf dokku/hostname. (string)
• dokku_skip_key_file: Skip key file requirement. Value of debconf dokku/skip_key_file. (boolean)
• dokku_key_file: SSH public key file for initial user. Value of debconf dokku/key_file. (string)
• dokku_version: version of dokku to be installed. Default: ''. (string)

Note: boolean value should be "true" or "false" in string of yaml. If use true (yes), false (no) or something similar, ansible reports changed every provision.

• dokku_plugin: Install plugin.

If you use dokku-letsencrypt and want to use systemd units instead of cron-job.

• dokku_letsencrypt_auto_renew_on: OnCalendar of timer unit.

Dependencies

• docker

Example Playbook

Example:

- hosts: servers
  become: yes
  roles:
     - znz.docker
     - znz.dokku

Another example:

- hosts: all
  become: yes
  roles:
  - znz.docker
    docker_ce_channel: "stable"
  - role: znz.dokku
    dokku_vhost_enable: "true"
    dokku_web_config: "false"
    dokku_hostname: "127.0.0.1.xip.io"
    dokku_skip_key_file: "true"
    dokku_version: "=0.11.3"
    dokku_plugin:
    - name: letsencrypt
      url: https://github.com/dokku/dokku-letsencrypt.git
    - name: maintenance
      url: https://github.com/dokku/dokku-maintenance.git
    - name: postgres
      url: https://github.com/dokku/dokku-postgres.git
    dokku_letsencrypt_auto_renew_on: "*-*-* 3,9,15,21:00"

License

MIT License