Aplica un cambio aprobado

ShellBeginner
Practicar Ahora

Introducción

Tu equipo ha registrado en un commit una propuesta para un almacén de informes. Un plan generado correctamente está listo para inspeccionarse, pero todavía no se ha revisado ni aplicado. El flujo de entrega debe utilizar el artefacto específico que se revisó y seguir respetando el estado actual de Terraform.

Intentarás usar un artefacto sin revisar, vincularás una revisión con su contexto exacto, aplicarás el plan aprobado y observarás cómo un segundo plan guardado queda obsoleto. Después generarás, revisarás y aplicarás un plan nuevo. Este es un flujo de trabajo local con registros persistentes y un punto de entrada de ejecución suministrado; demuestra la admisión basada en revisión y la coherencia del estado, sin afirmar resistencia a la manipulación por administradores.

Debes conocer los artefactos de planes guardados, las pruebas de módulos, la selección de revisiones de Git, el bloqueo del estado de Terraform y los entornos separados. Este laboratorio comienza de forma independiente con almacenes de informes existentes y una propuesta de código fuente preparada; no reutiliza ninguna VM anterior.

Relación con las certificaciones

Certificación Tarea del examen Práctica
DevOps Engineer – Professional (DOP-C02) Tarea 1.3 Práctica básica del ciclo de vida de artefactos: revisar un plan guardado concreto, utilizar ese artefacto y gestionar su invalidación tras un cambio de estado.

Un plan concreto se vincula con una revisión antes de su aplicación controlada; se rechazan los artefactos sin revisar y los obsoletos.

Prepara artefactos específicos antes de la revisión

En este paso, crearás dos planes guardados a partir de la misma propuesta registrada en un commit y demostrarás que un plan sin revisar no puede superar el punto de entrada de aplicación suministrado.

Entra en el repositorio preparado y carga sus herramientas.

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

Lee la propuesta, las etapas de calidad y el historial reciente.

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

La propuesta preparada solicita release-two y release two report. Los almacenes actuales de preview y review todavía contienen release one report. Sus archivos de estado son independientes. El objeto vecino delivery-release-neighbor/keep.txt contiene datos ajenos que deben conservarse. Mantén intactos el módulo, el proveedor, el archivo de bloqueo, las pruebas, los ejecutores y las etapas de calidad suministrados.

Registra el identificador completo del commit que pretendes publicar. El archivo de selección contiene información de la solicitud sin seguimiento de Git; los comandos posteriores usan su contenido en lugar de seguir un HEAD que puede avanzar.

git rev-parse HEAD > selected-revision.txt

Genera el primer artefacto de vista previa. La sustitución de comandos introduce el commit seleccionado en --revision; --environment preview selecciona explícitamente el destino.

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

Deben superarse fmt, validate y las pruebas en modo de planificación, seguidos de un plan nativo con dos actualizaciones y sin creaciones ni eliminaciones. El código de salida nativo 2 del plan significa que hay cambios; el comando de entrega devuelve 0 porque ha producido correctamente el artefacto.

Genera un segundo artefacto para el mismo código fuente y el estado actual. Su nombre independiente representa un plan que se retrasará mientras otra ejecución aprobada continúa.

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

Ambos planes proponen actualmente la misma versión. Cada uno tiene su propio plan binario, vistas legible y JSON y contexto registrado. Ninguno se ha aplicado.

Intenta usar el primer plan mediante el punto de entrada de aplicación antes de revisarlo. Este comando devuelve intencionadamente el código de salida 1.

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

Debes ver No matching review of this concrete artifact. El resultado registra native_exit: null: la admisión se detuvo antes de ejecutar un comando apply de Terraform. Esto es distinto de un fallo nativo de Terraform. La existencia de un plan no concede aprobación.

Lee el informe actual de vista previa.

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

Debe seguir diciendo release one report. Ambos planes y la solicitud rechazada han dejado el entorno de negocio sin cambios.

Revisa y aplica el plan concreto

En este paso, revisarás las acciones reales propuestas y registrarás la aprobación de los artefactos exactos. La revisión persiste entre los distintos comandos de entrega.

Inspecciona el primer plan.

python3 delivery.py inspect release-two

Confirma que el plan guardado tiene como destino delivery-release-preview, actualiza la etiqueta de versión y el contenido del informe a los valores solicitados y no contiene creaciones ni eliminaciones. Su revisión debe coincidir con selected-revision.txt; las huellas del código fuente, del archivo de bloqueo y del plan binario identifican el objeto concreto de revisión.

Registra la revisión usando el mismo artefacto, revisión de código y entorno.

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

