marcusianlevine.nginx-container

#nginx-container

Dodaje usługę nginx do Twojego projektu Ansible Container. Uruchom następujące polecenia, aby zainstalować usługę:

# Ustaw katalog roboczy na katalog główny Twojego projektu Ansible Container
$ cd myproject

# Zainstaluj usługę
$ ansible-container install ansible.nginx-container

Wymagania

Ansible Container

Istniejący projekt Ansible Container. Aby stworzyć projekt, po prostu uruchom następujące polecenia:

# Utwórz pusty katalog projektu
$ mkdir myproject

# Ustaw katalog roboczy na nowy katalog
$ cd myproject

# Zainicjuj projekt
$ ansible-container init

Zmienne roli

STATIC_ROOT: /static

Ścieżka do treści statycznej, która będzie serwowana przez nginx.

STATIC_LOCATION: {{ STATIC_ROOT }}/

Żądania, które pasują do tego wzoru, będą aliasowane na katalog {{ STATIC_ROOT }}. Zwykle "/static/" lub "/assets/".

PIDFILE_DIR: /run/nginx

Ścieżka, w której nginx przechowa wartość aktualnego PID.

ASSET_PATHS: []

Lista ścieżek, z których treści statyczne będą kopiowane. Treści będą kopiowane do {{ STATIC_ROOT }}.

UWAGA Ścieżki muszą być ważne w obrębie kontenera budowania Ansible. Jeśli kopiujesz pliki źródłowe, zamontuj katalog źródłowy w kontenerze budowania za pomocą --with-volumes.

PROXY: no

Gdy używasz tej roli w aplikacji demo, nginx musi proxy'ować usługę django, więc ustaw to na 'yes'.

PROXY_PASS: ""

Adres serwera zaplecza, który przyjmuje żądania proxy. Na przykład: http://django:8080

PROXY_LOCATION: ""

Łańcuch zawierający opcjonalny modyfikator oraz wzór pasujący. Żądania zawierające pasujący wzór są przesyłane pod adres PROXY_PASS. Na przykład,~* /(api|static) przekieruje żądania zaczynające się od /api lub /static.

PROXY_CONNECT_TIMEOUT: 60

Ustaw proxy_connect_timeout na tę wartość w sekundach. Zgodnie z dokumentacją NGINX, nie może przekraczać 75s.

PROXY_SEND_TIMEOUT: 60

Ustaw proxy_send_timeout na tę wartość w sekundach.

PROXY_READ_TIMEOUT: 60

Ustaw proxy_read_timeout na tę wartość w sekundach.

Opcjonalne

EXTRA_CONFIG

Lista bezwzględnych ścieżek do dodatkowych szablonów konfiguracji NGINX, które mają być umieszczone w /etc/nginx/conf.d Nazwy plików muszą kończyć się na .conf.j2, ale określ tę listę tylko jako .conf!

Zależności

Brak.

Wnoszenie wkładu

Dla wygody, podczas pracy nad zmianami w tej roli, możesz przetestować je, korzystając z następującego przepływu pracy:

# Zatwierdź swoje zmiany
$ git commit -m

# Wyślij swoje zmiany 
$ git push 

# Ustaw katalog roboczy na katalog testów
$ cd tests 

# Uruchom budowę, która instaluje rolę w najnowszym zatwierdzeniu 
$ ./build.sh

Kilka uwag:

Musisz git push swoje zmiany, aby budowa mogła je uwzględnić.
Zmodyfikuj build.sh, aby wskazywał na Twój forka tej roli.
Jeśli wszystko pójdzie dobrze, a budowa zakończy się sukcesem, kontener zbudowany z Twojego najnowszego zatwierdzenia będzie działał w tle.
Działający kontener opublikuje port 8000:8000, więc jeśli skierujesz przeglądarkę na http://localhost:8000, powinieneś zobaczyć domową stronę nginx.