Anatomia do diretório de uma role

Uma função é apenas um diretório com um conjunto fixo de subpastas. O Ansible conhece cada pasta pelo nome e carrega seu conteúdo automaticamente.

O arquivo tasks/main.yml contém a lista principal de tarefas da função. É a primeira coisa que o Ansible executa quando a função é aplicada.

A pasta handlers define ações como reiniciar um serviço. As tarefas notificam esses manipuladores, para que as reinicializações ocorram somente quando houver alguma alteração.

Coloque seus arquivos de modelo .j2 em templates/. O módulo de modelos os encontra ali pelo nome, sem que seja necessário informar o caminho completo.

A pasta files armazena arquivos simples que você copia sem alterações. O módulo de cópia os localiza automaticamente, assim como os modelos.

O arquivo defaults/main.yml contém variáveis com a menor precedência, para que os usuários possam substituí-las facilmente de fora da função.

O arquivo vars/main.yml contém variáveis com precedência mais alta. Use-o para valores dos quais a função depende e que raramente devem mudar.

O arquivo meta/main.yml lista o autor da função, a licença, as plataformas compatíveis e quaisquer dependências da função.

Dentro de tasks, handlers, vars e defaults, o Ansible carrega automaticamente o arquivo chamado main.yml. Essa convenção de nomenclatura é o que conecta tudo.

Uma função não precisa ter todas as pastas. Se não houver modelos, basta não criar o diretório templates. O Ansible ignora pastas opcionais ausentes.

Funções maduras incluem um README e uma pasta tests, para que outras pessoas entendam e verifiquem sua automação antes de usá-la.

Lembre-se de onde fica a lista principal de tarefas de uma função.

Uma função é uma árvore de pastas na qual tasks, manipuladores, modelos, arquivos, defaults, vars e meta têm, cada um, seu local fixo, todos vinculados a main.yml. 📁