País o región e idioma

    Elige tu país o región y tu idioma.

    Sugerido para ti

      Todos los países y regiones

        Elige tu personaje

        Aparece en la barra superior y en tu perfil. Puedes cambiarlo cuando quieras.

        Docker: tutorial en español paso a paso

        Tutorial de Docker en español: crea una página local y una imagen. Comprueba por qué reiniciar no aplica cambios y cuándo debes recrear el contenedor.

        Una persona practica con un equipo portátil en un espacio de trabajo tranquilo

        Docker permite ejecutar una aplicación con los archivos y las dependencias definidos en una imagen. En este tutorial de Docker en español construirás una imagen para una página ficticia, iniciarás un contenedor y abrirás la página en tu computadora. Después modificarás el archivo de la página para comprobar por qué reiniciar el contenedor no incorpora los cambios y cómo publicarlos mediante una nueva imagen.

        Una página local dentro de un contenedor

        La página de Tienda Aurora será el ejemplo para distinguir una imagen de un contenedor. Una imagen es una plantilla que reúne archivos y lo necesario para ejecutar una aplicación; un contenedor es una instancia creada a partir de esa imagen, que puedes iniciar, detener y eliminar.

        Tendrás tres elementos separados: el archivo que editas en tu computadora, la copia incluida en la imagen y el contenedor creado con esa imagen. El objetivo es ver primero «Tienda Aurora v1» y después «Tienda Aurora v2», identificando qué operación hace efectivo el cambio.

        El entorno de trabajo

        El ejemplo utiliza Docker Engine con contenedores Linux y una terminal Bash en Linux. Necesitas también curl, una herramienta de terminal que usaremos para consultar la respuesta HTTP: el contenido que devuelve el servidor web. Los comandos para crear archivos no están escritos para PowerShell.

        Si todavía no tienes Docker Engine, sigue las instrucciones oficiales de instalación correspondientes a tu distribución de Linux. Completa la instalación antes de continuar; no combines instrucciones de sistemas distintos.

        Comprueba que tu terminal puede comunicarse con Docker y que el motor trabaja con contenedores Linux:

        docker info --format '{{.OSType}}'

        Resultado esperado:

        linux

        Si aparece un error de conexión, revisa que el servicio de Docker esté iniciado. Si aparece un error de permisos, revisa la configuración de acceso indicada para tu instalación. No cambies los permisos del socket de Docker para permitir el acceso a cualquier usuario: ese acceso permite controlar el motor.

        Practica lo que enseña este artículo

        Los archivos y la primera imagen

        La primera imagen se construye a partir de una página y un Dockerfile, el archivo de instrucciones que Docker lee durante la construcción. Usaremos Nginx como servidor web, es decir, el programa que entrega la página cuando recibe una solicitud.

        Ejecuta el siguiente bloque en Bash. Crea una carpeta de trabajo, guarda la página y escribe el Dockerfile; después construye la imagen. La primera construcción necesita acceso a internet para descargar la imagen de partida si todavía no está disponible en tu computadora.

        mkdir -p docker-pagina
        cd docker-pagina
        printf '%s\n' '<h1>Tienda Aurora v1</h1>' > index.html
        cat > Dockerfile <<'EOF'
        FROM nginx:alpine
        COPY index.html /usr/share/nginx/html/index.html
        EOF
        docker build -t aurora-web:v1 .

        Las instrucciones y los argumentos cumplen funciones distintas:

        • FROM selecciona la imagen de partida. nginx:alpine identifica la variante de Nginx basada en Alpine Linux.
        • COPY copia el archivo local al directorio desde el que Nginx entrega la página.
        • La opción -t asigna el nombre aurora-web y la etiqueta v1 a la imagen. Una etiqueta es un nombre que permite referirse a una imagen; no impide que posteriormente se reasigne.
        • El punto final indica el contexto de construcción: la carpeta cuyos archivos están disponibles para construir la imagen. En este caso es la carpeta actual.

        El registro de construcción puede variar. Para verificar el resultado sin comparar todas sus líneas, consulta el nombre y la etiqueta creados:

        docker image ls aurora-web:v1 --format '{{.Repository}}:{{.Tag}}'

        Resultado esperado:

        aurora-web:v1

        El contenedor y la respuesta web

        El contenedor ejecutará Nginx a partir de la primera imagen y permitirá consultar la página desde tu computadora. Inícialo con este comando:

        docker run --detach --name aurora-web --publish 127.0.0.1:8080:80 aurora-web:v1

        El comando imprime un identificador largo cuyo valor cambia en cada ejecución. La opción --detach deja el contenedor en segundo plano y --name le asigna un nombre para los siguientes comandos.

        La publicación de puertos conecta el puerto 8080 de tu computadora con el puerto 80 del contenedor, donde escucha Nginx. La dirección 127.0.0.1 limita la publicación a la interfaz local, en lugar de solicitar que Docker escuche en todas las interfaces de red.

        Abre http://127.0.0.1:8080 en tu navegador. También puedes verificar el contenido directamente desde la terminal:

        curl --silent --show-error http://127.0.0.1:8080

        Resultado esperado:

        <h1>Tienda Aurora v1</h1>

        Si la conexión falla justo después de iniciar el contenedor, espera unos segundos y repite la consulta: Nginx puede seguir arrancando. curl permite comprobar el contenido sin depender de cómo lo presenta el navegador.

        Antes de pasar a la segunda versión, intenta explicar y repetir la construcción y la consulta sin copiar todos los comandos. Puedes continuar practicando en el curso de Docker y Kubernetes de The Work Gym.

        Una nueva imagen para el archivo editado

        Cambiar el archivo local exige construir otra imagen porque COPY solo incorporó el contenido durante la construcción anterior. Vamos a comprobar primero qué ocurre si editas la página y únicamente reinicias el contenedor.

        Desde la misma carpeta de trabajo, escribe la segunda versión y reinicia:

        printf '%s\n' '<h1>Tienda Aurora v2</h1>' > index.html
        docker restart aurora-web

        Resultado del reinicio:

        aurora-web

        Cuando Nginx esté disponible de nuevo, consulta la página:

        curl --silent --show-error http://127.0.0.1:8080

        El contenido sigue siendo:

        <h1>Tienda Aurora v1</h1>

        Construye ahora la segunda imagen. Después elimina el contenedor anterior y crea otro con la etiqueta v2. La eliminación forzada es adecuada para este contenedor desechable, pero interrumpe el servicio; no es un procedimiento de actualización sin interrupciones.

        docker build -t aurora-web:v2 .
        docker rm -f aurora-web
        docker run --detach --name aurora-web --publish 127.0.0.1:8080:80 aurora-web:v2

        La construcción muestra su registro, la eliminación imprime el nombre del contenedor y el último comando devuelve un identificador nuevo.

        Una vez iniciado el servidor, repite la comprobación:

        curl --silent --show-error http://127.0.0.1:8080

        Resultado esperado:

        <h1>Tienda Aurora v2</h1>
        El efecto de cada operación
        AcciónImagen del contenedor en ejecuciónContenido devuelto
        Ejecutar la primera versiónLa identificada como aurora-web:v1Tienda Aurora v1
        Editar el archivo local y reiniciarLa misma imagen inicialTienda Aurora v1
        Construir v2 sin recrear el contenedorLa misma imagen inicialTienda Aurora v1
        Recrear el contenedor con v2La identificada como aurora-web:v2Tienda Aurora v2

        La regla práctica es separar las operaciones: construir produce una imagen; crear un contenedor selecciona la imagen que utilizará. Reconstruir en cada edición puede resultar lento durante el desarrollo. Los montajes de archivos, que permiten trabajar con archivos externos al contenedor, quedan fuera de este ejercicio.

        Los errores y la limpieza

        Los errores más frecuentes se distinguen por el recurso que Docker no puede utilizar: el nombre del contenedor, el puerto o el archivo de construcción. Antes de cambiar comandos al azar, identifica cuál aparece en el mensaje.

        Revisa cada síntoma por separado:

        • Nombre ya utilizado: el contenedor anterior todavía existe. Elimínalo solo si pertenece a este ejercicio o elige otro nombre.
        • Puerto ocupado: otro proceso o contenedor utiliza el puerto 8080. Libera ese puerto o elige otro puerto local y cambia también la dirección de la consulta.
        • Error al copiar index.html: comprueba que el archivo esté en la carpeta enviada como contexto de construcción y que su nombre coincida con el Dockerfile.
        • Página antigua: consulta primero con curl. Si curl devuelve v1, revisa la imagen elegida al crear el contenedor; si devuelve v2 pero el navegador muestra v1, revisa la dirección abierta y la caché del navegador.

        Al terminar, elimina únicamente el contenedor y las dos etiquetas del ejercicio. Estos comandos suponen que completaste ambas versiones:

        docker rm -f aurora-web
        docker image rm aurora-web:v1 aurora-web:v2

        El primer comando imprime aurora-web. El segundo informa de las etiquetas retiradas y, cuando corresponde, de las capas eliminadas.

        La carpeta local y la imagen base de Nginx permanecen. Para comprobar que ya no existe el contenedor ni quedan las etiquetas del ejercicio, ejecuta:

        docker ps -a --filter name=^/aurora-web$ --format '{{.Names}}'
        docker image ls aurora-web --format '{{.Repository}}:{{.Tag}}'

        Resultado esperado: ninguno de los dos comandos imprime líneas.

        Preguntas frecuentes

        ¿Qué diferencia hay entre una imagen y un contenedor? Una imagen reúne los archivos y la configuración necesarios para ejecutar una aplicación. Un contenedor es una instancia creada con esa imagen; puedes eliminar el contenedor sin eliminar la imagen.

        ¿Por qué no aparecen mis cambios después de reiniciar el contenedor? En este ejemplo, COPY incorporó el archivo durante la construcción de la imagen, no durante cada inicio del contenedor. Editar el archivo local y reiniciar no modifica esa copia: debes reconstruir la imagen y recrear el contenedor.

        ¿Construir una imagen nueva actualiza el contenedor existente? No, construir otra imagen no cambia la imagen utilizada por un contenedor existente. Debes crear un contenedor con la nueva imagen, aunque hayas reutilizado el mismo nombre de etiqueta durante la construcción.

        ¿Qué significa publicar el puerto 8080 hacia el puerto 80? Significa dirigir las conexiones recibidas en el puerto 8080 de tu computadora al puerto 80 del contenedor. En el ejemplo, la publicación usa la dirección local 127.0.0.1 y Nginx escucha dentro del contenedor en el puerto 80.

        ¿Cómo elimino los recursos del tutorial sin borrar otros proyectos? Elimina por nombre el contenedor aurora-web y después las etiquetas aurora-web:v1 y aurora-web:v2, como muestra la sección de limpieza. No necesitas una limpieza global; la carpeta local y la imagen base permanecen.

        Practica lo que enseña este artículo

        Your Work Gym account

        Save your progress and pick up on another device. Your browser's progress comes with you.

        or

        You can keep practicing without an account.

        Ayuda y comentarios

        Haz una pregunta, cuéntanos qué no funciona o comparte una idea. Te respondemos por correo electrónico.

        ¿De qué se trata?

        Solo lo usamos para responderte.