Overview

This charm installs and configures NGINX. You can send (NGINX) config files to this charm and NGINX will be updated to add / remove these configurations. You can use this to expose microservices using an API gateway via Juju charms.

Usage

Deploy the gateway with the following:

juju deploy ./nginx-api-gateway

Add a relation with a charm that provides an upstream interface.

juju add-relation nginx-api-gateway service

Default behaviour

• All nginx location blocks will be merged into a single server block in /etc/nginx/sites-available/juju/server.
• Other configuration will be saved with the suffix -upstream in /etc/nginx/sites-available/juju.
• Do not store manual configurations in /etc/nginx/sites-available/juju. Configs will be removed when an upstream relation is changed.

Authors

This software was created in the IDLab research group of Ghent University in Belgium. This software is used in Tengu, a project that aims to make experimenting with data frameworks and tools as easy as possible.

• Sander Borny sander.borny@ugent.be