Detecte desvios sem aplicar alterações

ShellBeginner
Pratique Agora

Introdução

Um relatório foi editado fora do Terraform. Sua equipe precisa de um job de observação que identifique a diferença, diferencie-a de uma falha de execução e deixe a decisão de corrigir no fluxo de entrega com revisão.

Você observará um ambiente correspondente à configuração, fará uma edição externa controlada, repetirá a observação sem corrigi-la e exercitará uma entrada inválida do job. Em seguida, corrigirá o armazenamento por meio de um plano concreto separado, revisão e aplicação. A ação de observação fornecida executa o planejamento nativo com códigos de saída detalhados e registra os resultados; ela não tem uma etapa automática de apply.

Você deve compreender planos salvos, aplicação revisada, estado e isolamento de ambientes e códigos de saída do shell. Este laboratório começa de forma independente, com dois armazenamentos de relatórios existentes e um objeto vizinho separado. Suas entradas da release desejada e verificações de qualidade obrigatórias já estão preparadas e devem permanecer inalteradas.

Relação com certificações

Certificação Tarefa do exame Prática
DevOps Engineer – Professional (DOP-C02) Tarefa 2.1 Prática básica de gerenciamento de alterações de IaC: observar diferenças e erros efetivos antes de uma correção revisada separadamente.

Um plano nativo somente leitura classifica a observação como 0, 1 ou 2; a correção é um fluxo separado com revisão.

Observe um ambiente correspondente à configuração

Nesta etapa, você criará uma solicitação de observação para uma revisão explícita do código-fonte e um ambiente e interpretará um resultado genuíno sem alterações.

Entre no repositório preparado e carregue suas ferramentas.

cd /home/labex/project/report-release
source environment.sh

Leia a release desejada e as etapas de qualidade.

cat release.auto.tfvars.json pipeline.json

Tanto delivery-release-preview quanto delivery-release-review contêm atualmente release one report. O Terraform gerencia cada bucket e seu relatório por meio de um estado de ambiente separado. delivery-release-neighbor/keep.txt contém dados não relacionados. Preserve os arquivos do Terraform, as entradas de release, o arquivo de bloqueio de dependências, os testes e as etapas de qualidade fornecidos; suas solicitações editáveis de job em JSON são separadas da configuração desejada do Terraform.

Registre o commit atual de referência para este job e a correção revisada posterior.

git rev-parse HEAD > selected-revision.txt

Construa a solicitação de observação com jq. -n inicia sem um documento de entrada, e --arg revision fornece uma string de forma segura à expressão JSON. A solicitação resultante seleciona explicitamente preview e a revisão registrada do código-fonte.

jq -n --arg revision "$(cat selected-revision.txt)" '{revision: $revision, environment: "preview"}' > observation.json

Leia a solicitação.

cat observation.json

Ela deve conter o identificador completo do commit e environment: preview. Execute a ação de observação fornecida.

python3 delivery.py observe observation.json

Espere o código de saída nativo 0 do Terraform e classification: no_changes. A configuração desejada atualmente corresponde ao destino observado. Esse resultado diz respeito ao módulo e ao ambiente selecionados, não à saúde de todos os sistemas.

A ação exporta o código-fonte selecionado e executa o comando nativo terraform plan -detailed-exitcode sem salvar um plano de saída nem executar apply. Ela registra o status efetivo e as impressões digitais do estado de negócio. Nenhuma alteração é uma evidência útil; isso não autoriza uma modificação posterior.

Leia o relatório atual diretamente do armazenamento.

aws s3 cp s3://delivery-release-preview/report.txt -

Espere release one report.

Diferencie desvio de erro de execução

Nesta etapa, você criará uma edição externa conhecida e mostrará que a observação repetida não a corrige. Também produzirá um erro nativo genuíno de validação de entrada, que não deve ser classificado nem como um ambiente sem alterações nem como desvio detectado.

Prepare um pequeno relatório substituto localmente. printf grava o texto e sua quebra de linha final.

printf 'outside edit\n' > outside-report.txt

Envie-o para a chave do objeto existente de preview pela AWS CLI. Isso altera intencionalmente apenas os bytes do relatório fora do Terraform; não atualiza o código-fonte desejado nem o estado de negócio do Terraform.

aws s3 cp outside-report.txt s3://delivery-release-preview/report.txt --content-type text/plain

Observe novamente o código-fonte inalterado. Este comando retorna intencionalmente o código de saída 2.

python3 delivery.py observe observation.json

Espere classification: changes_detected e uma atualização proposta para restaurar o relatório. O código nativo 2 significa que um plano bem-sucedido encontrou diferenças; não é uma falha de provedor ou execução. Diferentemente do comando de geração de plano salvo do laboratório anterior, este comando de observação propaga deliberadamente o status nativo para que os chamadores possam classificá-lo.

