openeuler/nginx repository overview

⁠Quick reference

• The official Nginx docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠Nginx | openEuler

Current Nginx docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

Nginx (pronounced "engine-x") is an open source reverse proxy server for HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer, HTTP cache, and a web server (origin server). The nginx project started with a strong focus on high concurrency, high performance and low memory usage. It is licensed under the 2-clause BSD-like license and it runs on Linux, BSD variants, Mac OS X, Solaris, AIX, HP-UX, as well as on other *nix flavors. It also has a proof of concept port for Microsoft Windows. Learn more on https://en.wikipedia.org/wiki/Nginx⁠⁠.

Features:

• Nginx is easy to configure in order to serve static web content⁠ or to act as a proxy server⁠.

• Nginx can be deployed to also serve dynamic content⁠ on the network using FastCGI⁠, SCGI⁠ handlers for scripts⁠, WSGI⁠ application servers or Phusion Passenger⁠ modules, and can serve as a software load balancerload balancer⁠.

• Nginx uses an asynchronous⁠ event-driven⁠ approach, rather than threads, to handle requests. Nginx's modular event-driven architecture⁠ can provide predictable performance under high loads.

⁠Supported tags and respective Dockerfile links

The tag of each nginx docker image is consist of the version of nginx and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} and container startup options based on their requirements.

• Pull the openeuler/nginx image from docker

  docker pull openeuler/nginx:{Tag}
  

  Copy

• Start a nginx instance

  docker run -d --name my-nginx -p 8080:80 openeuler/nginx:{Tag}
  

  Copy

  After the instance my-nginx is started, access the Nginx service through http://localhost:8080.

• Container startup options

  Option	Description
  -p 8080:80	Expose nginx on localhost:8080.
  -v /local/path/to/website:/var/www/html	Mount and serve a local website.
  -v /path/to/conf.template:/etc/nginx/templates/conf.template	Mount template files inside /etc/nginx/templates. They will be processed and the results will be placed at /etc/nginx/conf.d. (e.g. listen ${NGINX_PORT}; will generate listen 80).
  -v /path/to/nginx.conf:/etc/nginx/nginx.conf	Local configuration file⁠⁠ nginx.conf.

• View container running logs

  docker logs -f my-nginx
  

  Copy

• To get an interactive shell

  docker exec -it my-nginx /bin/bash
  

  Copy

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.