ansible-role-apache/README.md

37 lines
1.2 KiB
Markdown

Apache2-Rolle
=============
Diese Rolle installiert Apache2 und richtet den Webserver grundlegend ein. Dies umfasst:
- Konfiguration für LE-Zertifikate per dehydrated
- Monitoring via Monit und Munin mit den entsprechenden Plugins
Die Rolle konfiguriert Apache grundsätzlich hinter einen Reverse Proxy. Soll der Webserver als Frontend-Webserver laufen
(inkl. SSL-Terminierung), muss in der jeweiligen `host_vars` folgendes gesetzt werden:
```YAML
apache:
is_proxy: true
```
## Client-IP-Adresse
Wenn Apache hinter einem Reverse-Proxy läuft und die IP-Adresse der sich verbindenden Clients benötigt wird, muss in den
`group_vars` die Variable `gateway_host_ip` gesetzt werden. Anschließend kann die entsprechende Apache-Konfiguration aktiviert werden:
```Shell
a2enconf remoteip
```
## Verfügbare Variablen
Mit folgenden Variablen in den `host_vars` kann Rolle individualisiert werden:
| Varible | Wert | Beschreibung |
|--|--|--|
| `check_memory_limit` | string | Speicher-Angabe, Bei Überschreitung wird Monitoring-Aktion ausgelöst |
| `is_proxy` | bol | `true`, wenn Apache Frontend-Webserver ist |
Beispiel:
```YAML
apache:
check_memory_limit: 500 MB
is_proxy: true
```