Tema 7 · Dockerfile

7. Anatomía de un Dockerfile: FROM, RUN, COPY, WORKDIR, CMD y ENTRYPOINT

Empaqueta aplicaciones personalizadas en imágenes reproducibles conociendo la función exacta de cada instrucción clave de construcción.

¿Qué es un Dockerfile?

Un Dockerfile es un archivo de texto plano (sin extensión) que contiene la receta o conjunto de instrucciones que Docker ejecuta en orden secuencial para construir una imagen personalizada mediante el comando docker build.

Instrucciones Fundamentales de un Dockerfile

Instrucción Descripción y Uso Ejemplo
FROM Define la imagen base sobre la cual se construirán las siguientes capas. Todo Dockerfile debe iniciar con esta instrucción. FROM php:8.3-fpm-alpine
WORKDIR Establece el directorio de trabajo activo dentro del contenedor para las instrucciones posteriores (crea la carpeta si no existe). WORKDIR /var/www/html
COPY Copia archivos o carpetas desde tu máquina local (host) al sistema de archivos de la imagen. COPY . .
RUN Ejecuta comandos durante el tiempo de construcción (build time) para instalar paquetes o compilar dependencias. Cada RUN genera una nueva capa inmutable. RUN apk add --no-cache curl git
EXPOSE Documenta qué puerto escucha la aplicación (meramente informativo para los desarrolladores). EXPOSE 9000
CMD Define el comando predeterminado que se ejecutará en tiempo de arranque (runtime) cuando el contenedor inicie. Puede ser sobrescrito fácilmente. CMD ["php-fpm"]
ENTRYPOINT Configura el ejecutable fijo del contenedor; los argumentos pasados en docker run se añadirán al final de este ejecutable. ENTRYPOINT ["docker-entrypoint.sh"]

Construcción de la Imagen con docker build -t

Para transformar el archivo Dockerfile en una imagen utilizable se ejecuta:

# Sintaxis: docker build -t <nombre-imagen>:<etiqueta> <contexto-de-construcción>
docker build -t mi-api-backend:1.0 .

El punto (.) al final indica que el contexto de construcción es el directorio actual en el que te encuentras.

⚡ Dockerfile Completo para una Aplicación PHP 8.3 Moderna

Ejemplo de Dockerfile estructurado con buenas prácticas para backend PHP con soporte para base de datos PDO MySQL:

Dockerfile
Solo lectura
# 1. Imagen base oficial ligera basada en Alpine Linux
FROM php:8.3-fpm-alpine

# 2. Instalar dependencias del sistema y extensiones de PHP necesarias
RUN apk update && apk add --no-cache \
    curl \
    libpng-dev \
    libzip-dev \
    zip \
    unzip \
    && docker-php-ext-install pdo pdo_mysql bcmath

# 3. Copiar Composer oficial desde la imagen de Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 4. Establecer el directorio de trabajo donde residirá el código
WORKDIR /var/www/html

# 5. Copiar los archivos del proyecto al contenedor
COPY . /var/www/html

# 6. Informar el puerto donde escucha FastCGI
EXPOSE 9000

# 7. Comando predeterminado al arrancar el contenedor
CMD ["php-fpm"]
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es la diferencia fundamental entre la instrucción RUN y la instrucción CMD en un Dockerfile?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Docker & Contenedores: De Cero a Producción y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.