Anatomía del directorio de un role

Un role no es más que un directorio con un conjunto fijo de subdirectorios. Ansible conoce cada directorio por su nombre y carga automáticamente su contenido.

El archivo tasks/main.yml contiene la lista principal de tareas del role. Es lo primero que ejecuta Ansible cuando se aplica el role.

El directorio handlers define acciones como reiniciar un servicio. Las tareas notifican a estos handlers para que los reinicios solo se produzcan cuando hay cambios.

Coloque sus archivos de plantilla .j2 en templates/. El módulo template los encuentra allí por su nombre, sin necesidad de especificar la ruta completa.

El directorio files almacena archivos normales que se copian tal cual. El módulo copy los localiza automáticamente, igual que las plantillas.

El archivo defaults/main.yml contiene variables con la precedencia más baja, por lo que los usuarios pueden sobrescribirlas fácilmente desde fuera del role.

El archivo vars/main.yml contiene variables con una precedencia más alta. Úselo para valores de los que depende el role y que rara vez deberían cambiar.

El archivo meta/main.yml enumera el autor del role, la licencia, las plataformas compatibles y las dependencias de otros roles.

Dentro de tasks, handlers, vars y defaults, Ansible carga automáticamente el archivo llamado main.yml. Esa convención de nombres es lo que mantiene todo conectado.

Un role no necesita todos los directorios. Si no tiene plantillas, simplemente omita el directorio templates. Ansible ignora los directorios opcionales que faltan.

Los roles maduros incluyen un README y un directorio tests para que otras personas entiendan y verifiquen su automatización antes de usarla.

Recuerde dónde se encuentra la lista principal de tareas de un role.

Un role es un árbol de directorios en el que tasks, handlers, plantillas, archivos, defaults, vars y meta tienen cada uno un lugar fijo, todo organizado en torno a main.yml. 📁