mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-11-04 04:08:15 +00:00
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.
|