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:
# 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¿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.