Conceito e mecanismo
Uma tarefa pode terminar com sucesso e não mudar estado; outra pode mudar ficheiros sem produzir um serviço utilizável. Define failed_when e changed_when com base no contrato da operação. Uma lista de condições failed_when usa conjunção implícita: se o requisito é falhar quando qualquer condição ocorre, exprime a disjunção pretendida.
Para flags textuais, normaliza o valor com conversão apropriada em vez de assumir que a string false é sempre interpretada como o booleano false. Handlers são notificados por alterações e normalmente aguardam as fronteiras previstas. Se uma verificação depende da configuração carregada, garante que os handlers pendentes foram executados antes dessa verificação.
Aplicação guiada
Blocos com rescue permitem recuperação, mas não capturam automaticamente todos os problemas. Erros de definição e hosts unreachable não seguem o mesmo caminho de rescue de uma tarefa com falha normal. Um rescue bem-sucedido pode permitir continuidade, incluindo não acionar os limites de falha que alguém esperava.
Num rollout fictício, a reversão funciona mas a regra de aceitação exige parar depois da falha funcional. Codifica essa decisão explicitamente. Serial controla lotes de hosts; forks controla capacidade de execução concorrente e não equivale a lotes com aceitação.
Inclui verificação funcional e reentrada antes de avançar. A equipa deve saber distinguir recuperação do serviço, aprovação da mudança e autorização para continuar a expansão.
Ler a sequência de notificações
O laboratório usa mensagens TRACE para representar operações. Não recarrega serviços nem verifica aplicações reais. Começa com duas tarefas alteradas que notificam activate no mesmo host: o trace mostra as duas escritas e uma ativação.
Quando a primeira escrita é seguida de flush_handlers e existe outra escrita alterada depois, o handler executa duas vezes, uma em cada fase. Define por isso onde a ativação deve ocorrer, sem assumir uma execução única em todo o play. Outro ensaio notifica second antes de first, mas os handlers definidos como first e second executam nessa ordem de definição.
Se uma verificação depende de uma ativação anterior, documenta essa dependência e ensaia a sequência observada. Um tópico listen pode notificar mais de um handler; no exemplo original release-ready aciona ativação e verificação com nomes distintos. A presença dos traces demonstra ordenação, não saúde de um serviço.
Controlar o âmbito da ativação
Uma tarefa percorre alpha e beta; só alpha reporta mudança. Com notify:activate-{{ item }}, o ensaio observa os dois handlers. A alteração agregada da tarefa não corresponde necessariamente ao âmbito de ativação desejado por componente.
Se apenas alpha está autorizado, separa as tarefas ou controla notificações com resultados e condições apropriados, e volta a ensaiar. Outra experiência começa com activation_allowed=true, notifica o handler e muda a variável para false antes de ele executar.
A condição do handler usa o valor posterior e a ativação é ignorada. A notificação não congela a autorização inicial. Por fim, --skip-tags activation não impediu um handler notificado com essa tag.
Não uses a exclusão de tags como controlo de autorização desse caminho. O contrato deve especificar quais operações podem ser notificadas e em que condições podem executar.
Eliminar colisões e conservar divergências observadas
A primeira tentativa criou duas definições chamadas activate e esperava a última, seguindo a descrição da documentação atual. O core 2.19.0 instalado executou a primeira definição no ficheiro do ensaio. Essa divergência foi reproduzida e conservada; não se alterou a narrativa para fingir que a operação esperada tinha ocorrido.
A correção dá nomes distintos activate-old e activate-new e notifica explicitamente activate-new, produzindo o trace pretendido. O código instalado foi inspecionado: a pesquisa inverte blocos de handlers mas percorre tarefas dentro de cada bloco na ordem existente.
Essa leitura ajuda a investigar a diferença, sem estabelecer uma regra universal para todas as versões e formas de carregamento. Para uma entrega de produção, elimina a colisão e guarda a versão, o ficheiro e a sequência ensaiada. A revisão humana deve poder distinguir a operação pretendida da operação realmente observada.
Distinguir falha, recuperação e ação final
Uma tarefa alterada notifica activate e a seguinte falha. Sem forçar handlers, não aparece activation. Com force_handlers:true, o trace aparece, mas o processo continua a terminar com código 2.
Executar uma operação pendente não prova que é seguro ativar a configuração nem remove a falha anterior. No ensaio de rescue, ansible_failed_task.name e ansible_failed_result.msg identificam a validação rejeitada. Se o próprio rescue falhar, always ainda executa neste caminho de falha normal, a tarefa after não executa e a saída permanece falhada.
Com ignore_errors:true na tarefa original, o fluxo continua dentro do block, passa por always e não entra no rescue. Decide que falhas exigem recuperação e que falhas podem ser ignoradas; não substituas essa decisão por uma contagem de traces.
Perda do controlador e hosts inacessíveis não foram simulados neste laboratório e exigem tratamento próprio.
Ensaiar os critérios de paragem
Com dois aliases locais, end_host condicionado a worker_a permite que worker_b continue. End_play, executado quando worker_a satisfaz a condição, termina o play para ambos. Os dois comandos podem terminar sem falha: código zero não prova que as tarefas finais foram executadas.
Para os limites por lote, o inventário contém cinco aliases e serial é 4. Com max_fail_percentage=25, uma falha entre os quatro permite entrar worker_e; duas falhas impedem essa entrada. Um ensaio adicional com limite 20 e uma falha também bloqueia worker_e, distinguindo o denominador do lote da contagem total de cinco hosts.
A percentagem deve ser ultrapassada. Traduz a regra de negócio para estes critérios e testa exemplos de fronteira. Se a política exige parar na primeira rejeição, um limite que permite exatamente 25% não implementa essa política.
Exercício guiado para uma janela de mudança
Antes de executar o runner, escreve a sequência esperada de cada ficheiro e o código final previsto. Distingue ausência de trace, tarefa ignorada, tarefa falhada e execução de um handler. As duas execuções finais usam core 2.19.0 e passam 26 verificações em 20 invocações cada.
Os cinco aliases partilham o controlador; não são cinco servidores isolados. Depois, prepara uma tabela de aceitação de uma mudança fictícia de batch: pré-condição, configuração, ativação, prova funcional, recuperação e regra de expansão. Indica que falha impede o lote seguinte e qual evidência demonstra a paragem.
Introduz uma notificação adicional após flush e uma falha no rescue para testar a previsão. Resume a aprendizagem para RUN: nomes únicos, ordem explícita, condições atuais, limites testados e resultado da mudança separado da recuperação. Relaciona estes critérios com inventários, delegação e ensaios reais de serviços.
Rollback bem-sucedido recupera o serviço anterior; não demonstra que a nova versão foi aceite.
Armadilhas comuns
Lista como OR; rescue como captura universal; forks como serial; recuperação como aprovação.
Tópicos relacionados: Estado e repetibilidade · Inventários, variáveis e configuração · Acesso e ambiente de execução
Ensaiar notificações e falhas demonstra o fluxo; aceitar a mudança exige ainda o estado real do serviço e a política de expansão.
Referências
- Block rescue and always · Current primary reference inspected 2026-09-30
- Handler notification, ordering and scope · Current upstream reference; original control-flow experiment pinned to core 2.19.0
- Failure policy and batch thresholds · Current upstream reference; original control-flow experiment pinned to core 2.19.0
- Meta control flow · Current upstream reference; original control-flow experiment pinned to core 2.19.0