Skip to content

Docker

Build, run, inspect, and manage Docker containers.

6 modules

ModuleDescription
Construir imagen de DockerConstruir una imagen de Docker desde un Dockerfile
Inspeccionar contenedor de DockerObtener información detallada sobre un contenedor de Docker
Obtener registros del contenedorObtener registros de un contenedor Docker
Listar contenedores DockerListar contenedores Docker
Ejecutar contenedor de DockerEjecutar un contenedor de Docker desde una imagen
Detener contenedor de DockerDetener un contenedor de Docker en ejecución

Modules

Construir imagen de Docker

docker.build

Construir una imagen de Docker desde un Dockerfile

Parameters:

NameTypeRequiredDefaultDescription
pathstringYes-Ruta al directorio del contexto de construcción
tagstringYes-Nombrar y opcionalmente etiquetar la imagen (ej. miapp:última)
dockerfilestringNo-Ruta al Dockerfile (relativa al contexto de construcción)
build_argsobjectNo-Variables de tiempo de construcción (ej. {"NODE_ENV": "producción"})
no_cachebooleanNoFalseNo usar caché al construir la imagen

Output:

FieldTypeDescription
image_idstringID de la imagen construida
tagstringEtiqueta aplicada a la imagen
sizestringTamaño de la imagen construida

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

Inspeccionar contenedor de Docker

docker.inspect_container

Obtener información detallada sobre un contenedor de Docker

Parameters:

NameTypeRequiredDefaultDescription
containerstringYes-ID o nombre del contenedor a inspeccionar

Output:

FieldTypeDescription
idstringID corto del contenedor
namestringNombre del contenedor
stateobjectEstado del contenedor (estatus, ejecutando, pid, código de salida, etc.)
imagestringImagen utilizada por el contenedor
network_settingsobjectConfiguración de red (IP, puertos, redes)
mountsarrayMontajes de volúmenes y enlaces
configobjectConfiguración del contenedor (env, cmd, etiquetas, etc.)

Example: Inspect a container by name

yaml
container: my-nginx

Example: Inspect a container by ID

yaml
container: a1b2c3d4e5f6

Obtener registros del contenedor

docker.logs

Obtener registros de un contenedor Docker

Parameters:

NameTypeRequiredDefaultDescription
containerstringYes-ID o nombre del contenedor
tailnumberNo100Número de líneas a mostrar desde el final de los registros
followbooleanNoFalseSeguir la salida de los registros (fluye hasta el tiempo de espera)
timestampsbooleanNoFalseMostrar timestamps en la salida de registros

Output:

FieldTypeDescription
logsstringSalida de registros del contenedor
linesnumberNúmero de líneas de registro devueltas

Example: Get last 50 lines

yaml
container: my-nginx
tail: 50

Example: Get logs with timestamps

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

Listar contenedores Docker

docker.ps

Listar contenedores Docker

Parameters:

NameTypeRequiredDefaultDescription
allbooleanNoFalseMostrar todos los contenedores (por defecto solo muestra los que están ejecutando)
filtersobjectNo-Filtrar contenedores (ej. {"name": "my-app", "status": "running"})

Output:

FieldTypeDescription
containersarrayLista de contenedores con id, nombre, imagen, estado, puertos
countnumberNúmero de contenedores encontrados

Example: List running containers

yaml

Example: List all containers

yaml
all: true

Example: Filter by name

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

Ejecutar contenedor de Docker

docker.run

Ejecutar un contenedor de Docker desde una imagen

Parameters:

NameTypeRequiredDefaultDescription
imagestringYes-Imagen de Docker a ejecutar (ej. nginx:última)
commandstringNo-Comando a ejecutar dentro del contenedor
namestringNo-Asignar un nombre al contenedor
portsobjectNo-Mapeo de puertos como host:contenedor (ej. {"8080": "80"})
volumesobjectNo-Mapeo de volúmenes como ruta_host:ruta_contenedor
envobjectNo-Variables de entorno a establecer en el contenedor
detachbooleanNoTrueEjecutar el contenedor en segundo plano
removebooleanNoFalseEliminar automáticamente el contenedor cuando termine
networkstringNo-Conectar el contenedor a una red

Output:

FieldTypeDescription
container_idstringID del contenedor creado
statusstringEstado del contenedor después de ejecutar

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

Detener contenedor de Docker

docker.stop

Detener un contenedor de Docker en ejecución

Parameters:

NameTypeRequiredDefaultDescription
containerstringYes-ID o nombre del contenedor a detener
timeoutnumberNo10Segundos a esperar antes de matar el contenedor

Output:

FieldTypeDescription
container_idstringID o nombre del contenedor detenido
stoppedbooleanSi el contenedor se detuvo con éxito

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.