Repita exatamente o mesmo job. Este comando retorna intencionalmente o código de saída 2 novamente.

python3 delivery.py observe observation.json

A diferença deve permanecer porque nenhuma das observações aplica a proposta. Leia o objeto efetivo após as duas execuções.

aws s3 cp s3://delivery-release-preview/report.txt -

Ele ainda deve dizer outside edit. O job informa o desvio sem gravar silenciosamente os dados desejados de volta nem sobrescrever o estado de negócio. Bloqueios nativos temporários e logs comuns de acesso são efeitos de coordenação, não uma correção.

Crie uma solicitação inválida separada. report_override é uma entrada fornecida exclusiva da observação para exercitar uma execução inválida sem alterar o código-fonte registrado em commit. Um relatório vazio viola a regra de validação existente do módulo. A solicitação válida original permanece inalterada.

jq '. + {report_override: ""}' observation.json > invalid-observation.json

Execute essa solicitação. Este comando retorna intencionalmente o código de saída nativo 1.

python3 delivery.py observe invalid-observation.json

Espere classification: execution_error e The report input must not be empty. Esta é a falha de validação pretendida do Terraform. Uma falha de rede ou provedor também exigiria investigação; ela nunca deve ser informada como ausência de alterações nem tratada como detecção bem-sucedida de desvio.

Volte à solicitação válida original. Este comando retorna intencionalmente o código de saída 2 porque a edição externa não foi corrigida.

python3 delivery.py observe observation.json

Leia o relatório efetivo novamente.

aws s3 cp s3://delivery-release-preview/report.txt -

Espere outside edit. As execuções válidas repetidas e a execução inválida não corrigiram o objeto, não alteraram a configuração de referência nem sobrescreveram o estado de negócio. Os três resultados nativos são distintos: 0 para nenhuma alteração, 2 para alterações detectadas e 1 para um erro de execução.

Corrija por meio de revisão e observe novamente

Nesta etapa, você encaminhará a diferença conhecida ao fluxo normal de entrega. A observação forneceu informações; a sequência separada de plan/review/apply torna a correção explícita.

Gere um artefato concreto de correção para a mesma referência selecionada e o ambiente preview.

python3 delivery.py plan repair-baseline --revision "$(cat selected-revision.txt)" --environment preview

Espere que as verificações de qualidade passem e que o plano nativo com código 2 identifique a atualização do relatório. O comando de entrega retorna 0 porque gerou o artefato com sucesso. As entradas do código-fonte ainda solicitam o relatório original; não as edite para ocultar a alteração externa.

Inspecione a proposta efetiva e seu contexto.

python3 delivery.py inspect repair-baseline

Confirme que ela tem como destino delivery-release-preview/report.txt e restaura o relatório de referência. A revisão selecionada, o bloqueio de dependências e o ambiente devem corresponder à correção que você pretende autorizar.

Registre a revisão.

python3 delivery.py review repair-baseline --revision "$(cat selected-revision.txt)" --environment preview

Aplique esse plano binário revisado pelo ponto de entrada fornecido.

python3 delivery.py apply repair-baseline --revision "$(cat selected-revision.txt)" --environment preview

Espere o código de saída nativo 0 de apply. Esta é a correção deliberada; a própria ação de observação não aplicou nada.

Execute a observação original mais uma vez.

python3 delivery.py observe observation.json

Espere o código de saída nativo 0 e classification: no_changes. O código-fonte desejado e o destino efetivo agora concordam. Esta observação final deve manter inalterados os bytes do estado de negócio corrigido.

Leia o relatório restaurado.

aws s3 cp s3://delivery-release-preview/report.txt -

Espere release one report. Verifique o ambiente vizinho e os dados não relacionados.

aws s3 cp s3://delivery-release-review/report.txt -

Espere release one report lá também.

aws s3 cp s3://delivery-release-neighbor/keep.txt -

Espere preserve release neighbor. Mantenha os armazenamentos existentes restaurados, o estado e as evidências do job para avaliação. Nenhuma pilha de infraestrutura separada foi criada. Você manteve a observação repetível e somente leitura, encaminhando a correção efetiva por meio de um artefato explicitamente revisado.

Resumo

Você configurou um job de observação específico para um código-fonte e distinguiu os resultados nativos 0 para nenhuma alteração, 2 para alteração detectada e 1 para erro de execução. As observações repetidas preservaram a edição externa efetiva e o estado de negócio. Um plano salvo separado e revisado realizou a correção; depois disso, a observação voltou a indicar nenhuma alteração, preservando o outro ambiente e os dados vizinhos.

Observação e correção têm responsabilidades diferentes. Leia os diagnósticos e classifique os erros antes de decidir o que alterar. Consulte a referência oficial de códigos de saída detalhados para conhecer os status nativos usados aqui.