Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/morbidick/ansible-role-certbot

Install certbot and manage certificates with ansible
https://github.com/morbidick/ansible-role-certbot

acme ansible ansible-role certbot letsencrypt

Last synced: 14 days ago
JSON representation

Install certbot and manage certificates with ansible

Awesome Lists containing this project

README

        

# Install certbot with Ansible

[![Build Status](https://travis-ci.org/morbidick/ansible-role-certbot.svg?branch=master)](https://travis-ci.org/morbidick/ansible-role-certbot)

Installs certbot and configures certificates. For a complete setup with nginx see [the full example](https://github.com/morbidick/ansible-role-nginx-vhosts/blob/master/webserver.md).

## Requirements

None.

## Example playbook

````yaml
- hosts: all
become: yes

roles:
- certbot

vars:
certbot_mail: [email protected]
certbot_certs:
- host: example.com
- host: foo.bar
mail: [email protected]
````

## Role variables

None of the variables below are required.

| Variable | Default | Comment |
| :--- | :--- | :--- |
| certbot_mail | | *required* the account email |
| certbot_certs | `[]` | list of certs to request |

For all options see [defaults/main.yml](defaults/main.yml)

## Development

You can use the [Vagrantfile](Vagrantfile) for local testing, just install vagrant and virtualbox and execute the following commands:

````bash
vagrant up
vagrant provision
````

## License

MIT