Adicione o modo de verificação ao seu módulo
Torne o código personalizado seguro para simulações.
Adicione o modo de verificação ao seu módulo é uma aula grátis de DevOps Bootcamp no CoddyKit. Esta é a aula 4 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 DevOps Bootcamp, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de DevOps Bootcamp inclui 4 aulas no total.
O que é o modo de verificação
Com o modo de verificação, os usuários executam um playbook usando --check para visualizar as alterações. Nada é realmente modificado no host.
ansible-playbook site.yml --checkSeu módulo precisa optar pelo recurso
O modo de verificação não é automático. Você precisa declarar o suporte para que o Ansible saiba que seu módulo promete não fazer alterações nesse modo.
Declare isso no AnsibleModule
Defina supports_check_mode=True ao criar o módulo. Esse sinalizador informa ao Ansible que seu código respeita solicitações de execução simulada.
module = AnsibleModule(
argument_spec=spec,
supports_check_mode=True)Leia module.check_mode
Durante a execução, verifique module.check_mode. Ele será True quando o usuário passar --check, e você deverá direcionar sua lógica com base nisso.
if module.check_mode:
module.exit_json(changed=True)Calcule, mas não aplique
No modo de verificação, você ainda deve calcular se uma alteração é necessária. Apenas pare antes de gravar qualquer coisa no sistema.
Informe a alteração prevista
Encerre antecipadamente com o valor correto de changed para que a visualização da execução simulada seja honesta, mesmo que nada tenha acontecido.
if module.check_mode:
module.exit_json(changed=needs_change)As leituras são sempre seguras
Obter o estado atual é aceitável no modo de verificação, pois a leitura não altera nada. Apenas a etapa de gravação deve ser ignorada.
Esquecer isso é perigoso
Se você não der suporte ao modo de verificação, seu módulo ainda poderá modificar o host durante uma execução simulada. Isso frustra a expectativa do usuário.
Replique a lógica da execução real
A detecção de alterações no modo de verificação deve corresponder exatamente a uma execução normal. Uma visualização incorreta é pior do que nenhuma visualização.
Teste os dois caminhos
Execute seu módulo com e sem --check. Confirme que a execução simulada informa o mesmo resultado de changed, mas não altera o sistema.
O modo de verificação gera confiança
Um módulo que respeita o modo de verificação permite que as equipes façam uma visualização segura antes de aplicar as alterações. Esse refinamento diferencia módulos de brincadeira dos que estão prontos para produção.
Verificação rápida
Relembre os dois requisitos que o suporte ao modo de verificação exige do seu módulo.
Recapitulação
Defina supports_check_mode=True, use module.check_mode para direcionar a execução, calcule a alteração mas ignore a gravação e informe changed com honestidade. Agora seu módulo é seguro para execuções simuladas. 🔍
Perguntas Frequentes
A aula “Adicione o modo de verificação ao seu módulo” é grátis?
Sim — o texto completo de “Adicione o modo de verificação ao seu módulo” é 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 DevOps Bootcamp, atualize para CoddyKit PRO. O curso de DevOps Bootcamp inclui 4 aulas no total.
O que vou aprender em “Adicione o modo de verificação ao seu módulo”?
Torne o código personalizado seguro para simulações. Você pratica DevOps Bootcamp 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 DevOps Bootcamp?
Nenhuma experiência prévia é necessária. DevOps Bootcamp 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 4 de 4.
Quanto tempo leva a aula “Adicione o modo de verificação ao seu módulo”?
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 DevOps Bootcamp?
Sim. Cada aula de DevOps Bootcamp 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
- Quando criar um módulo personalizado
- AnsibleModule e especificação de argumentos
- Retorne JSON e respeite changed
- Adicione o modo de verificação ao seu módulo