← RHCE in Ansible: automação e operação
06 / 23 · 110 MIN

Roles, collections e contratos

Reutiliza automação com dependências e interfaces explícitas.

Conceito e mecanismo

Uma role organiza tarefas, handlers, variáveis, ficheiros e outros componentes relacionados. Reutilizar essa estrutura é útil quando a interface é compreensível: quais valores o consumidor deve fornecer, quais têm defaults e quais restrições existem.

Defaults permitem opções substituíveis pelo consumidor dentro das regras de precedência. Não escondas uma decisão que precisa de ser configurável numa camada que impede a substituição pretendida. A validação de argumentos de roles permite declarar tipos e requisitos, detetando um contrato incorreto antes de executar trabalho dependente.

Um parâmetro ausente deve produzir uma mensagem compreensível, em vez de uma falha remota difícil de relacionar com a entrada original.

Aplicação guiada

Collections distribuem conteúdo com namespace e identidade própria. Usar namespace.collection.module esclarece o módulo, mas a collection continua a precisar de instalação no ambiente correto. Para obter uma role de um repositório, regista uma revisão estável aprovada em vez de depender de uma branch móvel.

O pinning ajuda a repetir o artefacto, sem provar que ele é seguro ou adequado. Num projeto fictício de middleware, a equipa de plataforma publica uma role e APS fornece os valores de cada ambiente. Antes de a promover, ensaia entradas válidas e inválidas, confirma as dependências da EE e revê mudanças de interface.

Documenta também como atualizar a dependência, para que reprodutibilidade não se transforme em obsolescência permanente.

Seguir a origem do valor usado

O laboratório cria uma role batch_contract para um processo batch fictício. O default da janela é 90, mas o inventário do worker fornece 75. O ficheiro de aceitação contém 75.

Em paralelo, uma política escrita em vars/main.yml prevalece sobre a política do inventário. Numa execução seguinte, extra vars fornecem janela 60 e outra política, substituindo ambos os valores anteriores. Antes de culpar o template ou o host, constrói uma tabela com as origens possíveis e confirma o valor resolvido no ambiente utilizado.

Não uses o nome policy como garantia de imposição: continua a ser uma variável, sujeita à precedência demonstrada. Para uma alteração de produção, o registo da execução deve identificar o inventário, os argumentos e a revisão da role, sem expor dados sensíveis.

Um ficheiro correto no portátil não prova que RUN resolverá as mesmas entradas.

Transformar a interface num contrato útil

A interface do exercício permite inteiros 60, 75 ou 90. O valor 5 é um inteiro válido, mas viola as escolhas permitidas. Com validação ativa, a role falha antes de criar accepted.txt.

Com rolespec_validate:false, o mesmo valor chega ao ficheiro. Esta comparação demonstra por que razão um job verde pode deixar de ser evidência de conformidade quando se remove a verificação que definia a aceitação. Corrige a entrada ou revê formalmente o requisito; não confundas a remoção da rejeição com aprovação.

Outro ensaio declara default:42 apenas em argument_specs. O corpo observa MISSING porque não recebeu uma variável runtime com esse valor. Mantém o valor efetivo em defaults/main.yml e a documentação da interface alinhada.

Testa valores permitidos, ausentes e inválidos, em vez de ensaiar apenas o exemplo feliz.

Inspecionar o que ocorreu antes da falha

A role guarded depende de prerequisite. A dependência cria prerequisite.txt; só depois a validação do pai rejeita approval=pending. O ficheiro parent.txt nunca é criado, mas o ficheiro da dependência permanece.

Num relatório operacional, escreve ambos os factos: o corpo principal foi bloqueado e houve um efeito anterior. Uma tarefa de preparação real poderia criar uma diretoria, mudar uma permissão ou reservar um recurso. O procedimento de retorno depende desse efeito concreto, não apenas do código de saída global.

Antes de repetir, identifica se a preparação é idempotente, se a repetição é autorizada e se há estado parcial a reconciliar. O laboratório usa apenas ficheiros locais sintéticos; o marcador não representa um mecanismo real de aprovação. Esta limitação permite estudar a ordem sem simular autorização de produção.

Delimitar âmbito, entrada e repetição

