===== Web Proxy for Jenkins =====

At the end of this lesson you will be able to connect to your Jenkins instance from a web browser. This web request passes through the nginx reverse web proxy we setup in a previous lesson.

On Master, edit the existing nginx configuration file for //master//:
<code>
sudo vi /etc/nginx/sites-available/master
</code>

Building on our existing nginx configuration, we include configuration options for Jenkins below the gogs configuration stanza, save and close:

<code xml>
    location ^~ /jenkins/ {
        proxy_pass http://localhost:8080/jenkins/;

        # The following settings from https://wiki.jenkins-ci.org/display/JENKINS/Running+Hudson+behind+Nginx
        sendfile off;

        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_max_temp_file_size 0;

        #this is the maximum upload size
        client_max_body_size       10m;
        client_body_buffer_size    128k;

        proxy_connect_timeout      90;
        proxy_send_timeout         90;
        proxy_read_timeout         90;

        proxy_buffer_size          4k;
        proxy_buffers              4 32k;
        proxy_busy_buffers_size    64k;
        proxy_temp_file_write_size 64k;
    }
</code>

The full nginx configuration file ///etc/nginx/sites-available/master// should look like this:

<file xml master>
server {
    listen 80;
    server_name master;
 
    location /gogs/ {
        proxy_pass http://localhost:3000/;
    }

    location ^~ /jenkins/ {
        proxy_pass http://localhost:8080/jenkins/;

        # The following settings from https://wiki.jenkins-ci.org/display/JENKINS/Running+Hudson+behind+Nginx
        sendfile off;

        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_max_temp_file_size 0;

        #this is the maximum upload size
        client_max_body_size       10m;
        client_body_buffer_size    128k;

        proxy_connect_timeout      90;
        proxy_send_timeout         90;
        proxy_read_timeout         90;

        proxy_buffer_size          4k;
        proxy_buffers              4 32k;
        proxy_busy_buffers_size    64k;
        proxy_temp_file_write_size 64k;
    }

}
</file>

The master site configuration is already enabled so all we need to do is restart the nginx service:
<code>
sudo service nginx restart
</code>

Now visit [[http://master/jenkins|http://master/jenkins/]] to access the Jenkins CI service through the reverse proxy.

=== Resources ===
  * [[https://wiki.jenkins-ci.org/display/JENKINS/Jenkins+behind+an+NGinX+reverse+proxy|Jenkins]] - behind nginx reverse-proxy