Nginx 1.12 server and a reverse proxy server container image

=========================================================

This container image includes Nginx 1.12 server and a reverse server for OpenShift and general usage.

Users can choose RHEL based image.

The RHEL image is available in the [Red Hat Container Catalog](https://access.redhat.com/containers/#/registry.access.redhat.com/rhscl/nginx-112-rhel7)

as registry.access.redhat.com/rhscl/nginx-112-rhel7.

Description

-----------

Nginx is a web server and a reverse proxy server for HTTP, SMTP, POP3 and IMAP 

protocols, with a strong focus on high concurrency, performance and low memory usage. The container 

image provides a containerized packaging of the nginx 1.12 daemon. The image can be used 

as a base image for other applications based on nginx 1.12 web server. 

Nginx server image can be extended using source-to-image tool.

Usage

-----

To build a simple [sample-app](https://github.com/sclorg/nginx-container/tree/master/1.12/test/test-app) application

using standalone [S2I](https://github.com/openshift/source-to-image) and then run the

resulting image with [Docker](http://docker.io) execute:

*  **For RHEL based image**

    ```

    $ s2i build https://github.com/sclorg/nginx-container.git --context-dir=1.12/test/test-app/ rhscl/nginx-112-rhel7 nginx-sample-app

    $ docker run -p 8080:8080 nginx-sample-app

    ```

*  **For CentOS based image**

    ```

    $ s2i build https://github.com/sclorg/nginx-container.git --context-dir=1.12/test/test-app/ centos/nginx-112-centos7 nginx-sample-app

    $ docker run -p 8080:8080 nginx-sample-app

    ```

**Accessing the application:**

```

$ curl 127.0.0.1:8080

```

S2I build support

-------------

Nginx server image can be extended using S2I tool (see Usage section).

S2I build folder structure:

**`./nginx.conf`**--

       The main nginx configuration file

**`./nginx-cfg/*.conf`**  

       Should contain all nginx configuration we want to include into image

**`./nginx-default-cfg/*.conf`**  

       Contains any nginx config snippets to include in the default server block

**`./nginx-start/*.sh`**  

       Contains shell scripts that are sourced right before nginx is launched

**`./`**  

       Should contain nginx application source code

Environment variables and volumes

-------------

The nginx container image supports the following configuration variable, which can be set by using the `-e` option with the docker run command:

**`NGINX_LOG_TO_VOLUME`**  

       When `NGINX_LOG_TO_VOLUME` is set, nginx logs into `/var/opt/rh/rh-nginx112/log/nginx/`

You can mount your own web root like this:

```

$ docker run -v <DIR>:/var/www/html/ <container>

```

You can replace \<DIR> with location of your web root. Please note that this has to be an **absolute** path, due to Docker requirements.

Troubleshooting

---------------

By default, nginx logs into standard output, so the log is available in the container log. The log can be examined by running:

    docker logs <container>

**If `NGINX_LOG_TO_VOLUME` variable is set, nginx logs into `/var/opt/rh/rh-nginx112/log/nginx/`, which can be mounted to host system using the container volumes.**

See also

--------

Dockerfile and other sources for this container image are available on

https://github.com/sclorg/nginx-container.

In that repository, Dockerfile for CentOS is called Dockerfile, Dockerfile

for RHEL is called Dockerfile.rhel7.