ansible-roles/evoacme
2016-12-22 15:58:45 +01:00
..
defaults evoacme: namespaced variables 2016-12-21 16:23:28 +01:00
files Evoacme: merge role from evoacme private repo 2016-12-21 16:12:27 +01:00
handlers evoacme: better validation for Apache 2016-12-21 16:23:29 +01:00
tasks Fix variable name 2016-12-22 15:58:45 +01:00
templates evoacme: namespaced variables 2016-12-21 16:23:28 +01:00
README.md Evoacme: merge role from evoacme private repo 2016-12-21 16:12:27 +01:00

Evoacme 1.3

EvoAcme is an Ansible role and a Certbot wrapper for generate Let's Encrypt certificates.

It is a project hosted at Evolix's forge

How to install

1 - Create a playbook with evoacme role

---
  - hosts: hostname
    become: yes
    roles:
      - role: evoacme

2 - Install evoacme prerequisite with ansible

ansible-playbook playbook.yml -Kl hostname

3 - Include letsencrypt.conf in your webserver

For Apache, you just need to ensure that you don't overwrite "/.well-known/acme-challenge" Alias with a Redirect or Rewrite directive.

For Nginx, you must include letsencrypt.conf in all wanted vhost :

include /etc/nginx/letsencrypt.conf;
nginx -t
service nginx reload

4 - Create a CSR for a vhost with make-csr

# vhostname is vhostfile without .conf ext
make-csr vhostname

8 - Generate the certificate with evoacme

evoacme vhostname

# License

Evoacme is open source software licensed under the AGPLv3 License.