1.5.3. Aplicando um papel

Procedimento

1. Crie um caderno de atividades, incluindo o papel necessário.

   O exemplo a seguir mostra como usar os papéis através da opção roles: para um determinado play:

   ---
   - hosts: webservers
     roles:
        - rhel-system-roles.network
        - rhel-system-roles.timesync

   Para mais informações sobre o uso de papéis em livros didáticos, consulte Documentação possível.

   Veja Exemplos possíveis, por exemplo, livros didáticos.

   Nota

   Cada função inclui um arquivo README, que documenta como utilizar a função e os valores dos parâmetros suportados. Você também pode encontrar um exemplo de playbook para um determinado papel sob o diretório de documentação do papel. Tal diretório de documentação é fornecido por padrão com o pacote rhel-system-roles, e pode ser encontrado no local a seguir:

   /usr/share/doc/rhel-system-roles/SUBSYSTEM/

   Substituir SUBSYSTEM pelo nome da função requerida, como selinux, kdump, network, timesync, ou storage.

2. Verificar a sintaxe do playbook:

   # ansible-playbook --syntax-check name.of.the.playbook

   O comando ansible-playbook oferece uma opção --syntax-check que você pode usar para verificar a sintaxe de um playbook.

3. Executar o playbook nos anfitriões-alvo executando o comando ansible-playbook:

   # ansible-playbook -i name.of.the.inventory name.of.the.playbook

   Um inventário é uma lista de sistemas contra os quais o Ansible funciona. Para mais informações sobre como criar e inventariar, e como trabalhar com ele, consulte a documentação do Ansible.

   Se você não tiver um inventário, você pode criá-lo no momento da execução ansible-playbook:

   Se você tiver apenas um anfitrião específico contra o qual você deseja executar o playbook, use:

   # ansible-playbook -i host1, name.of.the.playbook

   Se você tiver vários anfitriões alvo contra os quais você deseja executar o livro de jogo, use:

   # ansible-playbook -i host1,host2,....,hostn name.of.the.playbook