centos/nginx-18-centos7 repository overview

⁠Nginx 1.8 server and a reverse proxy server container image

This container image includes Nginx 1.8 server and a reverse server for OpenShift and general usage. Users can choose between RHEL and CentOS based images. The RHEL image is available in the Red Hat Container Catalog⁠ as registry.access.redhat.com/rhscl/nginx-18-rhel7. The CentOS image is then available on Docker Hub⁠ as centos/nginx-18-centos7.

⁠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.8 daemon. The image can be used as a base image for other applications based on nginx 1.8 web server. Nginx server image can be extended using source-to-image tool.

⁠Usage

To build a simple sample-app⁠ application using standalone S2I⁠ and then run the resulting image with Docker⁠ execute:

• For RHEL based image

  $ s2i build https://github.com/sclorg/nginx-container.git --context-dir=1.8/test/test-app/ rhscl/nginx-18-rhel7 nginx-sample-app
  $ docker run -p 8080:8080 nginx-sample-app
  

  Copy

• For CentOS based image

  $ s2i build https://github.com/sclorg/nginx-container.git --context-dir=1.8/test/test-app/ centos/nginx-18-centos7 nginx-sample-app
  $ docker run -p 8080:8080 nginx-sample-app
  

  Copy

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-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-nginx18/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-nginx18/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.