From 803c035d230ead2476e654066cc01a801128ccbe Mon Sep 17 00:00:00 2001 From: Emilien Mantel Date: Fri, 31 Jul 2015 12:28:25 +0200 Subject: [PATCH] Add more info in README --- README.md | 30 +++++++++++++++++++++++------- 1 file changed, 23 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 5f4eb2e..186fa26 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,9 @@ Nginx for Debian Ansible role ============================= -Install and configure Nginx on Debian +Install and configure Nginx on Debian. + +This role is not production ready. SSL management wille come later. Requirements ------------ @@ -43,14 +45,28 @@ Socket: ### Vhost management - - `nginx_vhosts`: + - `nginx_vhosts`: List of dict. A vhost has few keys. See bellow. -You need at least : "name". you can configure many templates (and yours !). +#### -Few tips: - - if you need another root (glpi, phpmyadmin... etc), you can specify "root" - - you can use your own templates, you must keep the same directory organization - - you should see COMMON.j2 to see all abilities + - `name`: (M) List of domain used. The first occurence is the most important! + - `template`: (M) template used to create vhost + - `enable`: (O) Enable the vhost (default is true) + - `delete`: (O) Delete the vhost (default is false) + - `redirect_from`: (O) Domain list to redirect to the first `name`. You can use this key to redirect non-www to www. + - `location`: Add new custom locations (it does not overwrite!) + +(O) : Optional +(M) : Mandatory + +#### Templates + + - `base`: static template + - `php`: PHP base template. Can work with many frameworks/tools. + - `wordpress` + - `dokuwiki` + +Templates works as parent-child. You can see many examples in: [tests/test.yml](tests/test.yml).