NGINX container custom images

Custom nginx images for development and production

Exploring docker by creating custom nginx images for development and production, seprately as well as usinga multi-stage build. And mapping the container user UID with the host UID to make shared files (via volumes) accessibles. The nginx service is running as a non-root (www-data user).

NGINX Configurations ⚙️

The Nginx images under this repository are all using default configurations. Nginx is running under www-data user with UID mapped to the host local user's UID

Docker 🛠️

By default, the Docker will expose ports 80/tcp and 443/tcp, so change this within the Dockerfile if necessary. When ready, simply use the Dockerfile to build the image.

Installation 🔌

Clone this repository and follow the simple steps:

# clone
$ git clone git@github.com:khalid-el-masnaoui/docker-nginx-exploring.git

#cd into the working diretcory
$ cd docker-nginx-exploring

#developement image build
$ docker build . -t cs-nginx-dev -f Dockerfile.dev --build-arg="UID=$(id -u)" --build-arg="GID=$(id -g)"

#developement image build multi-stage
$ docker build . -t cs-nginx-dev-multistage -f Dockerfile --target dev --build-arg="UID=$(id -u)" --build-arg="GID=$(id -g)"

#production image build
$ docker build . -t cs-nginx-prod -f Dockerfile.prod  --build-arg="UID=$(id -u)" --build-arg="GID=$(id -g)"

#production image build multi-stage
$ docker build . -t cs-nginx-prod-multistage -f Dockerfile --target prod  --build-arg="UID=$(id -u)" --build-arg="GID=$(id -g)"

This will create the custom nginx image and pull-in/install the necessary dependencies.

Once done, run the Docker image and map the port to whatever you wish on your host. In this example, we simply map port 8080 of the host to port 80 of the Docker (or whatever port was exposed in the Dockerfile):

#developement container
$ docker run -p 8080:80 --restart=always -itd  --name nginx-dev --mount type=bind,source=./logs/,destination=/var/log/nginx/ --mount type=bind,source=./src/,destination=/var/www/html --mount type=bind,source=./configurations/sites-available/,destination=/etc/nginx/sites-available cs-nginx-dev

#developement container multi-stage
$ docker run -p 8080:80 --restart=always -itd  --name nginx-dev-multistage --mount type=bind,source=./logs/,destination=/var/log/nginx/ --mount type=bind,source=./src/,destination=/var/www/html --mount type=bind,source=./configurations/sites-available/,destination=/etc/nginx/sites-available cs-nginx-dev-multistage

#production container
$ docker run -p 8080:80 --restart=always -itd  --name nginx-prod --mount type=bind,source=./logs/,destination=/var/log/nginx/ cs-nginx-prod

#production container multi-stage
$ docker run -p 8080:80 --restart=always -itd  --name nginx-prod-multistage --mount type=bind,source=./logs/,destination=/var/log/nginx/ cs-nginx-prod-multistage

Verify the deployment by navigating to your server address in your preferred browser.

127.0.0.1:8080