🐳 Fast Track Docker

Este tutorial está pensado para escritores, cultores y creadores que desean usar PreTeXt para transformar manuscritos en libros electrónicos e impresos, sin complicaciones técnicas.

Antes de llegar a PreTeXt, aprenderemos a usar Docker de forma rápida y sencilla.

🚀 1. ¿Qué es Docker?

Docker es un contenedor, como una caja mágica, donde metes todo lo que necesita un programa para funcionar (sistema operativo, librerías y configuraciones).

Así, puedes ejecutarlo en cualquier computadora (Windows, Linux o Mac), esa “caja” funciona igual.

👉 Nosotros lo usaremos para encapsular PreTeXt en un contenedor y no preocuparnos por instalaciones complejas.

💻 2. Instalación en Windows 10/11

1. Descargar Docker Desktop
   👉 https://www.docker.com/products/docker-desktop/

2. Requisitos previos

   • Windows 10 Pro/Enterprise o Windows 11.
   • Virtualización activada en BIOS.
   • WSL2 (Subsistema de Linux para Windows) instalado y actualizado.

   ⚠️ Durante la instalación marca la casilla:
   “Use WSL2 instead of Hyper-V”.
   Si un estudiante no tiene WSL2, Docker puede usar Hyper-V, pero es menos eficiente.

3. Verificar instalación
   Abrir PowerShell y correr:

   docker --version
   

👉 Salida esperada:

Docker version 28.4.0, build d8eb465

🐣 3. Primera verificación: “Hello World”

Ejecuta en PowerShell:

docker run hello-world

👉 Docker descargará una imagen mínima y mostrará en pantalla:

Hello from Docker!
This message shows that your installation appears to be working correctly.

✅ Si ves ese mensaje, tu instalación funciona correctamente.

🐧 4. Probar un contenedor Ubuntu

Ejecuta en PowerShell:

docker run -it ubuntu bash

Explicación:

• -it → modo interactivo.
• ubuntu → imagen a usar.
• bash → abrirá una consola Linux dentro del contenedor.

Ahora prueba comandos dentro del contenedor:

ls
pwd

👉 ls lista archivos, pwd muestra tu ubicación actual.

Para salir del contenedor:

exit

🛠️ 5. Verificar imágenes y contenedores

Docker guarda lo que usas. Revisa:

• Ver contenedores activos:

  docker ps
  

• Ver todos los contenedores (incluidos los detenidos):

  docker ps -a
  

• Ver imágenes descargadas:

  docker images
  

👉 Deberías ver al menos hello-world y ubuntu.

🧹 6. Limpiar (opcional)

Si quieres borrar un contenedor detenido:

docker rm <ID o nombre>

Si quieres borrar una imagen:

docker rmi <ID o nombre>

📖 7. Glosario rápido

• Imagen → la receta o molde (ejemplo: Ubuntu, PreTeXt).
• Contenedor → la “comida servida” a partir de la receta, ya en ejecución.
• Pull → descargar una imagen desde Docker Hub.
• Run → crear y ejecutar un contenedor.
• Exit → salir de un contenedor.
• WSL2 → subsistema de Linux para Windows (recomendado en Windows 10/11).

🎯 8. Objetivo inmediato

Con estos pasos ya sabes:
✅ Cómo instalar Docker en Windows.
✅ Cómo verificar tu instalación con docker --version.
✅ Cómo correr docker run hello-world.
✅ Cómo usar un contenedor Ubuntu con docker run -it ubuntu bash.
✅ Cómo listar imágenes y contenedores.
✅ Cómo limpiar contenedores e imágenes que no uses.

💡 Antes de usar el clip ▶️ o ejecutar cualquier comando de compilación, asegúrate de que Docker Desktop (Docker Engine) esté levantado y en ejecución. Sin el motor activo, los contenedores no podrán iniciarse y los procesos de construcción fallarán.

👉 ¡Ahora ya estás listo para la fase superior: encapsular PreTeXt en un contenedor Docker y transformar manuscritos en libros profesionales! 📚✨