Uma interface que pode ser revista
Uma role reutilizável precisa de tornar explícito o que recebe, que valores admite e que efeitos produz. No laboratório original, role_port tem default 8080 e a interface exige um inteiro dentro de 7070, 8080 e 9090. O corpo apenas escreve um ficheiro temporário; não abre uma porta de rede.
Este contrato permite rever entradas antes da tarefa principal. Para uma role de middleware, documenta também significado, unidade e compatibilidade de cada parâmetro. Um inteiro válido pode continuar a ser inadequado para uma aplicação ou uma mudança concreta.
Seguir o valor efetivo até à origem
Três execuções controladas produzem 8080 com o default, 9090 com uma variável de inventário e 7070 com extra vars em JSON. O resultado ensina precedência no contexto observado, não uma regra baseada na última linha de um ficheiro. O laboratório também define policy_label no play e em vars da role: prevalece role-policy.
Para um valor que os consumidores devem configurar facilmente, defaults é uma opção diferente de vars. Na revisão de uma mudança, regista as origens efetivas, incluindo o inventário e as entradas do pipeline, sem incluir segredos no relatório.
Validar entradas sem presumir uma transação
A entrada invalid-port é rejeitada pela validação da role e o ficheiro do corpo não é criado. Essa observação delimita a execução desta role. Não prova que nenhum passo anterior tenha alterado o ambiente.
A documentação descreve ainda a validação de dependências antes da role que delas depende. Num pipeline fictício, uma preparação anterior pode já ter criado diretórios. Antes de repetir, identifica as tarefas realmente executadas e os efeitos existentes.
Uma falha de interface informa sobre um contrato incumprido; não constitui um rollback global nem uma aprovação automática de limpeza.
Exposição dinâmica e confidencialidade
Com include_role e public=false, o default exposure_value existe dentro da role, mas não na tarefa seguinte. Com public=true, a observação anterior continua falsa e a seguinte passa a verdadeira. Esta exposição aplica-se às tarefas posteriores da inclusão dinâmica; não recalcula tarefas já executadas.
O controlo também não protege automaticamente conteúdo emitido por debug. Para rever confidencialidade, usa marcadores fictícios e acompanha o percurso até logs e artefactos. Trata disponibilidade de variáveis e proteção de informação como requisitos distintos, com controlos próprios e acesso adequado ao output.
Compatibilidade e aceitação da role
Uma nova versão de uma role pode aceitar o mesmo tipo e mudar o significado do parâmetro. Revê o contrato, as dependências e os consumidores antes de atualizar a referência do pipeline. A validação de argumentos é apenas uma camada.
Uma role que produz configuração precisa ainda de demonstrar que o candidato é adequado, que a publicação ocorreu no alvo correto e que o processo utiliza a geração pretendida. O laboratório não executa um serviço real, pelo que o ficheiro produzido só comprova seleção e escrita de valores neste executor local.
Oficina de aprovação de uma porta
No caso fictício, a mudança aprova 8080 e a firewall só permite essa porta. Um override seleciona 7070, que pertence às escolhas válidas da role. A ação adequada é suspender a aplicação e alinhar o valor efetivo com a decisão aprovada, ou obter uma alteração de âmbito com as dependências revistas.
Prepara a evidência com versão da role, origens de variáveis e valor resultante. Em inglês, comunica: “The input passes role validation, but it differs from the approved port.” Esta formulação separa o comportamento técnico da decisão ainda necessária.
Role default: 8080; inventário: 9090; extra vars: 7070. Os três resultados foram escritos em ficheiros temporários por ansible-core 2.21.4, sem ligações a aplicações.
Armadilhas comuns
Confundir choices com autorização; usar vars para toda a configuração; presumir que public protege logs; interpretar uma validação falhada como reversão de tarefas anteriores.
Tópicos relacionados: Tarefas e estado pretendido · Orquestração por lotes · Falhas e recuperação
Uma interface verificável precisa de origem dos valores, limites explícitos e critérios de resultado. Passar a validação da role não demonstra ativação nem aprovação operacional.
Referências
- Reusing Ansible artifacts: roles · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- Controlling how Ansible behaves: precedence rules · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- ansible.builtin.include_role · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- Controlling where tasks run: delegation and local actions · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- ansible.builtin.set_fact · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- Controlling playbook execution: strategies and more · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- Handlers: running operations on change · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- Error handling in playbooks · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1
- Blocks · Rolling latest documentation consulted 2026-10-03; original local experiments use ansible-core 2.21.4 and Python 3.13.1