API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) · Lesson

Nginx in Containerized Environments

Deploy and manage Nginx effectively within Docker containers and Kubernetes clusters.

Nginx in Containerized Environments is a free API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Why Containerize Nginx?

Running Nginx in containers, like Docker, offers many benefits. It provides a consistent environment, making sure Nginx behaves the same way everywhere, from your laptop to production.

Key advantages include:

Portability: Move Nginx applications easily across different systems.
Isolation: Nginx runs in its own isolated environment, preventing conflicts.
Scalability: Quickly spin up new Nginx instances as traffic grows.
Resource Efficiency: Containers share the host OS kernel, using fewer resources than traditional VMs.

Your First Nginx Dockerfile

A Dockerfile is a script that contains instructions for building a Docker image. To containerize Nginx, we typically start with an official Nginx image and then add our custom configurations or static files.

Here's a basic Dockerfile to create an Nginx image:

FROM nginx:latest
COPY ./nginx.conf /etc/nginx/nginx.conf
COPY ./html /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Running Nginx in Docker

Once you have a Dockerfile (and optionally, your nginx.conf and html files), you can build an image and run it.

First, build the image (name it my-nginx):

docker build -t my-nginx .

Then, run a container from your image, mapping port 8080 on your host to port 80 in the container:

docker run -d -p 8080:80 --name my-nginx-container my-nginx

Custom Nginx Config in Docker

You often need to use a custom nginx.conf. Instead of baking it into the image with COPY (as in the Dockerfile example), you can mount it as a volume. This allows you to change the config without rebuilding the image.

Here's how to mount a local ./custom-nginx.conf file into the container:

docker run -d -p 8080:80 \
  --name my-nginx-custom \
  -v ./custom-nginx.conf:/etc/nginx/nginx.conf \
  nginx:latest

Nginx with Docker Compose

For applications with multiple services (e.g., Nginx as a reverse proxy for a backend API), Docker Compose is invaluable. It lets you define and run multi-container Docker applications with a single YAML file.

This example sets up Nginx to proxy requests to a simple web service:

version: '3.8'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
  app:
    image: httpd:alpine
    expose:
      - "8080"

Nginx and Kubernetes Basics

Kubernetes (K8s) is an open-source container orchestration platform. When deploying Nginx in a production environment, Kubernetes provides advanced features like:

Automated Deployment: Declarative configuration for desired state.
Scaling: Easily scale Nginx instances up or down.
Self-healing: Automatically restart or replace failed Nginx containers.
Load Balancing: Distribute traffic across multiple Nginx instances.

Key K8s concepts for Nginx include Pods, Deployments, and Services.

Deploying Nginx in Kubernetes

In Kubernetes, you define your applications using YAML files. A Deployment object manages a set of identical Pods, ensuring a specified number of Nginx instances are always running.

Here's a basic Kubernetes Deployment for Nginx:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:latest
        ports:
        - containerPort: 80

Exposing Nginx with K8s Services

A Kubernetes Service is an abstract way to expose an application running on a set of Pods. It provides a stable IP address and DNS name for your Nginx deployment, even if Pods are replaced.

Common Service types for Nginx include NodePort (exposes Nginx on a port across all cluster nodes) and LoadBalancer (integrates with cloud load balancers).

apiVersion: v1
kind: Service
metadata:
  name: nginx-service
spec:
  selector:
    app: nginx
  ports:
    - protocol: TCP
      port: 80
      targetPort: 80
  type: NodePort

Nginx Config with ConfigMaps

To manage Nginx configuration in Kubernetes, ConfigMaps are the preferred way. A ConfigMap stores non-confidential data in key-value pairs, which can then be mounted as files into your Nginx Pods.

This allows you to update Nginx configuration without rebuilding your Docker image or modifying the Deployment YAML directly.

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx-config
data:
  nginx.conf: |
    events { worker_connections 1024; }
    http {
      server {
        listen 80;
        location / {
          return 200 'Hello from Nginx in K8s!';
        }
      }
    }
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-configmap-deployment
spec:
  selector:
    matchLabels:
      app: nginx-configmap
  template:
    metadata:
      labels:
        app: nginx-configmap
    spec:
      containers:
      - name: nginx
        image: nginx:latest
        volumeMounts:
        - name: nginx-config-volume
          mountPath: /etc/nginx/nginx.conf
          subPath: nginx.conf
      volumes:
      - name: nginx-config-volume
        configMap:
          name: nginx-config

Check Your Container Knowledge

Which of the following are valid ways to manage custom Nginx configuration files when running Nginx in a Docker container or Kubernetes cluster?

Recap: Nginx in Containers

We've explored how to deploy and manage Nginx effectively within containerized environments, focusing on Docker and Kubernetes.

Docker: Provides isolation and portability, allowing Nginx to run consistently.
Dockerfile: Used to build custom Nginx images, including custom configurations.
Docker Compose: Orchestrates multi-container Nginx setups for development.
Kubernetes: Offers robust orchestration for production, with features like scaling and self-healing.
Deployments & Services: Core K8s objects to manage and expose Nginx Pods.
ConfigMaps: The standard K8s way to manage Nginx configuration dynamically.

Mastering these concepts is crucial for modern, scalable Nginx deployments!

Frequently asked questions

Is the “Nginx in Containerized Environments” lesson free?

Yes — the full text of “Nginx in Containerized Environments” is free to read here on the web, and the API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) course, upgrade to CoddyKit PRO.

What will I learn in “Nginx in Containerized Environments”?

Deploy and manage Nginx effectively within Docker containers and Kubernetes clusters. You practise API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

No prior experience is required. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Nginx in Containerized Environments” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) lesson?

Yes. Every API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)