ansible-role-ara-frontend-nginx
===============================

A role for deploying a minimal installation of nginx for ara-api and ara-web.

This role is not meant to be used on it's own, it should be included by the
``ara_api`` and ``ara_web`` roles in order to have the necessary variables
available.

It is currently tested and supported against Ubuntu 18.04 and Fedora 29.

Role Variables
--------------

- ``ara_api_frontend_vhost``: Path to a custom nginx vhost configuration file for ara-api.
- ``ara_web_frontend_vhost``: Path to a custom nginx vhost configuration file for ara-web.

Example playbooks
-----------------

Install ARA and set up the API to be served by nginx with a custom vhost configuration
in front of gunicorn::

    # The API will be reachable at http://api.ara.example.org
    # The web interface will be reachable at http://web.ara.example.org
    # The web interface will be set up to query api.ara.example.org.
    - name: Deploy ARA API server and web interface
      hosts: all
      gather_facts: yes
      vars:
        # ara_api
        ara_api_frontend_server: nginx
        ara_api_wsgi_server: gunicorn
        ara_api_fqdn: api.ara.example.org
        ara_api_allowed_hosts:
          - api.ara.example.org
        ara_api_frontend_vhost: custom_api_vhost.conf.j2
        # ara_web
        ara_web_fqdn: web.ara.example.org
        ara_web_api_endpoint: "http://api.ara.example.org"
        ara_web_frontend_server: nginx
        ara_web_frontend_vhost: custom_web_vhost.conf.j2
      roles:
        - ara_api
        - ara_web

Copyright
---------

::

    Copyright (c) 2019 Red Hat, Inc.

    ARA Records Ansible is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    ARA Records Ansible is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with ARA Records Ansible. If not, see <http://www.gnu.org/licenses/>.