🐳 Módulo: docker

🇪🇸 Descripción

El módulo docker permite gestionar contenedores Docker desde un host remoto vía SSH. Soporta acciones como lanzar, detener, eliminar, construir imágenes y ejecutar comandos dentro de contenedores.

Es compatible con sudo mediante el argumento become, y permite pasar argumentos personalizados con run_args.

🧩 Argumentos disponibles

Clave	Descripción
`action`	Acción a realizar (`present`, `stopped`, `absent`, `build`, `exec`)
`name`	Nombre del contenedor
`image`	Imagen a usar (solo para `present` y `build`)
`path`	Ruta del directorio para construir imagen (solo para `build`)
`command`	Comando a ejecutar dentro del contenedor (solo para `exec`)
`run_args`	Argumentos adicionales para `docker run` (puertos, variables, etc.)
`detach`	Si se desea modo en segundo plano (`true` por defecto)
`become`	Si se requiere `sudo`, usar `become=true`

▶️ Ejemplo de uso

tasks:
  - name: Lanzar contenedor LDAP
    module: docker
    args:
      action: present
      name: test-ldap
      image: osixia/openldap:latest
      run_args: "-p 389:389 -p 636:636 -e LDAP_ORGANISATION='Test Org' -e LDAP_DOMAIN='test.local' -e LDAP_ADMIN_PASSWORD='secreta'"

🧠 Trazas esperadas (`--debug`)

🧪 [docker] Comando: docker run -d --name 'test-ldap' -p 389:389 -p 636:636 -e LDAP_ORGANISATION='Test Org' ...
test-ldap

📜 Changelog

Consulta el historial de cambios en changelog/docker.md