A organização de diretórios recomendada

À medida que os projetos crescem, arquivos espalhados se transformam rapidamente em caos. Uma estrutura de diretórios padrão informa à sua equipe exatamente onde cada coisa está. 📁

Por convenção, site.yml é o manual de execução de nível superior que reúne toda a sua infraestrutura e inclui o restante.

Seu arquivo de inventário (ou diretório) fica próximo ao nível superior, para que os manuais de execução ao lado dele sempre saibam quais máquinas gerenciam.

Divida execuções grandes em arquivos focados, como webservers.yml e dbservers.yml, e depois reúna-os a partir de site.yml.

Um diretório group_vars contém variáveis aplicáveis a grupos inteiros de máquinas, carregadas automaticamente pelo nome do grupo.

O diretório host_vars faz o mesmo para máquinas individuais, com um arquivo nomeado de acordo com cada máquina.

A automação reutilizável fica em um diretório roles. O Ansible procura primeiro nesse local quando uma execução faz referência a uma função pelo nome.

Uma pasta library contém módulos personalizados, enquanto module_utils ou filter_plugins contêm código auxiliar compartilhado que o Ansible descobre automaticamente.

Coloque ansible.cfg na raiz do projeto. O Ansible encontra a configuração no diretório atual, mantendo as definições específicas do projeto.

Com essa estrutura, um único clone do git fornece a um colega os manuais de execução, o inventário, as variáveis e as funções, todos em uma estrutura consistente. 🎯

Aqui está a estrutura recomendada sugerida pela documentação oficial. Memorize a estrutura, não cada arquivo.

Qual arquivo é o ponto de entrada convencional de nível superior para um projeto inteiro?

Você aprendeu a estrutura padrão: site.yml, além de inventário, group_vars, host_vars e roles em um único repositório. Uma estrutura previsível cresce junto com sua equipe. ✅