Aplique uma alteração aprovada

ShellBeginner
Pratique Agora

Introdução

Sua equipe registrou em commit uma proposta para o armazenamento de relatórios. Um plano bem-sucedido está pronto para inspeção, mas ainda não foi revisado nem aplicado. O fluxo de entrega deve consumir o artefato específico que foi revisado e ainda respeitar o estado atual do Terraform.

Você tentará usar um artefato não revisado, vinculará uma revisão ao seu contexto exato, aplicará o plano aprovado e observará um segundo plano salvo tornar-se obsoleto. Em seguida, gerará, revisará e aplicará um plano novo. Este é um fluxo local com registros persistentes e um ponto de entrada de execução fornecido; ele demonstra a admissão mediante revisão e a consistência do estado, sem afirmar resistência a adulterações por administradores.

Você deve compreender artefatos de planos salvos, testes de módulos, seleção de revisões do Git, bloqueio de estado do Terraform e ambientes separados. Este laboratório começa de forma independente, com armazenamentos de relatórios existentes e uma proposta de código-fonte preparada; ele não reutiliza nenhuma VM anterior.

Relação com certificações

Certificação Tarefa do exame Prática
DevOps Engineer – Professional (DOP-C02) Tarefa 1.3 Prática básica do ciclo de vida de artefatos: revisar um plano salvo específico, consumir esse artefato e tratar sua invalidação após uma alteração de estado.

Um plano concreto é vinculado a uma revisão antes da aplicação controlada; artefatos não revisados e obsoletos são recusados.

Prepare artefatos específicos antes da revisão

Nesta etapa, você criará dois planos salvos a partir da mesma proposta registrada em commit e comprovará que um plano não revisado não pode passar pelo ponto de entrada de aplicação fornecido.

Entre no repositório preparado e carregue suas ferramentas.

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

Leia a proposta, as etapas de qualidade e o histórico recente.

cat release.auto.tfvars.json pipeline.json
git log --oneline -2

A proposta preparada solicita release-two e release two report. Os armazenamentos atuais de preview e review ainda contêm release one report. Seus arquivos de estado são separados. O objeto vizinho delivery-release-neighbor/keep.txt contém dados não relacionados que devem ser preservados. Mantenha intactos o módulo, o provedor, o arquivo de bloqueio de dependências, os testes, os executores e as etapas de qualidade fornecidos.

Registre o identificador completo do commit que você pretende entregar. O arquivo de seleção contém informações não rastreadas da solicitação; os comandos posteriores usam seu conteúdo, em vez de acompanhar um HEAD que pode mudar.

git rev-parse HEAD > selected-revision.txt

Gere o primeiro artefato de preview. A substituição de comando lê o commit selecionado para --revision; --environment preview seleciona explicitamente o destino.

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

Espere que fmt, validate e os testes em modo de planejamento passem, seguidos por um plano nativo com duas atualizações e nenhuma adição ou exclusão. O código de saída nativo 2 do plano significa que existem alterações; o comando de entrega retorna 0 porque produziu o artefato com sucesso.

Gere um segundo artefato para o mesmo código-fonte e estado atual. Seu nome separado representa um plano que ficará adiado enquanto outra execução aprovada prossegue.

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

Os dois planos atualmente propõem a mesma release. Cada um tem seu próprio plano binário, visualizações legível/JSON e contexto registrado. Nenhum foi aplicado.

Tente usar o primeiro plano pelo ponto de entrada de aplicação antes de revisá-lo. Este comando retorna intencionalmente o código de saída 1.

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

Espere No matching review of this concrete artifact. O resultado registra native_exit: null: a admissão foi interrompida antes da execução de um comando apply do Terraform. Isso difere de uma falha nativa do Terraform. A existência de um plano não concede aprovação.

Leia o relatório atual de preview.

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

Ele ainda deve dizer release one report. Os dois planos e a solicitação recusada mantiveram o ambiente de negócio inalterado.

Revise e aplique o plano concreto

Nesta etapa, você revisará as ações efetivamente propostas e registrará a aprovação para os artefatos exatos. A revisão persiste entre os comandos separados de entrega.

Inspecione o primeiro plano.

python3 delivery.py inspect release-two

Confirme que o plano salvo tem como destino delivery-release-preview, atualiza a tag de release e o conteúdo do relatório para os valores solicitados e não tem adições nem exclusões. Sua revisão deve corresponder a selected-revision.txt; as impressões digitais do código-fonte, do bloqueio de dependências e do plano binário identificam o objeto concreto da revisão.

Registre a revisão usando o mesmo artefato, revisão do código-fonte e ambiente.

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

