Skip to content

genaumann/salt-acme.sh-formula

Repository files navigation

Salt acme.sh Formula

GitHub release lint test

Interacts with acme.sh:

  • install acme.sh
  • issue certificates
  • renew certificates

The following modes are supported:

  • standalone
  • webroot
  • dns

General notes

See the full SaltStack Formulas installation and usage instructions.

See example.yml on how to configure the formula.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

Available states

acme_sh

Includes the following states:

  • acme_sh.install
  • acme_sh.issue

acme_sh.install

Installs acme.sh.

acme_sh.issue

Issues or renews certificate with acme.sh.

Available execution modules

Available state modules

Testing

Linux testing is done with kitchen-salt.

All tests and lint jobs are executed in GitHub Actions.

Requirements

You can test the formula locally after installing the following requirements.

  • vagrant
  • VirtualBox
  • Ruby
  • bundler

Run Test

bundle install
kitchen list # list all available test instances
kitchen test <instance>