Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/genaumann/salt-acme.sh-formula
Salt - Acme.sh Formula
https://github.com/genaumann/salt-acme.sh-formula
acme acmesh salt saltstack saltstack-formula
Last synced: about 18 hours ago
JSON representation
Salt - Acme.sh Formula
- Host: GitHub
- URL: https://github.com/genaumann/salt-acme.sh-formula
- Owner: genaumann
- License: apache-2.0
- Created: 2023-12-23T15:30:54.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-03-09T01:37:23.000Z (7 months ago)
- Last Synced: 2024-09-18T19:28:50.669Z (7 days ago)
- Topics: acme, acmesh, salt, saltstack, saltstack-formula
- Language: Python
- Homepage:
- Size: 65.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Salt acme.sh Formula
![lint][lint_badge]
![test][test_badge]
Interacts with [acme.sh](https://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][install].
See [`example.yml`](example.yml) on how to configure the formula.
If you want to use this formula, please pay attention to the [`FORMULA`](FORMULA) file and/or `git tag`,
which contains the currently released version.
This formula is versioned according to [Semantic Versioning](http://semver.org/).
## Available states
- [`acme.sh`](acme.sh/init.sls)
- [`acme.sh.install`](acme.sh/install.sls)
- [`acme.sh.issue`](acme.sh/issue.sls)
### `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
- [`acme.sh`](docs/module_acme_sh.md)
## Available state modules
- [`acme.sh`](docs/state_acme_sh.md)
## 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
```bash
bundle install
kitchen list # list all available test instances
kitchen test
```
## OS support matrix
This formula has been tested under the following operating systems and salt versions.
| OS | 3006.0 | 3006.5 |
| ------------ | ------ | ------------ |
| Debian 12 | :x: | ✅ |
| Ubuntu 22.04 | :x: | ✅ |
| Rocky 9 | :x: | ✅ |
| Fedora 38 | :x: | ✅ |
| OpenSUSE 15 | ✅ | Not released |
[install]: https://docs.saltproject.io/en/latest/topics/development/conventions/formulas.html
[lint_badge]: https://github.com/genaumann/salt-acme.sh-formula/actions/workflows/lint.yml/badge.svg?branch=main
[test_badge]: https://github.com/genaumann/salt-acme.sh-formula/actions/workflows/salt-kitchen.yml/badge.svg?branch=main