Deploy applications on Dokku using Ansible
This repository has been archived on 2020-05-07. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Luke Murphy 451947080a
Add ports check
2020-04-16 23:43:29 +02:00
deps Remove role for now 2020-04-14 10:58:13 +02:00
plays Add ports check 2020-04-16 23:43:29 +02:00
subcommands Add sudo pass and trim up vault pass command 2020-04-13 13:11:43 +02:00
LICENSE Bootstrap new plugin 2020-04-03 00:57:29 +02:00
README.md Add some setup steps 2020-04-15 22:19:24 +02:00
ansible.cfg Add filter plugins 2020-04-15 12:57:58 +02:00
commands Add sudo pass and trim up vault pass command 2020-04-13 13:11:43 +02:00
dependencies Format and add missing shellcheck exceptions 2020-04-13 09:21:36 +02:00
functions Drop out of messy debug mode 2020-04-15 12:15:51 +02:00
plugin.toml Bootstrap new plugin 2020-04-03 00:57:29 +02:00
post-delete Add post-delete back 2020-04-13 16:20:36 +02:00
post-deploy Add pre-deploy/post-deploy place holders 2020-04-13 09:24:02 +02:00
post-extract Format and add missing shellcheck exceptions 2020-04-13 09:21:36 +02:00
pre-deploy Add pre-deploy/post-deploy place holders 2020-04-13 09:24:02 +02:00

README.md

dokku-ansible-deploy

Overview

Deploy applications on Dokku using Ansible.

When we package and deploy applications with Dokku, we still have a number of manual tasks to complete before the application is production ready. Running Dokku host side commands such as dokku letsencrypt, creating and linking database stores and even going ahead and wiring up monitoring and alerting infrastructure.

This plugin automates what would be otherwise manual steps. Once you git push your application deployment, this plugin consumes configuration specified in the deploy.d directory to carry out the end-to-end production deployment steps.

A rough overview of the feature set is:

  • Setup your entire application configuration in a set of easy to manage YAML file
  • Encrypt secrets in your Git repository and have them decrypted during deployment
  • Custom hooks are available to drop into running an Ansible playbook for advanced users
  • Compatible with both Heroku buildpack and Docker deployments

More documentation coming soon TM.

Example Usage

Requirements

  • dokku 0.19.13+
  • Debian based system (uses apt package manager for installing dependencies)

Installation

$ dokku plugin:install https://git.autonomic.zone/autonomic-cooperative/dokku-ansible-deploy.git
$ dokku ansible-deploy:sudo-pass

Per-app Host Setup

$ dokku ansible-deploy:vault-pass myapp