mirror of
https://github.com/GeekOops/geekoops-nginx.git
synced 2024-06-02 19:12:21 +00:00
62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
|
# geekoops-nginx
|
||
|
|
|
||
|
|
Configurable ansible role for setting up a nginx webserver on a Linux server. Works with
|
||
|
|
|
||
|
|
- openSUSE Leap 15.2
|
||
|
|
- Debian Buster
|
||
|
|
|
||
|
|
## Role Variables
|
||
|
|
--------------
|
||
|
|
|
||
|
|
You can set the following variables to configure the role. Here listed are the variables and their default settings.
|
||
|
|
|
||
|
|
Firewall configuration (disable by default)
|
||
|
|
|
||
|
|
config_firewall: false # Enable firewall configuration
|
||
|
|
firewall_zone: "public" # Firewall zone to configure
|
||
|
|
open_http: true # Enable http on the firewall_zone
|
||
|
|
open_https: true # Enable https on the firewall_zone
|
||
|
|
|
||
|
|
Custom `nginx` settings
|
||
|
|
|
||
|
|
nginx_user: "nginx" # Default nginx user (for permission ecc.)
|
||
|
|
nginx_group: "nginx" # Default nginx group (for permission ecc.)
|
||
|
|
|
||
|
|
|
||
|
|
## Example Playbook
|
||
|
|
|
||
|
|
Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
|
||
|
|
|
||
|
|
- hosts: servers
|
||
|
|
roles:
|
||
|
|
- { role: geekoops-nginx, config_firewall: true }
|
||
|
|
|
||
|
|
A bit more advanced example for the imaginary `jellyfish` test server
|
||
|
|
|
||
|
|
- hosts: jellyfish
|
||
|
|
roles:
|
||
|
|
- role: geekoops-nginx
|
||
|
|
vars:
|
||
|
|
setup_default_page: true
|
||
|
|
default_page_hostname: "{{ansible_host}}"
|
||
|
|
config_firewall: true
|
||
|
|
firewall_zone: "public"
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT
|
||
|
|
|
||
|
|
## Author Information
|
||
|
|
|
||
|
|
phoenix
|
||
|
|
|
||
|
|
Have a lot of fun!
|
||
|
|
|
||
|
|
# Development
|
||
|
|
|
||
|
|
## Add githooks
|
||
|
|
|
||
|
|
This repository ships pre-commit git hooks that will check the yaml syntax. To configure them do
|
||
|
|
|
||
|
|
git config --local core.hooksPath .githooks/
|