Nginx

Installation of Nginx load balancer

Nginx is used as both reverse proxy and load balancing for on-prem deployments.

Installation

  • Run this to install nginx.

    sudo apt install nginx
  • Run this to delete default server.

    sudo rm /etc/nginx/sites-enabled/default
  • Set client_max_body_size to 50m on /etc/nginx/nginx.conf:

    client_max_body_size 50m;
  • Restart nginx.

    sudo systemctl restart nginx

This is only a one-time installation. Whenever you want to add new servers to this Nginx, follow the Install Servers to Nginx Section.

Install servers to Nginx

Prerequisites

Installation

On AWS EC2, the number of network interfaces that can be created is limited depending on the node type. For example on t3a.small node, the maximum number of network interfaces is 2. Refer to EC2 Network Specifications for more info.

  • Once nginx server is installed, it will create sites-enabled and sites-available directories inside /etc/nginx directory.

  • Navigate to /etc/nginx/sites-available directory and create a file called <sandbox name>.conf (Example: prod-openg2p.conf) by using kubernetes/nginx/sites.sample.conf file as a template.

Creation of the <sandbox name>.conf file applies only to one server in the nginx node. Repeat this section for every server to be added.

  • Use a new Listen IP Address for every server. It is recommended to add a new network interface in the same VM which is part of the same network.

  • When configuring upstream servers, you need to configure the node port of the Istio IngressGateway. Therefore, it is important to understand the ports and determine which ports connect to which IngressGateway and for what purpose.

  • Run this to enable the server that is added now.

    sudo ln -s /etc/nginx/sites-available/<sandbox name>.conf /etc/nginx/sites-enabled/
  • Test nginx conf for errors.

    sudo nginx -t
  • Restart nginx.

    sudo systemctl restart nginx

Post-installation

Map the hostnames to Nginx IPs on your DNS service, such as Route53 on AWS.

Last updated

Logo

Copyright © OpenG2P. This work is licensed under Creative Common Attribution (CC-BY-4.0) International license unless otherwise noted.