sebclem/ansible-role-nginx
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update docs

Browse Source 
* Update README
* Update Ansible Galaxy metadata
* Fix syntax on defaults file
This commit is contained in:
Alessandro Fael Garcia 2018-07-18 15:01:16 -07:00
parent 0fef56b4fa
commit dcfa8cd43b
3 changed files with 223 additions and 193 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
README.md
View File

@ -17,6 +17,7 @@ It supports all platforms supported by [NGINX Open Source](https://nginx.org/en/
**NGINX Open Source:**
```yaml
CentOS:
versions:
- 6
@ -33,13 +34,28 @@ It supports all platforms supported by [NGINX Open Source](https://nginx.org/en/
versions:
- trusty
- xenial
- zesty
- artful
- bionic
SUSE/SLES:
versions:
- 12
FreeBSD:
versions:
- 10
- 11
```
**NGINX Plus:**
```yaml
CentOS:
versions:
- 6
- 7
RedHat:
versions:
- 6
- 7
Debian:
versions:
- jessie
@ -48,33 +64,27 @@ It supports all platforms supported by [NGINX Open Source](https://nginx.org/en/
versions:
- trusty
- xenial
- zesty
- artful
CentOS:
versions:
- 6.5
- 7
RedHat:
versions:
- 6.5
- 7
- bionic
Oracle Linux:
versions:
- 6.5
- 7
Amazon Linux:
versions:
- 2016.09
- 2018.03
SUSE/SLES:
versions:
- 12
FreeBSD:
versions:
- 10.3
- 10
- 11
```
**NGINX Unit:**
```yaml
CentOS:
versions:
- 6
@ -94,13 +104,20 @@ It supports all platforms supported by [NGINX Open Source](https://nginx.org/en/
- bionic
Amazon Linux:
versions:
- 2016.09
- 2018.03
- 2
FreeBSD:
versions:
- 10
- 11
```
Role Variables
--------------
This role has multiple variables. The defaults for all these variables are the following:
```yaml
---
# Install NGINX.
# Default is true.
@ -198,6 +215,7 @@ This role has multiple variables. The defaults for all these variables are the f
# Default is false.
unit_enable: false
unit_modules: null
```
Dependencies
------------
@ -209,14 +227,17 @@ Example Playbook
This is a sample playbook file for deploying the Ansible Galaxy NGINX role in a localhost and installing the open source version of NGINX.
```yaml
---
- hosts: localhost
become: true
roles:
- role: nginxinc.nginx
```
This is a sample playbook file for deploying the Ansible Galaxy NGINX role in a localhost and installing NGINX Plus.
```yaml
---
- hosts: localhost
become: true
@ -224,17 +245,21 @@ This is a sample playbook file for deploying the Ansible Galaxy NGINX role in a
- role: nginxinc.nginx
vars:
type: plus
```
This is a sample playbook file for deploying the Ansible Galaxy NGINX role to a dynamic inventory containing the `nginx` tag.
```yml
---
- hosts: tag_nginx
remote_user: root
roles:
- role: nginxinc.nginx
```
This is a sample playbook file for deploying the Ansible Galaxy NGINX role in a localhost to install NGINX Unit and the PHP/Perl NGINX Unit language modules.
```yml
---
- hosts: localhost
become: true
@ -246,6 +271,7 @@ This is a sample playbook file for deploying the Ansible Galaxy NGINX role in a
unit_modules:
- unit-php
- unit-perl
```
To run any of the above sample playbooks create a `setup-nginx.yml` file and paste the contents. Executing the Ansible Playbook is then as simple as executing `ansible-playbook setup-nginx.yml`.

12
meta/main.yml
View File

@ -1,7 +1,8 @@
---
galaxy_info:
author: Alessandro Fael Garcia
description: Official Ansible role for NGINX
company: NGINX Inc
company: NGINX, Inc.
license: Apache License, Version 2.0
@ -10,15 +11,14 @@ galaxy_info:
platforms:
- name: Debian
versions:
- wheezy
- jessie
- stretch
- name: Ubuntu
versions:
- precise
- trusty
- xenial
- yakkety
- artful
- bionic
- name: EL
versions:
- 6
@ -26,6 +26,10 @@ galaxy_info:
- name: SLES
versions:
- 12
- name: FreeBSD
versions:
- 10
- 11
galaxy_tags:
- nginx