Com public:false, um default pode ser usado dentro da role e continuar indisponível na tarefa seguinte. Com public:true, o ensaio observa MISSING antes da inclusão dinâmica e from-role depois dela. A opção não altera retroativamente uma tarefa anterior.

Se uma pré-condição precisa do valor, fornece uma entrada explícita ou revê a ordem. A seleção tasks_from:inspect também muda o corpo executado: inspection.txt aparece sem setup.txt, pois main não corre implicitamente primeiro. Por fim, duas entradas estáticas idênticas de counted produzem uma linha; duas inclusões dinâmicas com opções por omissão produzem duas.

Não transfiras pressupostos sobre duplicados entre formas de invocação. Define se repetir é necessário e torna o corpo seguro para essa repetição. Estes resultados foram observados em core 2.16.14; opções introduzidas em versões posteriores exigem verificação própria.

Empacotar e descobrir a collection certa

O exercício constrói dr_lab.contracts 1.0.0 a partir de código original, instala o tarball offline em package-store e executa dr_lab.contracts.stamp. O marcador confirma essa role no ambiente local. Ao retirar package-store do caminho ativo, a resolução falha.

Depois de copiar a mesma collection para collections/ansible_collections junto do playbook, a execução volta a funcionar mesmo com o caminho configurado vazio. Esta comparação é útil quando um portátil parece funcionar sem uma dependência que falta no pipeline: inspeciona também o conteúdo adjacente ao projeto.

FQCN identifica namespace, collection e conteúdo; não instala dependências nem fixa por si uma versão. Conserva o manifesto, a versão instalada e a localização efetiva. Um tarball local sem verificação de assinatura não deve ser apresentado como prova de autenticidade emitida por um distribuidor.

Preparar uma entrega repetível para RUN

Um intervalo de versões pode permitir artefactos diferentes em builds com o mesmo commit da aplicação. Para reproduzir uma mudança aprovada, conserva as versões resolvidas e ensaia a instalação no ambiente que será usado. Se requirements.yml mistura roles e collections, confirma que o pipeline instala ambas: o subcomando collection não trata a instalação das roles isoladas.

Numa janela sem registry, prepara também as dependências e verifica o conjunto antes da indisponibilidade. O exercício guiado termina quando consegues explicar cada ficheiro criado, cada ausência esperada e as falhas deliberadas. Acrescenta depois um plano para validar uma role real com os acessos de RUN, critérios funcionais e recuperação de efeitos parciais.

O laboratório local não demonstra serviços RHEL, reboot, SSH, AAP ou um simulado completo EX294; essas evidências têm de ser obtidas no ambiente correspondente.

RESULTADOS OBSERVADOS
Default 90 + inventário 75 -> 75
Vars da role: role-policy; extra var -> extra-policy
Choices 60/75/90 + entrada 5 -> rejeição
rolespec_validate:false + entrada 5 -> ficheiro com 5
Default apenas em argument_specs -> MISSING
Falha do pai -> efeito da dependência permanece
tasks_from:inspect -> inspection.txt, sem setup.txt
Role estática duplicada: 1; dois includes dinâmicos: 2
Collection adjacente -> descoberta mesmo com caminho configurado vazio
NA PRÁTICA

A role aceita service_port como inteiro; uma entrada incompatível deve falhar com indicação do contrato.

Armadilhas comuns

Reutilização sem interface; FQCN sem instalação; branch móvel como versão fixa; pinning como garantia de segurança.

Tópicos relacionados: Estado e repetibilidade · Inventários, variáveis e configuração · Acesso e ambiente de execução

Leva esta ideia contigo

Identifica o contrato e o conteúdo efetivos, observa efeitos parciais e entrega a RUN uma execução que possa repetir.

Criar conta

Referências

Red Hat®, RHCE e Ansible são marcas comerciais ou marcas registadas de Red Hat, Inc. A dr.pt é uma plataforma de preparação independente e não está afiliada, associada, patrocinada, autorizada nem aprovada por Red Hat. Os conteúdos e as perguntas são originais, não são perguntas oficiais de exame, e concluir os nossos testes não atribui nem garante qualquer certificação. Os nomes são usados apenas para identificar o tema. Todas as outras marcas pertencem aos respetivos titulares.