ansible-collection-caddy/README.md

27 lines
1,020 B
Markdown
Raw Normal View History

# Ansible Collection - enbewe.caddy
Collecion for a multi-site reverse proxy, based on caddy (https://caddyserver.com/).
## Playbooks
### enbewe.caddy.deploy
Deploys the role `enbewe.caddy.caddy` to the host group called `caddy`.
## Roles
### enbewe.caddy.caddy
Installs the caddy server in a podman container and configures the server to act
as a reverse proxy to all configured sites.
#### Required variables
**caddy_networks** *(Type: list / elements=string)*
The list of podman networks the proxy should be part of.
**caddy_sites** *(Type: dict)
The sites that caddy should serve.
Each site has to have a `name`, that is used as the host in caddy config.
Additionally, the site should have the key `proxy_to`, that points to the address of the proxied service,
or it should have the key `directives` that can be used to create a free-form config for the site.
#### Optional variables
**caddy_use_local_certs** *(Default: false)*
Enforce usage of local certificates, instead of the default Letsencrypt certs.