nephelaiio.acme_certificate_route53
nephelaiio.acme-dnschallenge-route53
An ansible role to issue acme certificates with dns challenge verification using route53 name service
Role Variables
The most common user overridable parameters for the role are
| required | variable | description | default |
|---|---|---|---|
| yes | acme_certificate_domain | the fqdn to generate an acme certificate for | ansible_fqdn |
| yes | acme_certificate_aws_accesskey_id | an ec2 key id with route53 management rights | lookup('env', 'AWS_ACCESS_KEY_ID') |
| yes | acme_certificate_aws_accesskey_secret | an ec2 key secret | lookup('env', 'AWS_SECRET_ACCESS_KEY') |
| no | acme_certificate_group_members | certificate file group members | [] |
| no | acme_certificate_add_ca | add acme ca to the | false |
| no | acme_certificate_directory | url to ca directory | https://acme-v01.api.letsencrypt.org/directory |
| no | acme_certificate_cafile (*) | symlink path to issuing ca cert file | undefined |
| no | acme_certificate_intcafile (*) | symlink path to issuing intermediate ca cert file | undefined |
| no | acme_certificate_certfile (*) | symlink path to cert file | undefined |
| no | acme_certificate_chainfile (*) | symlink path to certificate chain file | undefined |
| no | acme_certificate_keyfile (*) | symlink path to certificate key file | undefined |
You can view an example redefinition of some of the above parameters, most notably the ones concerning certificate ca in the CI test configuration file
(*) useful for backwards compatibility with existing nginx/apache configurations
Please refer to the defaults file for an up to date list of input parameters.
Dependencies
See the https://raw.githubusercontent.com/nephelaiio/ansible-role-requirements/master/requirements.txt and meta.yml files for more details
Example Playbook
- hosts: servers
vars:
acme_certificate_email: [email protected]
acme_certificate_domain: "{{ ansible_fqdn }}"
acme_certificate_aws_accesskey_id: "{{ lookup('env', 'AWS_KEY_ID') }}"
acme_certificate_aws_accesskey_secret: "{{ lookup('env', 'AWS_AK_SECRET') }}"
roles:
- role: nephelaiio.acme-dnschallenge-route53
Testing
Please make sure your environment has docker installed in order to run role validation tests. Additional python dependencies are listed in the requirements file
Role is tested against the following distributions (docker images):
- Ubuntu Jammy
- Ubuntu Focal
- Ubuntu Bionic
- Debian Bullseye
- Debian Buster
- Rocky Linux 9
You can test the role directly from sources using command molecule test
License
This project is licensed under the terms of the MIT License
An ansible role to generate acme certificates using dns challenges with route53
ansible-galaxy install nephelaiio.acme_certificate_route53