Get Image
NGINX container image
Description
nginx (pronounced engine-x
) is an open-source reverse proxy server for the HTTP, HTTPS, SMTP, POP3, and IMAP protocols. nginx can also act as a load balancer, HTTP cache, and a web server (origin server).
Usage
By default, the image launches nginx with the same configuration that comes with the SUSE Linux Enterprise Server.
$ podman run -it --rm -p 8080:80 registry.suse.com/suse/nginx:1.21
Or:
$ podman run -it --rm -p 8080:80 -v /path/to/html/:/srv/www/htdocs/:Z registry.suse.com/suse/nginx:1.21
Note: The directory /srv/www/htdocs/
is the root directory used by the default server. Additional servers can use any other path.
You can access the served content on http://localhost:8080 or http://host-ip:8080.
Using templates
By default, nginx doesn't support environment variables inside configuration blocks. This image includes a script that can extract environment variables before nginx creates configuration files.
The script reads .template
files stored in /etc/nginx/templates/
and saves the result of the envsubst
command to the directory /etc/nginx/conf.d/
.
For example, if you want nginx to use port 80, create a file named /etc/nginx/templates/default.conf.template
containing the following variable definition:
listen ${NGINX_PORT};
The template above is then rendered to /etc/nginx/conf.d/default.conf
as follows:
listen 80;
Environment variables
NGINX_ENTRYPOINT_QUIET_LOGS
This optional environment variable controls the logging during container startup. Set the value to 1
to silence logs.
NGINX_ENTRYPOINT_WORKER_PROCESSES_AUTOTUNE
This optional environment variable enables a script to autotune the number of worker processes. Set the value to 1
to enable autotune of the worker process parameter (default is disabled).
NGINX_ENVSUBST_TEMPLATE_DIR
This optional environment variable specifies a directory containing template files (default is /etc/nginx/templates
).
Note: The script ignores template processing if this directory doesn't exist
NGINX_ENVSUBST_OUTPUT_DIR
This optional environment variable specifies a directory for storing results of running envsubst
on templates (default is /etc/nginx/conf.d
).
The output filename is the template filename with the suffix .template
removed.
Note: Modifying this variable also requires changing the nginx.conf
, so it recognizes the new directory location.
NGINX_ENVSUBST_TEMPLATE_SUFFIX
This optional environment variable changes the suffix of template files (default is .template
).
Note: The script only processes files that have the specified suffix in their names.
NGINX_ENVSUBST_FILTER
This optional environment variable enables filtering out variables in the template processing. Environment variables that do not match the regular expression defined by NGINX_ENVSUBST_FILTER
are not replaced.
Configuration scripts
To use scripts to perform configuration actions, add one or more *.envsh
or *.sh
scripts under /docker-entrypoint.d/
. Any executable *.envsh
or *.sh
script found in the directory is executed before starting the service, which can be used to perform further configuration steps.
Currently, the container image ships with the following helper scripts:
20-envsubst-on-templates.sh
- Enables the use of environment variables in templates.30-tune-worker-processes.sh
- Enables autotuning the number of worker processes.
Warning: The container startup is aborted if any of the scripts exits with an error.
Licensing
SPDX-License-Identifier: MIT
This documentation and the build recipe are licensed as MIT. The container itself contains various software components under various open source licenses listed in the associated Software Bill of Materials (SBOM).
This image is based on SUSE Linux Enterprise Server, a reliable, secure, and scalable server operating system built to power mission-critical workloads in physical and virtual environments.
-
Image Data
Last Built: 11 Dec 13:52 UTC
Compressed Size: 62.7 MB
Uncompressed Size: 183.6 MB
Support Level: L3
-
-
Health Index
ANo vulnerabilities found
Last Scan:
1 day ago