include_role e import_role em tempo de execução
Invoque roles dinamicamente no meio de um play.
include_role e import_role em tempo de execução é uma aula grátis de Ansible Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Ansible Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Ansible Academy inclui 4 aulas no total.
Além da lista de roles
A lista de roles de nível superior aplica as roles antes da execução de qualquer tarefa. Às vezes, você precisa de uma role no meio da execução, exatamente onde uma tarefa está.
Chame uma role como tarefa
Tanto include_role quanto import_role permitem invocar uma role dentro da seção de tarefas, junto das outras etapas.
tasks:
- import_role:
name: nginximport_role é estático
import_role é processado quando o playbook é analisado, antes do início da execução. Suas tarefas são inseridas antecipadamente e, por isso, não podem depender de dados obtidos durante a execução.
include_role é dinâmico
include_role é processado durante a execução, no momento em que essa tarefa é alcançada. Ele pode reagir a fatos e resultados registrados.
tasks:
- include_role:
name: backup
when: do_backupRepita uma role em um loop
Como include_role é executado dinamicamente, você pode colocá-lo em um loop e aplicar a mesma role com variáveis diferentes a cada repetição.
- include_role:
name: deploy_app
loop: "{{ app_list }}"import_role não aceita loop
Como import_role é resolvido no momento da análise, ele não aceita loop. Use include_role sempre que precisar repetir uma role.
Como o comportamento de when difere
Um when em import_role copia a condição para todas as tarefas internas. Um when em include_role controla a role inteira como uma única unidade.
Passe variáveis de qualquer uma das formas
As duas formas aceitam vars para parametrizar a role, assim como a lista de roles. Os valores são passados diretamente para a role incluída.
- include_role:
name: web
vars:
http_port: 8080Tags e o comportamento estático ou dinâmico
Com import_role, as tags das tarefas importadas ficam visíveis para --list-tags. Com include_role, você precisa aplicar as tags à própria inclusão.
Escolha a ferramenta certa
Prefira import_role para uma estrutura previsível, sempre executada. Prefira include_role quando a role precisar ser executada condicionalmente ou em um loop.
O mesmo padrão em dois níveis
O Ansible oferece a mesma distinção entre estático e dinâmico para arquivos de tarefas: import_tasks e include_tasks reproduzem exatamente essas palavras-chave de roles.
Verificação rápida
Lembre-se de qual palavra-chave pode aplicar uma role dentro de um loop.
Recapitulação
Use import_role para uma estrutura estática, resolvida no momento da análise, e include_role para uma invocação dinâmica durante a execução, com loops e condições. 🔁
Perguntas Frequentes
A aula “include_role e import_role em tempo de execução” é grátis?
Sim — o texto completo de “include_role e import_role em tempo de execução” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Ansible Academy, atualize para CoddyKit PRO. O curso de Ansible Academy inclui 4 aulas no total.
O que vou aprender em “include_role e import_role em tempo de execução”?
Invoque roles dinamicamente no meio de um play. Você pratica Ansible Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Ansible Academy?
Nenhuma experiência prévia é necessária. Ansible Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “include_role e import_role em tempo de execução”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Ansible Academy?
Sim. Cada aula de Ansible Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Dependências de roles em meta/main.yml
- defaults versus vars: a ordem de substituição
- include_role e import_role em tempo de execução
- allow_duplicates e idempotência de roles