Salt/letsencrypt-sh-formula

Go to file

Raphaël Hertzog 72c851c105 Add /usr/bin to PATH		2017-01-02 20:35:38 +01:00
letsencrypt-sh	Add /usr/bin to PATH	2017-01-02 20:35:38 +01:00
CHANGELOG.rst	Add documentation for new hook script feature	2016-12-12 21:24:10 +01:00
LICENSE	Initial commit	2016-06-21 12:33:55 +02:00
README.rst	Add documentation for new hook script feature	2016-12-12 21:24:10 +01:00
VERSION	Add documentation for new hook script feature	2016-12-12 21:24:10 +01:00
pillar.example	Add support for a default hook script	2016-12-12 20:47:14 +01:00

README.rst

======================
letsencrypt-sh-formula
======================

This formula allows you to use the
`letsencrypt.sh <https://github.com/lukas2511/letsencrypt.sh>` client
to automatically manage TLS certificates issued by the
`letsencrypt.org <https://letsencrypt.org>` service.

Available states
================

.. contents::
    :local:

``letsencrypt-sh``
------------------

Installs the letsencrypt.sh client, its configuration file, the apache
integration and the cron job.

``letsencrypt-sh.install``
--------------------------

Installs the letsencrypt.sh client.

``letsencrypt-sh.config``
-------------------------

Installs the letsencrypt.sh configuration file. Can also install a hook
script in /etc/letsencrypt.sh/hook (overridable with
pillar ``letsencrypt-sh:lookup:hook_script``) whose content is taken from
the source file defined at pillar
``letsencrypt-sh:lookup:hook_script_src`` (which defaults to a script
reloading the service whose name is set in pillar
``letsencrypt-sh:lookup:hook_service_to_reload``).

``letsencrypt-sh.apache``
-------------------------

Installs the Apache integration allowing letsencrypt.sh to validate HTTP
challenges required by letsencrypt.org to issue/renew TLS certificates.

``letsencrypt-sh.cron``
-----------------------

Enables a periodic task that renews managed TLS certificates that are
about to expire.