👤 Módulo: users

🇪🇸 Descripción

El módulo users permite gestionar usuarios locales del sistema: crear, modificar o eliminar cuentas de forma declarativa y reproducible.

Es útil para preparar entornos de servicio, configurar accesos, o mantener consistencia en despliegues multiusuario. Puede ejecutarse con privilegios (sudo) si se requiere.

🧩 Argumentos disponibles

Clave	Descripción
`username`	Nombre del usuario a gestionar (obligatorio)
`state`	Acción deseada: `create`, `modify`, `absent` (por defecto: `create`)
`shell`	Intérprete de comandos (por defecto: `/bin/bash`)
`home`	Directorio personal (por defecto: `/home/<username>`)
`groups`	Grupos adicionales (por defecto: ninguno)
`become`	Si se requiere `sudo`, usar `become=true`

▶️ Ejemplo de uso

tasks:
  - name: Crear usuario de servicio
    module: users
    args:
      username: servicio
      shell: /usr/sbin/nologin
      home: /home/servicio
      groups: docker
      become: true

🧠 Trazas esperadas (`--debug`)

👤 [users] Entrando en create
    ✅ [users] Usuario 'servicio' ya existe
    🔧 [users] Creando grupo 'docker'
    ✅ [users] Usuario 'servicio' creado

👤 [users] Entrando en modify
    ⚠️ [users] Usuario 'servicio' no existe

👤 [users] Entrando en absent
    ✅ [users] Usuario 'servicio' ya eliminado

📜 Changelog

Consulta el historial de cambios en changelog/users.md