Docker-Beispiel

Diese Seite führt durch eine minimal-praktische Docker-Konfiguration, die:

1. Ein .pmod-Szenario innerhalb eines CPU-Containers ausführt

2. Ausgabedateien in einen vom Host gemounteten Ordner schreibt

Beispielordner:

docker/augelab_docker_mount_example_cpu/

---

Was Sie erhalten

• Ein funktionierendes Dockerfile, das ein headless Python-Skript ausführt

• Ein docker-compose.yml, das einen Host-Ordner in den Container unter /app/app_output mountet

• Ein sofort einsatzbereites Beispiel-.pmod (save_image_no_args.pmod)

---

Dateien im Beispielordner

Innerhalb von docker/augelab_docker_mount_example_cpu/:

• docker-compose.yml — baut das Image und mountet einen Host-Ordner

• app/Dockerfile — verwendet ein AugeLab Studio CPU-Basisimage und führt ein Python-Skript aus

• app/file_save.py — lädt das .pmod und führt es aus

• app/save_image_no_args.pmod — ein Beispiel-Szenario

---

Schritt-für-Schritt

1) Wählen Sie einen Ausgabeordner auf Ihrem Host

Wählen (oder erstellen) Sie einen Ordner auf Ihrem Host-Rechner, in den der Container schreiben darf.

Beispiele:

• Windows: C:/work/augelab_output

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

---

2) Aktualisieren Sie das Volume-Mapping in docker-compose.yml

Öffnen Sie docker/augelab_docker_mount_example_cpu/docker-compose.yml und ändern Sie die Volume-Zeile:

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

Alternativ können Sie einen relativen Ordner verwenden (empfohlen für portable Projekte):

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

On Windows, Docker expects paths like C:/... (forward slashes). Avoid backslashes. { % endhint %}

---

3) Lizenzierung bereitstellen (Verification Code oder Lizenzdatei)

Ihr Skript muss beim Erstellen von StudioScenario einen verification_code übergeben.

Empfohlene Optionen:

Option A (empfohlen): Umgebungsvariable

Exportieren Sie eine Umgebungsvariable und lesen Sie diese im Python-Code.

Fügen Sie in docker-compose.yml hinzu:

environment:
	- AUGELAB_VERIFICATION_CODE=YOUR_CODE_HERE

Dann im Skript:

import os
from studio import StudioScenario

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

Option B: Lizenzdatei mounten und Pfad übergeben

Mounten Sie Ihre Lizenzdatei in den Container und übergeben Sie den Container-Pfad als verification_code.

Beispielausschnitt:

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

---

4) Build und Ausführung

Vom Ordner mit der docker-compose.yml aus:

cd docker/augelab_docker_mount_example_cpu
docker compose up --build

Sie sollten Logs und das Ergebnis der Szenarioausführung in der Container-Ausgabe sehen.

---

5) Überprüfen Sie den Ausgabeordner auf dem Host

Prüfen Sie Ihren Host-Ordner (denjenigen, den Sie nach /app/app_output gemountet haben).

Wenn Ihr .pmod Dateien (Bilder, Reports usw.) in diesen Ausgabepfad schreibt, sollten sie sofort auf dem Host erscheinen.

If you do not see files on the host, double-check that your `.pmod` is configured to write into `/app/app_output` (or adjust the mount point to match your scenario). { % endhint %}