Installing and Configuring Nginx Gateway

Overview

Documents installation and configuration of Nginx.

Details

Download the software and install as a Linux package.

Configure local virtual settings in the /etc/nginx/conf.d/virtual.conf file.  Here is a sample used for the reference deployment (also in config/src/main/resources/nginx):

 

  server {
    server_name umls.terminology.tools;
    listen 80;
    rewrite ^ https://$host$request_uri permanent;
  }

  server {
    server_name umls.terminology.tools;
    listen 443 ssl;
    access_log /var/log/nginx/sct.access.log;
    ssl_certificate     /etc/ssl/newcerts/bundle.crt;
    ssl_certificate_key /etc/ssl/private/terminology.tools.key;
    location ~ ^\/$ {
                rewrite ^ /index.html;
    }
    location / {
        proxy_pass http://localhost:8080/umls-server-rest/;
        proxy_read_timeout 300;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto "https";
        proxy_set_header X-Url-Scheme $scheme;
        proxy_redirect off;
      if ( -f /opt/maint/maintain.html){
        return 503;
      }
    }
    error_page 503 @maintenance;
    location @maintenance {
                root /opt/maint;
                rewrite ^(.*)$ /maintain.html break;
    }
  }