Введение
Ваша команда хочет изменить хранилище отчётов, но проверяющий должен точно знать, какую конфигурацию и среду представляет план. Имя файла вроде latest.tfplan не устанавливает эту связь.
Вы создадите коммит с небольшим изменением отчёта, сформируете один конкретный сохранённый план и изучите его читаемые изменения, изменения в JSON и отпечатки контекста. Предоставленный исполнитель запускает уже изученные контрольные этапы качества и экспортирует выбранную ревизию Git в отдельный каталог артефакта. Эта лабораторная работа заканчивается до одобрения проверки или применения.
Вы должны понимать состояние Terraform и изоляцию сред, контракты модулей, основы коммитов и diff Git и предыдущие контрольные этапы качества доставки. Каждая лабораторная работа начинается независимо; два существующих хранилища отчётов здесь не перенесены из предыдущей работы.
Связь с сертификацией
| Сертификация | Задача экзамена | Практика |
|---|---|---|
| DevOps Engineer – Professional (DOP-C02) | Задача 1.3 | Базовые знания о создании и прослеживаемости артефактов на примере конкретного локального плана. Интеграция с репозиторием артефактов AWS или сервисом сборки не заявляется. |

Создание коммита с предложением выпуска
На этом шаге вы внесёте небольшое изменение конфигурации и выберете его точную ревизию Git. Сохранённый план должен описывать снимок исходного кода из коммита, а не любые правки, которые позже окажутся в рабочем каталоге.
Перейдите в подготовленный репозиторий и загрузите его инструменты.
cd /home/labex/project/report-release
source environment.sh
Прочитайте предоставленный интерфейс, входные значения выпуска и этапы качества.
cat variables.tf main.tf outputs.tf release.auto.tfvars.json pipeline.json
Этот модуль управляет бакетом и report.txt в каждой среде. preview и review используют отдельные файлы состояния и разные существующие бакеты — delivery-release-preview и delivery-release-review. Оба сейчас содержат release one report. Отдельный delivery-release-neighbor/keep.txt — посторонние данные, которые необходимо сохранить.
release.auto.tfvars.json передаёт метку выпуска и текст отчёта. Terraform загружает этот файл переменных в выбранную конфигурацию. pipeline.json сохраняет форматирование, проверку структуры и тесты модуля в режиме plan; затем предоставленный исполнитель создаёт сохранённый план. Сохраните предоставленные модуль, провайдер, файл фиксации зависимостей, тесты, скрипт окружения и исполнитель. Файл входных значений выпуска — ваше изменение конфигурации в этой лабораторной работе.
Запишите предлагаемый выпуск. Escape-последовательность JSON \n представляет перевод строки в отчёте; here-document с разделителем в кавычках сохраняет эту последовательность при записи файла.
cat > release.auto.tfvars.json <<'EOF'
{
"release": "release-two",
"report": "release two report\n"
}
EOF
Изучите изменение перед его фиксацией. git diff -- сравнивает этот файл с текущей версией в коммите.
git diff -- release.auto.tfvars.json
Diff должен заменять только метку выпуска и содержимое отчёта. Добавьте именно этот файл в индекс.
git add release.auto.tfvars.json
Создайте снимок исходного кода для этого предложения.
git commit -m 'Propose release-two report'
Отдельно запишите его полный идентификатор коммита. git rev-parse HEAD определяет текущий коммит, а > записывает результат в файл. Этот файл выбора не входит в конфигурацию Terraform и должен остаться неотслеживаемым.
git rev-parse HEAD > selected-revision.txt
Прочитайте выбранную ревизию и состояние рабочего дерева.
cat selected-revision.txt
git status --short
Ожидайте полный идентификатор коммита и неотслеживаемый файл выбора. Запись выбора позволяет последующим командам использовать ту же ревизию, даже если репозиторий продвинется вперёд. Допускается корректный явно выбранный более старый коммит; исполнитель не требует, чтобы каждый артефакт использовал последний HEAD.
Создание и изучение конкретного плана
На этом шаге вы превратите выбранный исходный код в артефакт для проверки, не применяя его. Сохранённый двоичный план содержит предлагаемые действия Terraform; читаемое представление и JSON упрощают изучение этих действий.
Создайте именованный артефакт для preview. $(cat selected-revision.txt) подставляет записанный идентификатор коммита в аргумент. --environment выбирает целевые состояние и бакет; они не выводятся из имени файла артефакта.
python3 delivery.py plan report-two --revision "$(cat selected-revision.txt)" --environment preview
Предоставленный рабочий процесс экспортирует этот снимок Git, инициализирует провайдер фиксированной версии с файлом фиксации зависимостей только для чтения, запускает fmt/validate/test, а затем вызывает собственное планирование Terraform с -out и -detailed-exitcode. Ожидайте успешное прохождение всех контрольных этапов качества и план с двумя обновлениями: тега выпуска и содержимого отчёта. Добавлений и удалений быть не должно.
Собственная команда plan Terraform возвращает 2, потому что есть изменения. Охватывающая её команда доставки возвращает 0, потому что успешно создала артефакт. Ошибка Terraform, напротив, приводит к ошибке задания. Имена артефактов уникальны: используйте новое имя для нового создания вместо перезаписи неопределённого «последнего плана».
Изучите артефакт через предоставленную точку входа.
python3 delivery.py inspect report-two
Вывод включает читаемый план Terraform и записанный контекст. Убедитесь, что целевой бакет — delivery-release-preview, новый выпуск — release-two, а отчёт станет release two report. Сводка собственной команды plan должна показывать 0 to add, 2 to change, 0 to destroy. ~ обозначает обновление на месте.
Прочитайте манифест напрямую.
cat /home/labex/project/.delivery-release/artifacts/report-two/manifest.json
Сверьте revision с selected-revision.txt, а environment — с preview. source_sha256 — отпечаток экспортированного отслеживаемого исходного кода, lock_sha256 определяет его точный файл фиксации зависимостей, а plan_sha256 — конкретный двоичный план. Читаемое представление и JSON имеют собственные отпечатки. Эти поля описывают разные части артефакта; одно совпадающее имя файла их не заменяет.
Сравните отпечатки файла фиксации зависимостей и плана с помощью sha256sum, который вычисляет SHA-256 по фактическим байтам файлов.
sha256sum .terraform.lock.hcl /home/labex/project/.delivery-release/artifacts/report-two/release.tfplan
Обе контрольные суммы должны совпадать с соответствующими полями манифеста. Исполнитель также сохраняет запись о создании между процессами и сверяет фактический двоичный план с независимо выбранными исходным кодом и средой. Редактирование манифеста для описания других байтов не делает эти байты корректным артефактом.
Прочитайте машиночитаемые действия. Подготовленный инструмент jq выбирает каждое изменение ресурса и выводит его адрес и список действий из собственного JSON-представления Terraform.
jq '.resource_changes[] | {address, actions: .change.actions}' /home/labex/project/.delivery-release/artifacts/report-two/plan.json
Ожидайте aws_s3_bucket.reports и aws_s3_object.report, оба с действиями update. Этот JSON — машиночитаемое представление сохранённого плана; сам по себе он ничего не применяет. Реальный план может содержать текст отчёта и входные значения конфигурации, поэтому при передаче на проверку обращайтесь с ним как с артефактом, содержащим данные.
Убедитесь, что существующий отчёт preview не изменился.
aws s3 cp s3://delivery-release-preview/report.txt -
В нём по-прежнему должно быть release one report, потому что создание плана не применило предложенное содержимое. Проверьте и другую среду.
aws s3 cp s3://delivery-release-review/report.txt -
Ожидайте тот же исходный отчёт. Наконец прочитайте посторонний соседний объект.
aws s3 cp s3://delivery-release-neighbor/keep.txt -
Ожидайте preserve release neighbor. Вы создали локальный артефакт, а не развёрнутый стек, поэтому новой инфраструктуры для удаления нет. Сохраните эти существующие хранилища, их состояние и артефакт для проверки. В одной из следующих лабораторных работ вводятся отдельные этапы проверки и контролируемого применения.
Резюме
Вы создали коммит с предложением выпуска, выбрали его точную ревизию Git и сформировали конкретный сохранённый план после успешных контрольных этапов качества. Вы изучили читаемые и машиночитаемые действия и сравнили отпечатки исходного кода, файла фиксации зависимостей, среды и плана, в то время как фактические данные отчётов и бизнес-состояние остались без изменений.
Артефакт — конкретное предложение, а не одобрение или применение. Его контекст исходного кода и фактические байты должны оставаться согласованными, когда последующий рабочий процесс проверяет и использует его. О собственных форматах, используемых здесь, читайте в официальной документации по сохранённым планам и справочнике JSON-вывода.



