This ansible role installs a Nginx server in a debian environment. Also installs lua needed for prometheus metrics.
These instructions will get you a copy of the role for your ansible playbook. Once launched, it will install a Nginx server in a Debian system.
Ansible 2.7.5.0 version installed. Inventory destination should be a Debian environment.
For testing purposes, Molecule with Docker as driver.
Create or add to your roles dependency file (e.g requirements.yml):
- src: idealista.nginx_role
version: 2.0.0
name: nginx
Install the role with ansible-galaxy command:
ansible-galaxy install -p roles -r requirements.yml -f
Use in a playbook:
---
- hosts: someserver
roles:
- role: nginx
Look to the defaults vars file to see the possible configuration vars.
The server is installed using the sources adding the headers-more module and lua module. You can add/remove compile built-in and
external modules by setting nginx_builtin_modules
and nginx_external_modules
vars.
You can add new servers to nginx by including your server as a file or as a template, setting the server
files in the path defined by nginx_extra_servers_path
or nginx_extra_servers_template_path
(see molecule tests as example).
If you want to change any version do it at your risk. Some nginx versions and modules are not compatible. Known compatible versions are:
Nginx: 1.10.* + lua_module_version: 0.10.7
Nginx: 1.12.* + lua_module_version: 0.10.11
Nginx: 1.14.* + lua_module_version: 0.10.13
$ pipenv install -r test-requirements.txt --python 2.7
$ MOLECULE_DISTRO=(debian8|debian9) pipenv run molecule test
Note: Debian9 (Debian Stretch) will be used as default linux distro if none is provided.
See molecule.yml to check possible testing platforms.
For the versions available, see the tags on this repository.
Additionaly you can see what change in each version in the CHANGELOG.md file.
- Idealista - Work with - idealista
See also the list of contributors who participated in this project.
This project is licensed under the Apache 2.0 license - see the LICENSE file for details.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.