mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-10-10 18:58:10 +02:00
Kevin Veen-Birkenbach
97af4990aa
- Rename sys-svc-webserver -> sys-svc-webserver-core - Rename sys-stk-front-pure -> sys-svc-webserver-https - Update includes, run_once flags, and docs across: * sys-ctl-mtn-cert-renew * sys-front-inj-* * sys-stk-front-proxy * sys-svc-certs * sys-svc-cln-domains * web-opt-rdr-* * web-svc-* - Remove redundant webserver include in web-opt-rdr-www - Fix documentation links Ref: ChatGPT conversation https://chatgpt.com/share/68d6cea2-3570-800f-acb3-c3277317f17b
25 lines
1.1 KiB
Markdown
25 lines
1.1 KiB
Markdown
# Webserver
|
|
|
|
This Ansible role installs and configures **Nginx** as a core HTTP/stream server on Arch Linux systems. It provides:
|
|
|
|
* **HTTP serving** with MIME types, gzip compression, caching, and custom `nginx.conf` templating.
|
|
* **TCP/UDP stream support** via the Nginx Streams module.
|
|
* **Directory management** for configuration, `sites-available`/`enabled`, cache, and data.
|
|
* **Debugging helpers**: log formats and instructions for general and detailed troubleshooting.
|
|
|
|
## Features
|
|
|
|
* **Package installation** of `nginx` and `nginx-mod-stream`.
|
|
* **Idempotent setup**: tasks run only once per host.
|
|
* **Configurable reset and cleanup** modes to purge and recreate directories.
|
|
* **Custom `nginx.conf`** template with sensible defaults for performance and security.
|
|
* **Stream proxy support**: includes `stream` block for TCP/UDP proxies.
|
|
* **Cache directory management**: cleanup and recreation based on `MODE_CLEANUP`.
|
|
|
|
|
|
## Debugging Tips
|
|
|
|
* **General logs**: `journalctl -f -u nginx`
|
|
* **Filter by host**: `journalctl -u nginx -f | grep "{{ inventory_hostname }}"`
|
|
* **Enable detailed format**: set `MODE_DEBUG: true` and reload Nginx.
|