Skip to content

Docker

Build, run, inspect, and manage Docker containers.

6 modules

ModuleDescription
Docker-Image erstellenEin Docker-Image aus einer Dockerfile erstellen
Docker-Container inspizierenDetaillierte Informationen über einen Docker-Container erhalten
Container-Logs abrufenLogs von einem Docker-Container abrufen
Docker-Container auflistenDocker-Container auflisten
Docker-Container ausführenEinen Docker-Container aus einem Image ausführen
Docker-Container stoppenEinen laufenden Docker-Container stoppen

Modules

Docker-Image erstellen

docker.build

Ein Docker-Image aus einer Dockerfile erstellen

Parameters:

NameTypeRequiredDefaultDescription
pathstringYes-Pfad zum Build-Kontext-Verzeichnis
tagstringYes-Bild benennen und optional taggen (z.B. myapp:latest)
dockerfilestringNo-Pfad zur Dockerfile (relativ zum Build-Kontext)
build_argsobjectNo-Build-Zeit-Variablen (z.B. {"NODE_ENV": "production"})
no_cachebooleanNoFalseCache beim Erstellen des Images nicht verwenden

Output:

FieldTypeDescription
image_idstringID des erstellten Images
tagstringTag, das auf das Image angewendet wurde
sizestringGröße des erstellten Images

Example: Build from current directory

yaml
path: .
tag: myapp:latest

Example: Build with custom Dockerfile and args

yaml
path: ./backend
tag: myapi:v1.0
dockerfile: Dockerfile.prod
build_args: {"NODE_ENV": "production"}
no_cache: true

Docker-Container inspizieren

docker.inspect_container

Detaillierte Informationen über einen Docker-Container erhalten

Parameters:

NameTypeRequiredDefaultDescription
containerstringYes-Container-ID oder -Name zum Inspizieren

Output:

FieldTypeDescription
idstringKurze Container-ID
namestringContainer-Name
stateobjectContainer-Status (Status, läuft, PID, Exit-Code, etc.)
imagestringVom Container verwendetes Image
network_settingsobjectNetzwerkkonfiguration (IP, Ports, Netzwerke)
mountsarrayVolume- und Bind-Mounts
configobjectContainer-Konfiguration (Env, Cmd, Labels, etc.)

Example: Inspect a container by name

yaml
container: my-nginx

Example: Inspect a container by ID

yaml
container: a1b2c3d4e5f6

Container-Logs abrufen

docker.logs

Logs von einem Docker-Container abrufen

Parameters:

NameTypeRequiredDefaultDescription
containerstringYes-Container-ID oder Name
tailnumberNo100Anzahl der Zeilen, die vom Ende der Logs angezeigt werden
followbooleanNoFalseLog-Ausgabe folgen (streamt bis zum Timeout)
timestampsbooleanNoFalseZeitstempel in der Log-Ausgabe anzeigen

Output:

FieldTypeDescription
logsstringContainer-Log-Ausgabe
linesnumberAnzahl der zurückgegebenen Log-Zeilen

Example: Get last 50 lines

yaml
container: my-nginx
tail: 50

Example: Get logs with timestamps

yaml
container: my-app
tail: 100
timestamps: true

Docker-Container auflisten

docker.ps

Docker-Container auflisten

Parameters:

NameTypeRequiredDefaultDescription
allbooleanNoFalseAlle Container anzeigen (standardmäßig nur laufende)
filtersobjectNo-Container filtern (z.B. {"name": "my-app", "status": "running"})

Output:

FieldTypeDescription
containersarrayListe der Container mit ID, Name, Image, Status, Ports
countnumberAnzahl der gefundenen Container

Example: List running containers

yaml

Example: List all containers

yaml
all: true

Example: Filter by name

yaml
filters: {"name": "nginx"}

Docker-Container ausführen

docker.run

Einen Docker-Container aus einem Image ausführen

Parameters:

NameTypeRequiredDefaultDescription
imagestringYes-Docker-Image zum Ausführen (z.B. nginx:latest)
commandstringNo-Befehl, der im Container ausgeführt wird
namestringNo-Dem Container einen Namen zuweisen
portsobjectNo-Port-Zuordnungen als Host:Container (z.B. {"8080": "80"})
volumesobjectNo-Volume-Zuordnungen als Host_Pfad:Container_Pfad
envobjectNo-Umgebungsvariablen, die im Container gesetzt werden
detachbooleanNoTrueContainer im Hintergrund ausführen
removebooleanNoFalseContainer automatisch entfernen, wenn er beendet wird
networkstringNo-Den Container mit einem Netzwerk verbinden

Output:

FieldTypeDescription
container_idstringID des erstellten Containers
statusstringContainer-Status nach dem Ausführen

Example: Run Nginx web server

yaml
image: nginx:latest
name: my-nginx
ports: {"8080": "80"}
detach: true

Example: Run a one-off command

yaml
image: alpine:latest
command: echo hello world
remove: true
detach: false

Docker-Container stoppen

docker.stop

Einen laufenden Docker-Container stoppen

Parameters:

NameTypeRequiredDefaultDescription
containerstringYes-Container-ID oder -Name zum Stoppen
timeoutnumberNo10Sekunden, die gewartet werden, bevor der Container beendet wird

Output:

FieldTypeDescription
container_idstringID oder Name des gestoppten Containers
stoppedbooleanOb der Container erfolgreich gestoppt wurde

Example: Stop a container by name

yaml
container: my-nginx

Example: Stop with custom timeout

yaml
container: my-app
timeout: 30

Released under the Apache 2.0 License.