👥 Módulo: groups
🇪🇸 Descripción
El módulo groups permite gestionar grupos locales del sistema: crear, modificar o eliminar grupos de forma declarativa y reproducible.
Es útil para preparar entornos de servicio, asignar permisos compartidos o mantener consistencia en configuraciones multiusuario. Puede ejecutarse con privilegios (sudo) si se requiere.
🧩 Argumentos disponibles
| Clave | Descripción |
|---|---|
groupname |
Nombre del grupo a gestionar (obligatorio) |
gid |
Identificador numérico del grupo (opcional, solo en create o modify) |
state |
Acción deseada: create, modify, absent (por defecto: create) |
become |
Si se requiere sudo, usar become=true |
▶️ Ejemplo de uso
tasks:
- name: Crear grupo de servicio
module: groups
args:
groupname: servicio
become: true🧠 Trazas esperadas (--debug)
👥 [groups] Entrando en create
✅ [groups] Grupo 'servicio' ya existe
🔧 [groups] Creando grupo 'backend'
✅ [groups] Grupo 'backend' creado
⚠️ [groups] Nada que modificar: falta 'gid'
✅ [groups] Grupo 'legacy' ya eliminado📜 Changelog
Consulta el historial de cambios en changelog/groups.md