NestJS Enterprise Backend APIs · Lección

Contenedorización y Kubernetes

Contenerice su aplicación de NestJS con Docker y aprenda estrategias básicas de despliegue mediante Kubernetes para un alojamiento escalable.

Lección 5 de 612 pasos

Contenedorización y Kubernetes es una lección gratuita de NestJS Enterprise Backend APIs en CoddyKit. Esta es la lección 5 de 6. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de NestJS Enterprise Backend APIs, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de NestJS Enterprise Backend APIs incluye 6 lecciones en total.

Partes de esta lección aún no han sido traducidas y se muestran en inglés.

Why Containerize Your App?

When building server applications like those with NestJS, consistency across environments is key. This is where containerization with Docker comes in.

Docker packages your application and all its dependencies into a single, isolated unit called a container. This ensures your app runs the same way everywhere.

  • Consistency: Works the same on dev, staging, prod.
  • Isolation: Prevents conflicts between apps.
  • Portability: Easily move apps between hosts.

Docker: Images & Containers

Let's understand the two core concepts in Docker:

  • A Docker Image is a lightweight, standalone, executable package of software that includes everything needed to run an application: code, runtime, system tools, system libraries, and settings. Think of it as a blueprint or a template.
  • A Docker Container is a runnable instance of an image. You can create, start, stop, move, or delete a container. Multiple containers can run from the same image.

Images are stored in registries like Docker Hub.

Crafting Your NestJS Dockerfile

A Dockerfile is a text file that contains all the commands a user could call on the command line to assemble an image. Here’s a basic one for a NestJS app:

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["node", "dist/main"]

  • FROM: Base image.
  • WORKDIR: Sets working directory.
  • COPY: Copies files.
  • RUN: Executes commands.
  • EXPOSE: Informs Docker that the container listens on the specified network ports at runtime.
  • CMD: Default command to execute.

Building Your Docker Image

Once you have your Dockerfile in your NestJS project's root, you can build an image from it. The docker build command processes the Dockerfile and creates a Docker image.

Open your terminal in the project root and run:

docker build -t my-nestjs-app .

  • -t my-nestjs-app: Tags the image with a name (my-nestjs-app).
  • .: Specifies the build context (current directory).

This command will execute each step in your Dockerfile, creating layers for your image.

Running Your NestJS Container

After building the image, you can run it as a container. The docker run command creates a new container and starts it.

Try running your NestJS app in a container:

docker run -p 3000:3000 my-nestjs-app

  • -p 3000:3000: Maps port 3000 on your host machine to port 3000 inside the container. This lets you access your app via http://localhost:3000.
  • my-nestjs-app: The name of the image you want to run.

Your NestJS application should now be running inside a Docker container!

Docker Compose for Local Dev

For applications with multiple services (like a NestJS backend and a PostgreSQL database), Docker Compose simplifies local development. It allows you to define and run multi-container Docker applications.

A docker-compose.yml file looks like this:

version: '3.8'
services:
api:
build: .
ports:
- '3000:3000'
depends_on:
- db
db:
image: postgres:13
environment:
POSTGRES_DB: nest
POSTGRES_USER: user
POSTGRES_PASSWORD: pass

Run with: docker-compose up

Kubernetes: Orchestrating Containers

While Docker is great for packaging and running individual containers, managing many containers across multiple servers (especially in production) becomes complex. This is where Kubernetes (K8s) comes in.

Kubernetes is an open-source system for automating deployment, scaling, and management of containerized applications.

  • Orchestration: Manages container lifecycle.
  • Scaling: Automatically adjusts resources.
  • Self-healing: Recovers from failures.

K8s Core: Pods

The smallest deployable unit in Kubernetes is a Pod. A Pod represents a single instance of a running process in your cluster. It can contain one or more containers (e.g., your NestJS app container and a sidecar logging container).

All containers in a Pod share the same network namespace, IP address, and storage volumes. This makes communication between them very efficient.

Example Pod definition:

apiVersion: v1
kind: Pod
metadata:
name: nestjs-pod
spec:
containers:
- name: nestjs-app
image: my-nestjs-app:latest
ports:
- containerPort: 3000

K8s Core: Deployments

A Deployment in Kubernetes provides declarative updates for Pods and ReplicaSets. You describe a desired state in a Deployment, and the Deployment Controller changes the actual state to the desired state.

Deployments are used to:

  • Create ReplicaSets to bring up Pods.
  • Roll out new versions of your application.
  • Roll back to an earlier Deployment revision.
  • Scale your application up or down.

Example Deployment:

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

K8s Core: Services

While Deployments manage Pods, Services in Kubernetes define a logical set of Pods and a policy by which to access them. Services enable network access to a set of Pods.

Pods are ephemeral (they can be created/destroyed), so their IP addresses change. A Service provides a stable IP address and DNS name, acting as a load balancer for the Pods it targets.

Example Service:

apiVersion: v1
kind: Service
metadata:
name: nestjs-service
spec:
selector:
app: nestjs-app
ports:
- protocol: TCP
port: 80
targetPort: 3000
type: LoadBalancer

This exposes your NestJS app externally.

Docker & K8s Knowledge Check

Which of the following is the correct command to build a Docker image from a Dockerfile located in the current directory, tagging it as my-app?

Recap: Dockerization & K8s

Great job! In this lesson, you've learned to containerize your NestJS application using Docker and explore basic deployment strategies with Kubernetes.

  • Docker helps package your app into consistent, isolated containers.
  • You learned to create Dockerfiles, build images, and run containers.
  • Docker Compose aids in local multi-service development.
  • Kubernetes orchestrates containers at scale, using Pods, Deployments, and Services.

These tools are fundamental for modern, scalable backend development!

Gratis para empezar

Aprende TypeScript con un tutor de IA — gratis

Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.

Cursos
20
Lecciones
76

Preguntas frecuentes

¿La lección «Contenedorización y Kubernetes» es gratis?

Sí — el texto completo de «Contenedorización y Kubernetes» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de NestJS Enterprise Backend APIs, actualiza a CoddyKit PRO. El curso de NestJS Enterprise Backend APIs incluye 6 lecciones en total.

¿Qué aprenderé en «Contenedorización y Kubernetes»?

Contenerice su aplicación de NestJS con Docker y aprenda estrategias básicas de despliegue mediante Kubernetes para un alojamiento escalable. Practicas NestJS Enterprise Backend APIs con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar NestJS Enterprise Backend APIs?

No se requiere experiencia previa. NestJS Enterprise Backend APIs en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 5 de 6.

¿Cuánto tiempo toma la lección «Contenedorización y Kubernetes»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de NestJS Enterprise Backend APIs?

Sí. Cada lección de NestJS Enterprise Backend APIs incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Pruebas unitarias y E2E
  2. Frameworks Hardhat y Truffle
  3. Pruebas de rendimiento de API
  4. Pruebas unitarias de contratos inteligentes
  5. Contenedorización y Kubernetes
  6. Despliegue en redes de prueba y Mainnet
← Volver a NestJS Enterprise Backend APIs