Ejemplo con Docker

Esta página explica una configuración mínima y práctica con Docker que:

1. Ejecuta un escenario .pmod dentro de un contenedor CPU

2. Escribe archivos de salida en una carpeta montada desde tu equipo (host)

Carpeta de ejemplo:

docker/augelab_docker_mount_example_cpu/

---

Qué obtienes

• Un Dockerfile funcional que ejecuta un script Python en modo headless

• Un docker-compose.yml que monta una carpeta del host dentro del contenedor en /app/app_output

• Un ejemplo listo para ejecutar .pmod (save_image_no_args.pmod)

---

Archivos en la carpeta de ejemplo

Dentro de docker/augelab_docker_mount_example_cpu/:

• docker-compose.yml — construye la imagen y monta una carpeta del host

• app/Dockerfile — usa una imagen base CPU de AugeLab Studio y ejecuta un script Python

• app/file_save.py — carga el .pmod y lo ejecuta

• app/save_image_no_args.pmod — un escenario de ejemplo

---

Paso a paso

1) Elige una carpeta de salida en tu host

Elige (o crea) una carpeta en tu máquina donde el contenedor tenga permiso para escribir archivos.

Ejemplos:

• Windows: C:/work/augelab_output

• Linux/macOS: /home/<usuario>/augelab_output

---

2) Actualiza el mapeo de volúmenes en docker-compose.yml

Abre docker/augelab_docker_mount_example_cpu/docker-compose.yml y cambia la línea de volúmenes:

volumes:
	# <local mounted folder>:<container mounted folder>
	- "C:/work/augelab_output:/app/app_output"

Alternativamente, puedes usar una carpeta relativa (recomendado para proyectos portables):

volumes:
	- "./output_on_host:/app/app_output"

En Windows, Docker espera rutas con barras hacia adelante como C:/.... Evita las barras invertidas.

---

3) Proporciona la licencia (verification code o archivo de licencia)

Tu script debe pasar un verification_code al crear StudioScenario.

Opciones recomendadas:

Opción A (recomendada): variable de entorno

Exporta una variable de entorno y recupérala en tu código Python.

Agregar a docker-compose.yml:

environment:
	- AUGELAB_VERIFICATION_CODE=YOUR_CODE_HERE

Luego en el script, usa:

import os
from studio import StudioScenario

scenario = StudioScenario(verification_code=os.environ["AUGELAB_VERIFICATION_CODE"])

Opción B: montar un archivo de licencia y pasar su ruta

Monta tu archivo de licencia en el contenedor y pasa la ruta dentro del contenedor como verification_code.

Ejemplo:

volumes:
	- "C:/path/to/license_file:/app/license_file:ro"
environment:
	- AUGELAB_VERIFICATION_CODE=/app/license_file

---

4) Construir y ejecutar

Desde la carpeta que contiene docker-compose.yml ejecuta:

cd docker/augelab_docker_mount_example_cpu
docker compose up --build

Verás los logs y el resultado de la ejecución del escenario en la salida del contenedor.

---

5) Verifica la carpeta de salida en el host

Revisa la carpeta del host que montaste en /app/app_output.

Si tu .pmod escribe archivos (imágenes, informes, etc.) en esa ruta de salida, deberías verlos aparecer en el host de forma inmediata.

Si no ves archivos en el host, verifica que tu .pmod esté configurado para escribir en /app/app_output (o ajusta el punto de montaje para que coincida con tu escenario).