Conceito e mecanismo
Um playbook útil descreve as condições necessárias ao resultado, incluindo as dependências que um administrador pode ter criado manualmente. Executá-lo num host antigo pode esconder essa preparação. Nos objetivos EX294, os playbooks são aplicados a sistemas novos e as configurações devem persistir após reinício.
Por isso, distingue execução sem erro, estado pretendido e recuperação desse estado no arranque. Uma montagem ativa agora não prova que existe configuração persistente. Uma diretoria com leitura para o grupo também precisa de search para permitir atravessá-la.
O modo deve representar o requisito de acesso, sem acrescentar escrita apenas para eliminar um erro.
Aplicação guiada
Num projeto fictício de batch, reproduz a configuração num host descartável e compara a primeira execução com uma repetição. Um módulo de estado pode evitar alterações desnecessárias; um command não se torna idempotente apenas por usar register.
Creates pode impedir repetição quando existe um marcador fiável, criado apenas após sucesso validado. Esse marcador não substitui a validação da migração que representa. Num resultado registado, rc, stdout e changed dizem coisas diferentes.
Documenta quais códigos são aceitáveis antes de construir condições. Facts também são observações: ansible_date_time recolhido no início não avança como um relógio vivo. Para medir uma fase posterior, recolhe evidência temporal adequada ao momento.
Medir estado, relato e consumo
O laboratório começa com uma pasta nova e ficheiros sintéticos pertencentes ao utilizador. Uma tarefa copy publica port=8080 com modo 0640. A primeira execução altera o destino e a segunda reporta changed=0.
Compara três coisas: os bytes publicados, os metadados e a forma como um consumidor usa o resultado. A repetição sem alterações é útil para detetar trabalho desnecessário, mas só é aceitável se o estado mantido cumpre o pedido. Outro destino já contém 8080 quando a tarefa passa a pedir 9090 com force:false.
O ensaio termina sem alterações e conserva a porta antiga. A ausência de diferenças não corrige um contrato que escolheu preservar conteúdo desatualizado. Num batch real, a aceitação deve indicar qual configuração se espera e como será observada, além do código de saída da automação.
Reparar uma divergência que o hash não mostra
Depois da primeira repetição, o runner muda apenas o modo de stable.conf para 0666. O hash SHA-256 do conteúdo continua igual. Check mode prevê uma alteração, mas a inspeção posterior ainda mostra 0666.
Só a execução real repõe 0640; uma nova repetição regressa a changed=0. Este ciclo demonstra deteção, previsão, reparação e estabilidade, sem confundir as quatro fases. Se a pipeline comparar apenas o hash dos bytes, a divergência de permissões passa despercebida.
O mesmo cuidado aplica-se a dono, grupo e outros atributos exigidos pelo ambiente. Uma permissão declarada também não demonstra acesso de uma identidade que não participou no ensaio. O laboratório observa o modo local, sem validar ACL, SELinux ou grupos de um serviço remoto.
A aceitação desse serviço precisa da sua identidade e do seu contexto reais.
Não esconder efeitos na contagem de alterações
Um script original acrescenta a linha effect a um ficheiro sempre que é chamado. O play executa-o duas vezes com changed_when:false. Os dois recaps mostram zero alterações, mas o ficheiro termina com duas linhas.
Esta observação distingue a decisão de executar da política de relato. Se o requisito é evitar repetição de uma operação, define o estado pretendido ou uma condição de execução com evidência adequada. Não uses a supressão do relato como substituto.
Outra experiência aplica state:touch a um marcador antigo e observa um mtime novo. Quando access_time e modification_time são explicitamente preserve, o marcador já existente mantém o mtime e a tarefa não reporta mudança. Escolhe essa política apenas se o significado do marcador permitir conservar os tempos; se ele representa uma execução recente, preservar um timestamp antigo seria uma informação enganadora.
Repetir o ensaio e entregar critérios verificáveis
Prevê que tarefas devem alterar ficheiros e que propriedades podem continuar erradas com changed=0. Executa o runner numa pasta nova e consulta as observações guardadas. As duas execuções finais passaram 34 verificações com 23 invocações cada, em core 2.19.0 e filesystem local macOS.
Depois, altera uma cópia dos dados e repete o ciclo de deteção, reparação e nova inspeção. O exercício também cria destinos de modo 0664 e altera os seus bytes sem mode explícito. Mesmo com umask 0077, o modo anterior permanece.
Declarar 0640 corrige-o nos dois umasks ensaiados. Entrega a RUN a política esperada e as observações correspondentes, incluindo os limites da prova. Relaciona esta aula com contratos de dados, inventários, permissões de contas e validação de templates.
Serviços remotos e persistência após reboot continuam a necessitar de ensaios próprios.
A montagem funciona antes do reboot; o ensaio só termina quando se confirma o recurso montado depois dele.
Armadilhas comuns
Host preparado como prova universal; changed como sucesso; marcador criado antes da validação.
Tópicos relacionados: Inventários, variáveis e configuração · Acesso e ambiente de execução · Git, dev containers e ensaios
Verifica os efeitos e o estado requerido; changed=0 só é útil com critérios de aceitação corretos.
Referências
- EX294 Advanced System Administrator in Ansible objectives · EX294 objectives inspected 2026-09-30
- Copy contents and metadata · Current primary reference; original local module experiment pinned to core 2.19.0
- Manage filesystem objects · Current primary reference; original local module experiment pinned to core 2.19.0
- Inspect filesystem status · Current primary reference; original local module experiment pinned to core 2.19.0
- Check-mode predictions · Current primary reference; original local module experiment pinned to core 2.19.0
- Change reporting and error handling · Current primary reference; original local module experiment pinned to core 2.19.0
- Linux rename manual: descriptors and links · Current Linux primary manual; separate local macOS experiment, not RHEL runtime verification