Instale roles com requirements.yml

Executar comandos de instalação um por um não é escalável. O arquivo requirements.yml lista cada dependência, para que o projeto inteiro seja instalado de uma só vez.

Considere requirements.yml como o manifesto de pacotes do projeto: ele declara exatamente de quais funções e coleções seus playbooks precisam para serem executados.

Dentro do arquivo, a chave roles contém uma lista. Cada entrada indica uma função a ser obtida do Galaxy pelo identificador author.name.

Uma chave collections separada lista as coleções pelo nome namespace.collection, para que um único arquivo cubra os dois tipos de conteúdo.

Sempre adicione uma versão para que as instalações sejam reproduzíveis. Sem ela, você pode obter uma versão mais recente que cause problemas no computador de outra pessoa da equipe.

Indique o arquivo ao ansible-galaxy com -r, e ele resolverá e instalará todas as dependências listadas em um único comando.

O comando de instalação simples lida com funções. Para coleções, use o subcomando collection install com a mesma opção -r.

Uma entrada de função pode usar uma URL do Git em src em vez de um nome do Galaxy, permitindo instalar funções privadas ou não publicadas.

Adicione -p para colocar as funções em uma pasta local do projeto, como roles/, em vez do caminho global, mantendo cada projeto autocontido.

Por padrão, as funções existentes são mantidas. Passe --force para baixá-las novamente e sobrescrevê-las quando você atualizar uma versão fixada.

Inclua requirements.yml no Git, mas ignore as pastas das funções baixadas. Qualquer pessoa pode reconstruir exatamente o mesmo conjunto a partir do manifesto.

Liste as funções e coleções em requirements.yml, fixe as versões e instale tudo com ansible-galaxy -r. Um arquivo, configurações reproduzíveis. 📦