minor: add basic proxy role (#2)

Reviewed-on: #2
Co-authored-by: Luciano Giacchetta <luciano@gianet.us>
Co-committed-by: Luciano Giacchetta <luciano@gianet.us>

README.md

@@ -1,2 +1,76 @@
-# ansible_role_reverse
+ansible_role_proxy
+==================
 
+Complete Proxy Server Role based on Traefik. This role installs and configures Traefik as a reverse proxy on Debian and Ubuntu systems.
+
+Requirements
+------------
+
+This role requires Ansible 2.12 or higher. The target system should be Debian or Ubuntu.
+
+Role Variables
+--------------
+
+The following variables are defined in `defaults/main.yml`:
+
+| Variable | Description | Default Value |
+|----------|-------------|---------------|
+| `traefik_name` | Name of the service and user | `traefik` |
+| `traefik_version` | Traefik version to install | `v3.6.7` |
+| `traefik_opt` | Installation directory | `/opt/{{ traefik_name }}` |
+| `traefik_etc` | Configuration directory | `/etc/{{ traefik_name }}` |
+| `traefik_conf_d` | Dynamic configuration directory | `{{ traefik_etc }}/conf.d` |
+| `traefik_global_checkNewVersion` | Check for new versions | `false` |
+| `traefik_global_sendAnonymousUsage` | Send anonymous usage data | `false` |
+| `traefik_entrypoints` | Dictionary defining Traefik entrypoints | `{ web: { address: ':80' }, websecure: { address: ':443' } }` |
+| `traefik_api` | Enable Traefik API | `false` |
+| `traefik_api_dashboard` | Enable Traefik Dashboard | `false` |
+| `traefik_api_insecure` | Enable insecure API access | `false` |
+| `traefik_providers_file` | Enable file provider | `true` |
+| `traefik_providers_file_directory` | Directory for dynamic configuration files | `/etc/traefik/conf.d/` |
+| `traefik_providers_file_watch` | Watch for changes in dynamic configuration | `true` |
+| `traefik_log_level` | Log level | `ERROR` |
+| `traefik_log_format` | Log format | `common` |
+| `traefik_metrics_prometheus` | Enable Prometheus metrics | `false` |
+| `traefik_routing_http` | HTTP routing configuration dictionary | `{}` |
+| `traefik_routing_tcp` | TCP routing configuration dictionary | `{}` |
+| `traefik_routing_udp` | UDP routing configuration dictionary | `{}` |
+| `traefik_routing_tls` | TLS routing configuration dictionary | `{}` |
+
+Dependencies
+------------
+
+None.
+
+Example Playbook
+----------------
+
+```yaml
+- hosts: proxy_servers
+  roles:
+     - role: ansible_role_proxy
+       vars:
+         traefik_api_dashboard: true
+         traefik_routing_http:
+           routers:
+             my-router:
+               rule: "Host(`example.com`)"
+               service: my-service
+           services:
+             my-service:
+               loadBalancer:
+                 servers:
+                   - url: "http://1.1.1.1:8080"
+```
+
+License
+-------
+
+GPL-3.0-only
+
+Author Information
+------------------
+
++ Luciano Giacchetta
++ Giacchetta Networks LLC
++ https://gianet.us/engineering/ansible_role_proxy