UD00 · Taller 4 — Contenedor de prácticas de IA¶

Objetivo: levantar un entorno Jupyter reproducible con las bibliotecas del curso.

Fase 1 — Estructura de trabajo¶

1
2
3
4
5

practicas/
└── docker/
    ├── docker-compose.yml
    ├── requirements-ia.txt
    └── notebooks/          ← tus notebooks: créala tú antes de arrancar

Fase 2 — requirements-ia.txt¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# torch en su versión solo CPU: sin las librerías de CUDA, varios GB menos de descarga
--extra-index-url https://download.pytorch.org/whl/cpu
numpy
pandas
matplotlib
scikit-learn
scikit-fuzzy
nltk
spacy
torch

Fase 3 — docker-compose.yml¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

services:
  jupyter:
    image: quay.io/jupyter/scipy-notebook
    ports:
      - "8888:8888"
    volumes:
      - ./notebooks:/home/jovyan/work
      - ./requirements-ia.txt:/home/jovyan/requirements-ia.txt:ro
    environment:
      - JUPYTER_TOKEN=cursoia

Fase 4 — Verifica la configuración antes de arrancar¶

1

docker compose config

Comprueba que el puerto 8888:8888 y el token quedan resueltos correctamente.

Fase 5 — Arranca Jupyter¶

1
2

docker compose up -d
docker compose ps

Abre en el navegador http://localhost:8888 y usa el token cursoia.

1
2
3
4

docker compose down
docker image rm quay.io/jupyter/scipy-notebook
docker compose pull
docker compose up -d

Para comprobar el entorno usa el notebook N01 · Bienvenida al entorno Python para IA: descárgalo en tu carpeta notebooks/ y ábrelo desde la carpeta work de Jupyter. No se entrega, pero es el que demuestra que el entorno funciona.

La imagen ya trae numpy, pandas, matplotlib y scikit-learn; el resto de bibliotecas del curso las instala su primera celda de código, a partir del requirements-ia.txt que el compose monta en /home/jovyan (un nivel por encima de work):

1
2
3
4
5
6
7

import os

if os.path.exists("../requirements-ia.txt"):   # contenedor del taller 4
    %pip install -q -r ../requirements-ia.txt
else:                                          # Colab u otro entorno
    %pip install -q scikit-fuzzy nltk spacy torch
%pip install -q --no-deps experta schema frozendict

La primera vez tarda unos minutos (torch y spacy pesan); si ya están instaladas, pip lo comprueba en unos segundos. La última línea instala experta sin dejar que baje frozendict a la 1.2. El aviso «you may need to restart the kernel» solo importa si alguna biblioteca ya estaba importada antes de instalarla; en ese caso, Kernel → Restart Kernel y sigue.

La celda siguiente importa todas las bibliotecas y muestra sus versiones: si no da ningún error, el entorno está listo.

Fase 6 — Gestiona el servicio¶

1
2
3
4
5

docker compose logs -f jupyter     # sigue los logs (Ctrl+C para salir)
docker compose exec jupyter bash   # entra dentro del contenedor en marcha
docker compose stop                # lo detiene sin borrarlo (conserva lo instalado)
docker compose start               # lo vuelve a arrancar
docker compose down                # detiene y elimina (hay que reinstalar los paquetes)

Fase 7 — Persistencia (volúmenes nombrados)¶

Modifica el docker-compose.yml para que la carpeta de Jupyter use un volumen nombrado y comprueba que tus notebooks sobreviven a un down + up:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

services:
  jupyter:
    image: quay.io/jupyter/scipy-notebook
    ports:
      - "8888:8888"
    volumes:
      - jupyter-work:/home/jovyan/work
      - ./requirements-ia.txt:/home/jovyan/requirements-ia.txt:ro
    environment:
      - JUPYTER_TOKEN=cursoia

volumes:
  jupyter-work:

Entrega¶

Sube a la tarea T04 · Contenedor de prácticas de IA de Aules un único fichero PDF con:

• la memoria con las evidencias pedidas en el apartado «Entrega» (capturas de las fases 5 y 7, salida de docker compose ps y la respuesta razonada).

Aules solo acepta un PDF en esta tarea. El plazo acaba a las 23:59 del día que marca la tarea; después la tarea se cierra y ya no admite entregas.

Qué tiene que verse en la memoria

1. Captura de la fase 5 de este taller (Jupyter abierto con el import correcto).
2. Salida de docker compose ps mostrando el servicio activo.
3. Respuesta a: ¿por qué este entorno es reproducible en cualquier equipo?
4. Captura de la fase 7 mostrando que un notebook sobrevive a docker compose down.

Volver a la UD00 · Ejercicios · Taller 3