History

Shaun Reed 2bebf584f8 More README updates to read(?)		2019-08-31 02:47:50 -04:00
..
defaults	More README updates to read(?)	2019-08-31 02:47:50 -04:00
files	Add defaults to nginx role	2019-08-29 06:19:26 +00:00
handlers	Ansible nginx role using ansible-galaxy	2019-08-18 03:18:41 +00:00
meta	Ansible nginx role using ansible-galaxy	2019-08-18 03:18:41 +00:00
tasks	Add defaults to nginx role	2019-08-29 06:19:26 +00:00
tests	Ansible nginx role using ansible-galaxy	2019-08-18 03:18:41 +00:00
vars	Ansible nginx role using ansible-galaxy	2019-08-18 03:18:41 +00:00
README.md	More README updates to read(?)	2019-08-31 02:47:50 -04:00

README.md

nginx

A simple role for installing and configuring nginx on a new Ubuntu host using Ansible. Supports templates for index.html and custom nginx.conf

Requirements

Expects that the host is using apt package manager, and running a Debian / Ubuntu system.

Role Variables

Found in .../roles/nginx/defaults/main.yml

---
domain_name: "localhost"
nginx_root_dir: "/var/www/html/"
index_files: "index.html index.htm"

NGINX Configuration Variables -

domain_name - Domain name to be used in nginx.conf, default value is the same as nginx base package default setting (localhost)

nginx_root_dir - The directory to point the default nginx server to

index_files - The files / types to be checked for content in our root directory

Example Playbook

After configuring the approprate variables in .../defaults/main.yml, create the following play.yml and run ansible-playbook play.yml after setting the correct hosts in your /etc/ansible/hosts file.

---
- hosts: nginx-server
  become: yes
  roles:
  - nginx

Feel free to rename play.yml, hosts group name, etc. Just be sure it reflects to your settings in the related files.