Docker lab

Introducción

Este proyecto proporciona un Dockerfile y scripts para construir y ejecutar una imagen de Docker que ofrece un terminal basado en la web. El terminal web permite a los estudiantes interactuar con un entorno de línea de comandos en un contenedor Docker. Este README explicará el contenido del Dockerfile, el archivo Aptfile y cómo usar la imagen de Docker, ya sea a través de comandos de construcción y ejecución o mediante Docker Desktop.

Contenidos

Dockerfile

El archivo Dockerfile define los pasos necesarios para construir la imagen de Docker. Aquí está el desglose de lo que hace cada parte:

FROM ubuntu:22.04: Este comando especifica que nuestra imagen se basará en Ubuntu 22.04.
EXPOSE 8080: Exponemos el puerto 8080, que se utilizará para acceder al terminal basado en la web.
COPY Aptfile /tmp/Aptfile: Copiamos el archivo Aptfile desde el directorio de construcción local al directorio /tmp en la imagen de Docker.
RUN apt-get update -qq && ...: En este bloque, se actualiza la lista de paquetes y se instalan las dependencias especificadas en el archivo Aptfile. Esto se hace en una sola línea para minimizar las capas de la imagen.
RUN curl -k "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" && ...: Instalamos la AWS Command Line Interface (CLI) descargando el archivo zip y ejecutando su instalador.
RUN wget --no-check-certificate -qO - ...: Configuramos el repositorio de HashiCorp y luego instalamos Terraform.
ENTRYPOINT ["/usr/bin/ttyd", "-p", "8080", "-W", "bash"]: Establecemos el punto de entrada para la imagen, que inicia ttyd (un emulador de terminal) en el puerto 8080 y ejecuta el shell Bash dentro del contenedor cuando se inicia.

Aptfile

El archivo Aptfile contiene la lista de paquetes de Ubuntu que se instalarán en la imagen de Docker. Estos paquetes pueden modificarse según las necesidades del proyecto.

Scripts de Construcción y Ejecución

build.sh: Este script facilita la construcción de la imagen de Docker. Ejecute ./build.sh para crear la imagen con la etiqueta cc/lab:latest.
run.sh: Utilice este script para ejecutar un contenedor basado en la imagen creada anteriormente. Ejecute ./run.sh para iniciar un contenedor llamado webterminal que escucha en el puerto 8080.

Cómo usar

Construir y ejecutar manualmente

Para construir la imagen de Docker, ejecute el comando siguiente desde el directorio donde se encuentra el archivo Dockerfile:
```
./build.sh
```
Una vez que la imagen se haya construido, puede ejecutar un contenedor con el siguiente comando:
```
./run.sh
```

En el caso de estar en Windows, los scripts de bash no se pueden ejecutar, entonces en su defecto, utilizaremos lo siguiente:

Para construir la imagen de Docker, desde el Terminal (Simbolo del sistema), y estando presente dentro de esta carpeta (para ello podemos ejecutar el comando dir y tendriamos que ver todos los ficheros de este repositorio, y en caso de que no, movernos a ese directorio usando cd), ejecutamos el siguiente comando:
```
docker build -t cc/lab:latest -f Dockerfile .
```
Una vez el proceso de build ha terminado, arrancamos el contenedor (sustituir MYUSER por tu nombre de usuario, y el path por la ruta hasta el directorio donde este esta carpeta):
```
docker run -it -p 8080:8080 -v /c/Users/MYUSER/path/:/workspace --name webterminal cc/lab:latest
```

Esto iniciará un contenedor con el terminal basado en la web. Luego, abra su navegador web y vaya a http://localhost:8080 para acceder al terminal basado en la web.

Usar Docker Desktop

Si está utilizando Docker Desktop en su sistema, siga estos pasos:

Construya la imagen como se indicó anteriormente usando ./build.sh.
Ejecute un contenedor desde Docker Desktop con la imagen cc/lab:latest publicando el puerto 8080.
Luego, abra su navegador web y vaya a http://localhost:8080 para acceder al terminal basado en la web.

Esta imagen de Docker proporciona un entorno interactivo en línea de comandos que puede ser útil para enseñar o aprender sobre herramientas de línea de comandos y tecnologías relacionadas.

albertoperdomo2/docker-lab