Espere review_recorded: true. Isso registra uma decisão do fluxo local; não é uma operação sobre recursos do Terraform. Uma revisão diferente do código-fonte, outro ambiente ou um artefato alterado não corresponderiam a essa revisão.

Inspecione o artefato adiado como um objeto separado de revisão. Confirme a mesma revisão solicitada, o ambiente preview e as duas atualizações pretendidas.

python3 delivery.py inspect delayed-two

Registre sua própria revisão. Uma proposta correspondente não torna os dois registros de artefatos intercambiáveis.

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

Aplique apenas o primeiro artefato.

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

O ponto de entrada verifica novamente o contexto selecionado, os bytes exatos do artefato e a revisão persistida correspondente e, em seguida, invoca o Terraform nativo sobre o plano binário salvo. Seu bloqueio de gravação fornecido serializa as gravações deste fluxo, enquanto o Terraform trata o bloqueio de estado do backend. Espere o código de saída nativo 0 de apply e dois recursos alterados. O comando consome a proposta salva, em vez de gerar silenciosamente outro plano.

Leia o relatório efetivamente implantado.

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

Agora ele deve dizer release two report. Inspecione também as tags efetivas do bucket.

aws s3api get-bucket-tagging --bucket delivery-release-preview

Espere Environment=preview e Release=release-two. Os dados armazenados e as tags comprovam que o ambiente pretendido mudou; um comando bem-sucedido, por si só, não estabeleceria esse resultado.

Recuse o plano obsoleto e revise um novo

Nesta etapa, você observará por que a aprovação, por si só, não pode tornar um plano salvo atual. A primeira aplicação avançou o estado de preview depois da geração dos dois planos. O plano adiado preserva seu retrato original do estado, embora seu código-fonte e sua revisão ainda correspondam.

Tente aplicar o artefato adiado já revisado. Este comando retorna intencionalmente o código de saída 1.

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

Espere o diagnóstico efetivo Saved plan is stale do Terraform e o código de saída nativo 1. Desta vez, o fluxo admitiu o artefato revisado correspondente, mas o Terraform nativo recusou seu contexto de estado desatualizado. A release concluída deve permanecer intacta. Não reescreva o estado nem exclua o arquivo de estado para contornar essa recusa.

Gere um novo artefato em relação ao estado atual, mantendo o mesmo código-fonte e ambiente explicitamente selecionados.

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

Espere um artefato bem-sucedido com código de saída nativo 0 do plano: a release solicitada já está implantada. Nenhuma alteração é um resultado válido, diferente de um erro de execução. Um novo artefato ainda exige sua própria revisão.

Inspecione a proposta regenerada e seu contexto.

python3 delivery.py inspect release-current

Confirme que ela descreve nenhuma alteração e ainda identifica a revisão escolhida e o ambiente preview. Seu plano concreto e registro de geração diferem dos do antigo artefato adiado.

Revise este novo artefato.

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

Aplique-o pelo mesmo ponto de entrada.

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

Espere o código de saída nativo 0 de apply, sem alterações de recursos. A revisão é vinculada a um artefato; não é uma permissão geral para aplicar qualquer plano posterior. A verificação de plano obsoleto do Terraform trata de seu estado registrado e não estabelece que nada fora do Terraform mudou; o próximo laboratório apresenta um fluxo separado de observação.

Confirme que o relatório atual de preview foi preservado.

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

Espere release two report. Verifique o ambiente vizinho.

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

Ele ainda deve dizer release one report. Por fim, leia os dados não relacionados.

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

Espere preserve release neighbor. Você atualizou um armazenamento existente e criou artefatos locais, sem criar uma pilha de nuvem separada. Preserve a release implantada, os dois arquivos de estado existentes e os recursos vizinhos para avaliação.

Resumo

Você separou planejamento, revisão e aplicação; recusou uma solicitação não revisada; e verificou alterações efetivas no relatório e nas tags após consumir um plano binário revisado. Um segundo plano revisado então falhou na verificação nativa de plano obsoleto do Terraform após o avanço do estado. Você gerou, inspecionou e revisou um novo artefato sem alterações antes de aplicá-lo com sucesso, preservando o outro ambiente e os dados não relacionados.

Este fluxo vincula uma revisão local ao contexto exato do artefato e delega as verificações de atualidade do estado ao Terraform nativo. Ele não transforma uma aprovação em autoridade irrestrita para novos artefatos. Consulte a referência oficial de aplicação de planos salvos para conhecer a operação do Terraform usada pelo ponto de entrada fornecido.