Erste Schritte

Starten eines Docker Containers

Das Docker Image kann per docker run (Docker-Referenz) gestartet werden:

docker run --name my_engine --publish 10560:80 5minds/engine

Nach erfolgreichem Start des Docker Containers wird folgende Ausgabe auf Ihrer Konsole angezeigt:

{"level":30,"time":"2021-11-05T08:15:12.378Z","levelName":"info","namespace":"engine","message":"Done."}

Unter http://localhost:10560/ ist die Engine-API nun verfügbar.

Stoppen des Docker Containers

Wurde das Docker Image wie oben beschrieben mit --name gestartet, so kann dieser Container-Name zum Stoppen des Containers verwendet werden:

docker stop my_engine

Wurde das Docker Image ohne Namen gestartet, so muss zunächst mit docker ps die ID des Containers ermittelt werden. Diese ID kann dann zum Stoppen genutzt werden wie ein Name:

docker stop 5a4146fc668c

Konfiguration der 5Minds Engine in Docker

Konfiguration per Umgebungsvariablen

Alle unter Konfiguration beschriebenen Umgebungsvariablen können per --env an den Container übergeben werden.

docker run --env application__name="Meine Engine" --publish 10560:80 5minds/engine

Konfiguration per JSON-Datei

Bei Verwendung einer JSON-Konfigurationsdatei muss der Ordner, in welchem die Datei liegt, per --volume in das Docker Image hinein gemountet werden. Anschließend muss die Umgebungsvariable CONFIG_PATH auf den Pfad gesetzt werden, an dem die Datei nun innerhalb des Containers liegt.

Im folgenden Beispiel liegt eine Datei config.json, welche als Konfigurationsdatei genutzt werden soll, im aktuellen Verzeichnis.

Linux-Beispiel:

docker run --name MyEngine --volume ${PWD}:/mnt/config --env CONFIG_PATH=/mnt/config/config.json --publish 10560:80 5minds/engine

Windows-Beispiel:

docker run --name MyEngine --volume %cd%:/mnt/config --env CONFIG_PATH=/mnt/config/config.json --publish 10560:80 5minds/engine

Zur Verwendung des --volume-Parameters: Docker-Referenz (run --volume)