marcusianlevine.nginx-container

nginx-container

Ajoute un service nginx à votre projet Ansible Container. Exécutez les commandes suivantes pour installer le service :

# Définir le répertoire de travail à la racine de votre projet Ansible Container
$ cd monprojet

# Installer le service
$ ansible-container install ansible.nginx-container

Exigences

Ansible Container

Un projet Ansible Container existant. Pour créer un projet, exécutez simplement ce qui suit :

# Créer un répertoire de projet vide
$ mkdir monprojet

# Définir le répertoire de travail sur le nouveau répertoire
$ cd monprojet

# Initialiser le projet
$ ansible-container init

Variables de Rôle

STATIC_ROOT: /static

Chemin vers le contenu statique à servir par nginx.

STATIC_LOCATION: {{ STATIC_ROOT }}/

Les requêtes qui correspondent à ce modèle seront redirigées vers le répertoire {{ STATIC_ROOT }}. Généralement "/static/" ou "/assets/".

PIDFILE_DIR: /run/nginx

Chemin où nginx stockera la valeur actuelle du PID.

ASSET_PATHS: []

Liste des chemins à partir desquels le contenu statique sera copié. Le contenu sera copié vers {{ STATIC_ROOT }}.

REMARQUE les chemins doivent être valides dans le conteneur de construction Ansible. Si vous copiez des fichiers sources, montez le répertoire source dans le conteneur de construction en utilisant --with-volumes.

PROXY: non

Lorsque vous utilisez ce rôle comme partie de l'application de démonstration, nginx doit faire un proxy du service django, auquel cas définissez cela sur 'oui'.

PROXY_PASS: ""

L'adresse du serveur backend acceptant les requêtes proxy. Par exemple : http://django:8080

PROXY_LOCATION: ""

Une chaîne contenant un modificateur facultatif et un modèle correspondant. Les requêtes contenant le modèle correspondant sont transférées à l'adresse PROXY_PASS. Par exemple, ~* /(api|static) transférera les requêtes qui commencent par /api ou /static.

PROXY_CONNECT_TIMEOUT: 60

Définissez le proxy_connect_timeout avec cette valeur en secondes. Selon la documentation de NGINX, ne peut pas dépasser 75 s.

PROXY_SEND_TIMEOUT: 60

Définissez proxy_send_timeout avec cette valeur en secondes.

PROXY_READ_TIMEOUT: 60

Définissez le proxy_read_timeout avec cette valeur en secondes.

Optionnel

EXTRA_CONFIG

Liste de chemins absolus vers des modèles de configuration NGINX supplémentaires à placer dans /etc/nginx/conf.d Les noms de fichiers doivent se terminer par .conf.j2, mais spécifiez cette liste juste avec .conf !

Dépendances

Aucune.

Contribuer

Pour votre commodité, pendant que vous travaillez sur des modifications pour ce rôle, vous pouvez tester en utilisant le flux de travail suivant :

# Validez vos modifications
$ git commit -m

# Poussez vos modifications 
$ git push 

# Définir le répertoire de travail sur tests
$ cd tests 

# Exécutez un build qui installe le rôle à partir du dernier commit 
$ ./build.sh

Quelques notes :

Vous devez git push vos modifications pour que le build les prenne en compte.
Modifiez build.sh pour pointer vers votre fork de ce rôle.
Si tout se passe bien et que le build réussit, le conteneur construit à partir de votre dernier commit sera en cours d'exécution en arrière-plan.
Le conteneur en cours d'exécution publiera le port 8000:8000, donc si vous ouvrez un navigateur sur http://localhost:8000, vous devriez voir la page par défaut de nginx.