openeuler/nginx Docker Image

Quick reference

• The official Nginx docker image.

• Maintained by: https://gitee.com/openeuler/cloudnative.

• Where to get help: https://gitee.com/openeuler/cloudnative, https://gitee.com/openeuler/community.

Nginx | openEuler

Current Nginx docker images are built on the https://repo.openeuler.org/. 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 *, 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 []⁠.

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 ***load ***.

• 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

  bash
  docker pull openeuler/nginx:{Tag}
  

• Start a nginx instance

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

  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 https://nginx.org/en/docs/⁠ nginx.conf.

• View container running logs

  bash
  docker logs -f my-nginx
  

• To get an interactive shell

  bash
  docker exec -it my-nginx /bin/bash
  

Question and answering

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