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. |

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.



