www/nginx: add a basic load balancer how to

source/manual/how-tos/nginx.rst

@@ -0,0 +1,49 @@
+===========================
+nginx: Basic Load Balancing
+===========================
+
+1) Create Upstream Servers
+--------------------------
+
+.. image:: images/nginx_upstream_servers.png
+
+.. image:: images/nginx_edit_upstream_dialog.png
+
+Create a server with a description and IP of the server. The priority is not important if you have a single server.
+It is used as a weight for round robin. Servers with a higher weight will receive more traffic.
+
+2) Create An Upstream
+---------------------
+
+.. image:: images/nginx_edit_upstream.png
+
+Group upstream servers to an upstream. An upstream is a group of servers to load balance between.
+Give it a useful name and choose the previously created server.
+
+3) Create A Location
+--------------------
+
+.. image:: images/nginx_edit_location_dialog.png
+
+Locations are are used to map URLs to upstreams, directories, settings and so on.
+In our case we want to proxy the request to the previously created upstream.
+If we want to match everything, we use "/" without a special matcher.
+Now save the location.
+
+4) Create A HTTP Server
+-----------------------
+
+.. image:: images/nginx_edit_http_server_dialog.png
+
+In the last step, we have to create a port.
+This happens in a "http" block, which contains some basic configuration and the location blocks.
+
+Enter the domain name into the "Server Name" field and select the previously created location.
+If you want to use support TLS, you have to add a certificate. 
+
+5) Restart nginx
+----------------
+
+.. image:: images/nginx_reload.png
+
+Click the reload button and you are done.