mirror of
https://github.com/geerlingguy/ansible-role-certbot.git
synced 2025-10-06 10:11:18 +02:00
Compare commits
2 Commits
cf94f9d317
...
c3f9d54e71
Author | SHA1 | Date | |
---|---|---|---|
|
c3f9d54e71 | ||
|
fc5c709df3 |
13
README.md
13
README.md
@ -26,11 +26,7 @@ By default, this role configures a cron job to run under the provided user accou
|
|||||||
|
|
||||||
### Automatic Certificate Generation
|
### Automatic Certificate Generation
|
||||||
|
|
||||||
Current methods supported for generating new certificates using this role:
|
Currently the `standalone` and `webroot` method are supported for generating new certificates using this role.
|
||||||
|
|
||||||
- `standalone`
|
|
||||||
- `webroot`
|
|
||||||
- `dns-cloudflare`
|
|
||||||
|
|
||||||
**For a complete example**: see the fully functional test playbook in [molecule/default/playbook-standalone-nginx-aws.yml](molecule/default/playbook-standalone-nginx-aws.yml).
|
**For a complete example**: see the fully functional test playbook in [molecule/default/playbook-standalone-nginx-aws.yml](molecule/default/playbook-standalone-nginx-aws.yml).
|
||||||
|
|
||||||
@ -40,7 +36,7 @@ Set `certbot_create_if_missing` to `yes` or `True` to let this role generate cer
|
|||||||
|
|
||||||
certbot_create_method: standalone
|
certbot_create_method: standalone
|
||||||
|
|
||||||
Set the method used for generating certs with the `certbot_create_method` variable — current allowed values are: `standalone`, `webroot` or 'dns-cloudflare'.
|
Set the method used for generating certs with the `certbot_create_method` variable — current allowed values are: `standalone` or `webroot`.
|
||||||
|
|
||||||
certbot_testmode: false
|
certbot_testmode: false
|
||||||
|
|
||||||
@ -90,11 +86,6 @@ This install method is currently experimental and may or may not work across all
|
|||||||
|
|
||||||
When using the `webroot` creation method, a `webroot` item has to be provided for every `certbot_certs` item, specifying which directory to use for the authentication. Also, make sure your webserver correctly delivers contents from this directory.
|
When using the `webroot` creation method, a `webroot` item has to be provided for every `certbot_certs` item, specifying which directory to use for the authentication. Also, make sure your webserver correctly delivers contents from this directory.
|
||||||
|
|
||||||
#### dns-cloudflare Certificate Generation
|
|
||||||
|
|
||||||
When using the `dns-cloudflare` creation method, set `certbot_dns_cloudflare_api_token` with your Cloudflare API token.
|
|
||||||
The process will generate a `dns-01` challenge (*DNS01*) by creating, and subsequently removing, TXT records using the Cloudflare API. See [certbot-dns-cloudflare documentation](https://certbot-dns-cloudflare.readthedocs.io/en/stable/) for details.
|
|
||||||
|
|
||||||
### Source Installation from Git
|
### Source Installation from Git
|
||||||
|
|
||||||
You can install Certbot from it's Git source repository if desired with `certbot_install_method: source`. This might be useful in several cases, but especially when older distributions don't have Certbot packages available (e.g. CentOS < 7, Ubuntu < 16.10 and Debian < 8).
|
You can install Certbot from it's Git source repository if desired with `certbot_install_method: source`. This might be useful in several cases, but especially when older distributions don't have Certbot packages available (e.g. CentOS < 7, Ubuntu < 16.10 and Debian < 8).
|
||||||
|
Loading…
x
Reference in New Issue
Block a user