Rola Ansible: Nginx

Uwaga: Proszę rozważyć użycie oficjalnej roli Ansible dla NGINX od NGINX, Inc.

Instaluje Nginx na serwerach RedHat/CentOS, Debian/Ubuntu, Archlinux, FreeBSD lub OpenBSD.

Ta rola instaluje i konfiguruje najnowszą wersję Nginx z repozytorium yum (w systemach opartych na RedHat), apt (w systemach opartych na Debianie), pacman (Archlinux), pkgng (w systemach FreeBSD) lub pkg_add (w systemach OpenBSD). Po zainstalowaniu Nginx, prawdopodobnie będziesz musiał dodać własny plik konfiguracyjny [virtualhost].conf w katalogu /etc/nginx/conf.d/, opisujący lokalizację i opcje dla twojej strony internetowej.

Wymagania

Brak.

Zmienne roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi (zobacz defaults/main.yml):

• nginx_listen_ipv6: true

Określa, czy nasłuchiwać na IPv6 (dotyczy wszystkich vhostów zarządzanych przez tę rolę).

• nginx_selfsigned_certificate_directory: /etc/nginx/ssl
• nginx_selfsigned_certificate_privkey: "{{ nginx_selfsigned_certificate_directory }}/privkey.pem"
• nginx_selfsigned_certificate_fullchain: "{{ nginx_selfsigned_certificate_directory }}/fullchain.pem"
• nginx_selfsigned_certificate_csr: "{{ nginx_selfsigned_certificate_directory }}/cert.csr"

Zmienna, która określa, gdzie powinien być utworzony certyfikat self-signed. Będzie używana w catchall-vhost oraz jako zamiennik brakujących certyfikatów w konfiguracji nginx-vhost.

• nginx_copy_missing_certs: yes

Określa, czy rola powinna kopiować certyfikaty self-signed dla vhostów.

• nginx_vhosts: []

Lista definicji vhostów (bloków serwera) dla wirtualnych hostów Nginx. Każdy wpis utworzy oddzielny plik konfiguracyjny o nazwie name. Jeśli pozostawisz ją pustą, będziesz musiał dostarczyć własną konfigurację wirtualnego hosta.

• nginx_remove_default_vhost: false

Określa, czy usunąć konfigurację domyślnego wirtualnego hosta dostarczoną przez Nginx. Przydatne, jeśli chcesz, aby podstawowy URL / kierował do jednego z twoich własnych wirtualnych hostów skonfigurowanych w oddzielnym pliku .conf.

• nginx_user: "nginx"

Użytkownik, pod którym będzie działać Nginx. Domyślnie nginx dla RedHat, www-data dla Debiana i www dla FreeBSD i OpenBSD.

• nginx_service_state: started
• nginx_service_enabled: yes

Domyślnie ta rola zapewni, że Nginx działa i jest włączony przy starcie po skonfigurowaniu Nginx. Możesz użyć tych zmiennych, aby nadpisać to zachowanie, jeśli instalujesz w kontenerze lub potrzebujesz dodatkowej kontroli nad stanem usługi.

Przykładowy plik playbook

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

Licencja

MIT / BSD

Informacje o autorze

Ta rola została stworzona w 2014 roku przez Jeffa Geerlinga, autora Ansible for DevOps.