https://github.com/vitalk/ansible-nginx-proxy

Ansible recipe to configure a nginx as proxy server
https://github.com/vitalk/ansible-nginx-proxy

ansible nginx proxy-pass recipe

Last synced: 9 days ago
JSON representation

Ansible recipe to configure a nginx as proxy server

• Host: GitHub
• URL: https://github.com/vitalk/ansible-nginx-proxy
• Owner: vitalk
• Created: 2014-10-24T11:10:17.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2015-03-28T09:46:49.000Z (over 9 years ago)
• Last Synced: 2024-10-12T10:14:02.967Z (about 1 month ago)
• Topics: ansible, nginx, proxy-pass, recipe
• Homepage: https://galaxy.ansible.com/vitalk/nginx-proxy
• Size: 223 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Nginx proxy

Ansible recipe to configure a Nginx as proxy server. This recipe does not

trying to cover all available Nginx options and just use [the best practices](https://github.com/h5bp/server-configs-nginx)

to configure Nginx as proxy server.

## Role Variables

Option | Description

---|---

`nginx_enabled` | Enable nginx service on boot.

`nginx_state` | State of nginx service.

`nginx_app_config` | The path to nginx application config.

`app_name` | The name of the application, uses to create application configuration, e.g. should be a shorthand, lowercase and not contain any whitespaces.

This options are optional and bound to [the application config](templates/proxy-app.j2). Feel

free to define your own variables based on your configuration.

Option | Description

---|---

`app_ip` | The internal ip address of the web application.

`app_port` | The port used by application.

`app_fqdn` | Fully qualified domain name of the application. Non-www version.

## Usage example

If [the existing configuration](templates/proxy-app.j2) does not satisfy your

needs write your own.

```nginx

upstream backend {

    server backend1.example.com       weight=5;

    server backend2.example.com:8080;

    server unix:/tmp/backend3;

}

server {

    location / {

        proxy_pass http://backend;

    }

}

```

Put it somewhere with your playbooks, for example into

`roles/nginx-proxy/templates/myapp.j2` and point to it via `nginx_app_config`

variable.

### Note about relative import

Ansible imports paths relative to the playbook you play, so this layout...

```shell

$ tree

.

├── playbook.yml

└── roles

    └── nginx-proxy

        └── templates

            └── myapp.j2

```

...corresponds to this option

```ansible

nginx_app_config: roles/nginx-proxy/templates/myapp.j2

```

## License

Licensed under the [MIT license](http://mit-license.org/vitalk).

## Self-Promotion

Created by Vital Kudzelka.

Open [a GitHub issue](https://github.com/vitalk/ansible-nginx-proxy/issues) if you have any suggestions or found a bug.