system-config/playbooks/roles/letsencrypt-acme-sh-install/README.rst
Jeremy Stanley 33c8b1ac4b Retry acme.sh cloning
Sometimes we observe failures to clone acme.sh from GitHub. Retry it
up to three times with a two-second delay between each try, in hopes
of failing these jobs less often.

While we're here, update the URL to a more current one which doesn't
need redirecting.

Change-Id: I5179c0482afcb407b7d28d4c3ce73d96d41c6493
2021-10-13 18:31:46 +00:00

24 lines
723 B
ReStructuredText

Install acme.sh client
This makes the `acme.sh <https://github.com/acmesh-official/acme.sh>`__
client available on the host.
Additionally a ``driver.sh`` script is installed to run the
authentication procedure and parse output.
**Role Variables**
.. zuul:rolevar:: letsencrypt_gid
:default: unset
Unix group `gid` for the `letsencrypt` group which has permissions
on the `/etc/letsencrypt-certificates` directory. If unset, uses
system default. Useful if this conflicts with another role that
assumes a `gid` value.
.. zuul:rolevar:: letsencrypt_account_email
:default: undefined
The email address to register with accounts. Renewal mail and
other info may be sent here. Must be defined.