Sys-svc-webserver-core Role

Description: No description available

Variables

• author: Kevin Veen-Birkenbach

• description: Installs and configures Nginx HTTP and stream modules with performance-tuned defaults.

• company: Kevin Veen-Birkenbach

Consulting & Coaching Solutions https://www.veen.world

• license: Infinito.Nexus NonCommercial License

• license_url: https://s.infinito.nexus/license

• min_ansible_version: 2.9

• galaxy_tags: [‘nginx’, ‘http’, ‘stream’, ‘caching’, ‘compression’, ‘security’, ‘performance’]

• repository: https://s.infinito.nexus/code

• issue_tracker_url: https://s.infinito.nexus/issues

• documentation: https://s.infinito.nexus/code/roles/sys-svc-webserver-core

README

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.