Ansible Rolle: Nginx

Hinweis: Bitte ziehen Sie in Betracht, die offizielle NGINX Ansible Rolle von NGINX, Inc. zu verwenden.

Installiert Nginx auf RedHat/CentOS, Debian/Ubuntu, Archlinux, FreeBSD oder OpenBSD-Servern.

Diese Rolle installiert und konfiguriert die neueste Version von Nginx aus dem Nginx-Yum-Repository (auf RedHat-basierten Systemen), apt (auf Debian-basierten Systemen), pacman (Archlinux), pkgng (auf FreeBSD-Systemen) oder pkg_add (auf OpenBSD-Systemen). Es ist wahrscheinlich, dass Sie nach der Installation von Nginx durch diese Rolle zusätzliche Konfigurationen vornehmen müssen, wie z.B. das Hinzufügen Ihrer eigenen [virtualhost].conf-Datei in /etc/nginx/conf.d/, die beschreibt, wo und welche Optionen für Ihre Website verwendet werden sollen.

Anforderungen

Keine.

Rollenvariablen

Verfügbare Variablen sind unten aufgelistet, zusammen mit Standardwerten (siehe defaults/main.yml):

• nginx_listen_ipv6: true
  Ob auf IPv6 gehört werden soll (gilt für alle vhosts, die von dieser Rolle verwaltet werden).

• nginx_vhosts: []
  Eine Liste von vhost-Definitionen (Serverblöcke) für Nginx-virtuelle Hosts. Jeder Eintrag erstellt eine separate Konfigurationsdatei, benannt nach server_name. Wenn leer gelassen, müssen Sie Ihre eigene virtuelle Host-Konfiguration bereitstellen. Siehe das kommentierte Beispiel in defaults/main.yml für verfügbare Serveroptionen. Wenn Sie viele Anpassungen für Ihre Serverdefinitionen benötigen, ist es besser, die vhost-Konfigurationsdatei selbst zu verwalten und diese Variable auf [] zu lassen.

• nginx_remove_default_vhost: false
  Ob die 'default'-Virtuellenhost-Konfiguration, die von Nginx bereitgestellt wird, entfernt werden soll. Nützlich, wenn die Basis-URL / auf einen Ihrer eigenen virtuellen Hosts in einer separaten .conf-Datei verweisen soll.

• nginx_user: "nginx"
  Der Benutzer, unter dem Nginx ausgeführt wird. Standardmäßig ist das nginx für RedHat, www-data für Debian und www auf FreeBSD und OpenBSD.

• nginx_worker_processes: "{{ ansible_processor_vcpus|default(ansible_processor_count) }}"
  Anzahl der Worker-Prozesse, sollte auf die Anzahl der Kerne Ihres Rechners gesetzt werden.

• nginx_error_log: "/var/log/nginx/error.log warn"
  Konfiguration des Standard-Fehlerprotokolls. Setzen Sie auf off, um ein Protokoll vollständig zu deaktivieren.

• nginx_client_max_body_size: "64m"
  Dieser Wert bestimmt die maximale Dateigröße für Uploads.

Beispiel-Playbook

- hosts: server
  roles:
    - { role: geerlingguy.nginx }

Lizenz

MIT / BSD

Autoreninformationen

Diese Rolle wurde 2014 von Jeff Geerling erstellt, Autor von Ansible for DevOps.