Debes ver review_recorded: true. Esto registra una decisión del flujo de trabajo local; no es una operación sobre recursos de Terraform. Una revisión de código fuente diferente, otro entorno o un artefacto modificado no coincidirían con esta revisión.

Inspecciona el artefacto retrasado como un objeto de revisión independiente. Confirma la misma revisión de código solicitada, el entorno de vista previa y las dos actualizaciones previstas.

python3 delivery.py inspect delayed-two

Registra su propia revisión. Una propuesta coincidente no hace que los registros de los dos artefactos sean intercambiables.

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

Aplica únicamente el primer artefacto.

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

El punto de entrada vuelve a comprobar el contexto seleccionado, los bytes exactos del artefacto y la revisión persistida coincidente y, después, invoca Terraform nativo sobre el plan binario guardado. Su bloqueo de escritura suministrado serializa las escrituras de este flujo de trabajo, mientras Terraform gestiona el bloqueo del estado del backend. Debes obtener un código de salida nativo 0 de apply y dos recursos modificados. El comando utiliza la propuesta guardada en lugar de generar silenciosamente otro plan.

Lee el informe realmente desplegado.

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

Ahora debe decir release two report. Inspecciona también las etiquetas reales del bucket.

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

Debes ver Environment=preview y Release=release-two. Los datos almacenados y las etiquetas demuestran que cambió el entorno previsto; que un comando termine correctamente no establecería por sí solo ese resultado.

Rechaza el plan obsoleto y revisa uno nuevo

En este paso, observarás por qué una aprobación por sí sola no puede hacer que un plan guardado esté actualizado. La primera aplicación hizo avanzar el estado de vista previa después de generar ambos planes. El plan retrasado conserva su instantánea original del estado, aunque su código fuente y su revisión de aprobación sigan coincidiendo.

Intenta aplicar el artefacto retrasado ya revisado. Este comando devuelve intencionadamente el código de salida 1.

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

Debes ver el diagnóstico real de Terraform Saved plan is stale y el código de salida nativo 1. Esta vez el flujo de trabajo admitió el artefacto revisado coincidente, pero Terraform nativo rechazó su contexto de estado obsoleto. La versión ya completada debe permanecer intacta. No reescribas el estado ni elimines el archivo de estado para eludir este rechazo.

Genera un artefacto nuevo con el estado actual, manteniendo el mismo código fuente y entorno seleccionados explícitamente.

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

Debes obtener un artefacto correcto con código de salida nativo 0 del plan: la versión solicitada ya está desplegada. La ausencia de cambios es un resultado válido, distinto de un error de ejecución. Un artefacto nuevo sigue necesitando su propia revisión.

Inspecciona la propuesta regenerada y su contexto.

python3 delivery.py inspect release-current

Confirma que no describe cambios y sigue identificando la revisión de código elegida y el entorno de vista previa. Su plan concreto y su registro de generación son distintos de los del antiguo artefacto retrasado.

Revisa este artefacto nuevo.

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

Aplícalo mediante el mismo punto de entrada.

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

Debes obtener un código de salida nativo 0 de apply sin cambios de recursos. La revisión está vinculada a un artefacto; no es un permiso general para aplicar cualquier plan posterior. La comprobación de planes obsoletos de Terraform se refiere a su estado registrado y no demuestra que nada haya cambiado fuera de Terraform; el siguiente laboratorio introduce un flujo de observación independiente.

Confirma que se conserva el informe actual de vista previa.

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

Debes ver release two report. Comprueba el entorno vecino.

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

Debe seguir diciendo release one report. Por último, lee los datos ajenos.

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

Debes ver preserve release neighbor. Has actualizado un almacén existente y creado artefactos locales, sin crear un conjunto de recursos de nube independiente. Conserva la versión desplegada, ambos archivos de estado existentes y los recursos vecinos para la evaluación.

Resumen

Has separado la planificación, la revisión y la aplicación; rechazado una solicitud sin revisar y verificado los cambios reales del informe y las etiquetas tras utilizar un plan binario revisado. Después, un segundo plan revisado no superó la comprobación nativa de plan obsoleto de Terraform al haber avanzado el estado. Has generado, inspeccionado y revisado un artefacto nuevo sin cambios antes de aplicarlo correctamente, conservando el otro entorno y los datos ajenos.

Este flujo de trabajo vincula una revisión local con el contexto exacto del artefacto y delega las comprobaciones de vigencia del estado en Terraform nativo. No convierte una aprobación en una autorización general para artefactos nuevos. Consulta la referencia oficial de aplicación de planes guardados para conocer la operación de Terraform utilizada por el punto de entrada suministrado.