mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-10-10 18:58:10 +02:00
refactor(webserver): rename roles and update references
- 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
This commit is contained in:
24
roles/sys-svc-webserver-core/README.md
Normal file
24
roles/sys-svc-webserver-core/README.md
Normal file
@@ -0,0 +1,24 @@
|
||||
# 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.
|
Reference in New Issue
Block a user