La estructura de directorios recomendada
Dónde se encuentran los playbooks, el inventario y las vars.
La estructura de directorios recomendada es una lección gratuita de Ansible Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Ansible Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Ansible Academy incluye 4 lecciones en total.
Por qué importa la estructura
A medida que los proyectos crecen, los archivos dispersos se convierten rápidamente en un caos. Una estructura estándar de directorios indica a su equipo exactamente dónde está cada cosa. 📁
El punto de entrada site.yml
Por convención, site.yml es el playbook de nivel superior que conecta toda la infraestructura y contiene el resto.
# site.yml
- import_playbook: webservers.yml
- import_playbook: dbservers.ymlEl inventario en la raíz
El archivo (o directorio) de inventory se encuentra cerca de la raíz, de modo que los playbooks que están junto a él siempre saben qué hosts administran.
myproject/
inventory
site.ymlPlaybooks por función
Divida los plays grandes en archivos específicos como webservers.yml y dbservers.yml, y luego únalos desde site.yml.
El directorio group_vars
El directorio group_vars contiene variables que se aplican a grupos completos de hosts y que se cargan automáticamente según el nombre del grupo.
group_vars/
webservers.yml
dbservers.ymlEl directorio host_vars
El directorio host_vars hace lo mismo para máquinas individuales, con un archivo cuyo nombre corresponde a cada host.
host_vars/
web01.example.com.ymlEl directorio roles
La automatización reutilizable se encuentra en un directorio roles. Ansible busca primero aquí cuando un play hace referencia a un rol por su nombre.
roles/
common/
nginx/library y plugins personalizados
Una carpeta library contiene módulos personalizados, mientras que module_utils o filter_plugins contienen código auxiliar compartido que Ansible detecta automáticamente.
Mantenga ansible.cfg cerca
Coloque ansible.cfg en la raíz del proyecto. Ansible recoge la configuración del directorio actual, de modo que los ajustes se mantienen dentro del proyecto.
# ansible.cfg
[defaults]
inventory = ./inventory
roles_path = ./rolesUn repositorio, una visión completa
Con esta estructura, un solo git clone proporciona a un compañero los playbooks, el inventario, las variables y los roles con una estructura coherente. 🎯
La estructura completa
Esta es la estructura recomendada que sugieren los documentos oficiales. Memorice la forma, no cada archivo.
myproject/
ansible.cfg
inventory
site.yml
group_vars/
host_vars/
roles/Comprobación rápida
¿Qué archivo es el punto de entrada convencional de nivel superior para un proyecto completo?
Resumen
Ha aprendido la estructura estándar: site.yml, junto con inventory, group_vars, host_vars y roles en un mismo repositorio. Una estructura predecible crece con su equipo. ✅
Preguntas frecuentes
¿La lección «La estructura de directorios recomendada» es gratis?
Sí — el texto completo de «La estructura de directorios recomendada» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Ansible Academy, actualiza a CoddyKit PRO. El curso de Ansible Academy incluye 4 lecciones en total.
¿Qué aprenderé en «La estructura de directorios recomendada»?
Dónde se encuentran los playbooks, el inventario y las vars. Practicas Ansible Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Ansible Academy?
No se requiere experiencia previa. Ansible Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «La estructura de directorios recomendada»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Ansible Academy?
Sí. Cada lección de Ansible Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- La estructura de directorios recomendada
- Directorios group_vars y host_vars
- Dividir playbooks con import e include
- Nombres, comentarios y estilo que escalan