Skip to content

Commit 0ed9afb

Browse files
committed
Add NGINX Unit documentation
1 parent 8a8f08a commit 0ed9afb

File tree

1 file changed

+50
-12
lines changed

1 file changed

+50
-12
lines changed

README.md

Lines changed: 50 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Ansible NGINX Role
44
[![Ansible Galaxy](https://img.shields.io/badge/galaxy-nginxinc.nginx-5bbdbf.svg)](https://galaxy.ansible.com/nginxinc/nginx)
55
[![Build Status](https://travis-ci.org/nginxinc/ansible-role-nginx.svg?branch=master)](https://travis-ci.org/nginxinc/ansible-role-nginx)
66

7-
This role installs open source NGINX or NGINX Plus on your target host.
7+
This role installs open source NGINX, NGINX Plus, or NGINX Unit on your target host.
88

99
Requirements
1010
------------
@@ -40,35 +40,57 @@ It supports all platforms supported by [open source NGINX](https://nginx.org/en/
4040

4141
**NGINX Plus:**
4242

43-
CentOS:
44-
versions:
45-
- 6
46-
- 7
47-
RedHat:
48-
versions:
49-
- 6
50-
- 7
5143
Debian:
5244
versions:
53-
- wheezy
5445
- jessie
5546
- stretch
5647
Ubuntu:
5748
versions:
5849
- trusty
5950
- xenial
6051
- zesty
52+
- artful
53+
CentOS:
54+
versions:
55+
- 6.5
56+
- 7
57+
RedHat:
58+
versions:
59+
- 6.5
60+
- 7
61+
Oracle Linux:
62+
versions:
63+
- 6.5
64+
- 7
65+
Amazon Linux:
66+
versions:
67+
- 2016.09
6168
SUSE/SLES:
6269
versions:
6370
- 12
6471
FreeBSD:
6572
versions:
6673
- 10.3
6774
- 11
68-
Oracle Linux:
75+
76+
**NGINX Unit:**
77+
78+
CentOS:
6979
versions:
70-
- 6.5
80+
- 6
7181
- 7
82+
RedHat:
83+
versions:
84+
- 6
85+
- 7
86+
Debian:
87+
versions:
88+
- jessie
89+
- stretch
90+
Ubuntu:
91+
versions:
92+
- xenial
93+
- artful
7294
Amazon Linux:
7395
versions:
7496
- 2016.09
@@ -89,6 +111,11 @@ This role has multiple variables. The defaults for all these variables are the f
89111
# Default is mainline.
90112
branch: mainline
91113

114+
# Install NGINX Unit and NGINX Unit packages.
115+
# Default is false.
116+
unit_enable: false
117+
unit_packages: false
118+
92119
# Install nginscript, perl, waf (NGINX Plus only), geoip, image-filter, rtmp and/or xslt modules.
93120
# Default is false.
94121
modules:
@@ -184,6 +211,17 @@ This is a sample playbook file for deploying the Ansible Galaxy NGINX role to a
184211
roles:
185212
- role: nginxinc.nginx
186213

214+
This is a sample playbook file for deploying the Ansible Galaxy NGINX role in a localhost to install NGINX Unit and all NGINX Unit language packages.
215+
216+
---
217+
- hosts: localhost
218+
become: true
219+
roles:
220+
- role: nginxinc.nginx
221+
vars:
222+
- unit_enable: true
223+
- unit_packages: true
224+
187225
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`.
188226

189227
Alternatively, you can also clone this repository instead of installing it from Ansible Galaxy. If you decide to do so, replace the role variable in the previous sample playbooks from `nginxinc.nginx` to `ansible-role-nginx`.

0 commit comments

Comments
 (0)