Public | Automated Build

Last pushed: 18 days ago
Short Description
s2i builder for nginx
Full Description

Source-to-image builder for static nginx containers

Basic use case

Have a git repo with a directory html (or NGINX_STATIC_DIR), in which all
static files to serve are.

s2i-nginx will take all files within, copy them into the docker image and take
a basic nginx config that will simply serve these files.

If there is no html directory, it will just copy all files in the repo.
In that case you will not be able to customize the nginx config.

Configuring nginx

You can supply a nginx.conf-snippet that will be used by the built container.

If there is a directory conf.d containing (possibly multiple) nginx server
snippets these will be used. It will not copy the default config, so be
sure to include the right files. See etc/nginx.server.sample.conf for the
default config.

Auxiliary files

You can put auxiliary files in a directory aux (or NGINX_AUX_DIR) to copy
them to the resulting image, e.g. htpasswd files.

These will be copied to /opt/app-root/etc/aux.

Environment variables

Runtime behavior

Environment variables in files in conf.d ending with .tmpl are substituted via envsubst.

Build behavior

There are some environment variables you can set to influence build behavior.

NGINX_STATIC_DIR sets the repo subdir to use for static files, default
html.

Either NGINX_CONF_FILE sets a config snippet to use or NGINX_CONF_DIR
will copy config from this dir (defaults to conf.d).

NGINX_AUX_DIR sets the aux directory for auxiliary files.

Docker Pull Command
Owner
ibotty
Source Repository

Comments (0)