mirror of
				https://github.com/kevinveenbirkenbach/computer-playbook.git
				synced 2025-10-31 10:19:09 +00:00 
			
		
		
		
	Refactored server roles for better readability
This commit is contained in:
		
							
								
								
									
										24
									
								
								roles/sys-svc-webserver/README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										24
									
								
								roles/sys-svc-webserver/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