CodeBuild projects and buildspec.yml

Exam alignment: DOP-C02 Domain 1 task statements for pipelines, testing, artifacts, or deployment.

Learning objective

Create reproducible build phases, artifacts, reports, and correct failure status.

Difficulty / Schwierigkeitsgrad	Intermediate
Study time / Lernzeit	120 minutes
Prerequisites / Voraussetzungen	Previous lessons in this volume

Professional scenario

Local build commands differ and pipeline packages are inconsistent.

Core concepts

• CodeBuild executes commands in a managed build environment.
• Buildspec YAML defines phases, commands, cache, reports, and artifacts.
• The service role supplies temporary AWS permissions.
• Non-zero command status must represent required failure.

Architecture flow

1. Identify the release input and immutable identity.
2. Select the managed AWS control plane and least-privilege role.
3. Execute build, test, artifact, or deployment work.
4. Collect service events, logs, reports, and runtime metrics.
5. Stop, retry, or roll back according to explicit rules.

Decision matrix

Requirement	Preferred choice	Reason
Versioned build commands	Buildspec in repository	Reviewed with code
AWS access	Service role	Temporary credentials
Required failed test	Non-zero exit	Blocks bad artifact

Failure modes and troubleshooting

• YAML indentation is invalid.
• Artifact file pattern matches nothing.
• A command masks failure with || true.

Security and operations

• Use short-lived service roles and least privilege.
• Encrypt artifacts and protect logs from secret exposure.
• Record changes and approvals for audit.

Hands-on lab

Goal / Ziel: Build, test, and package a small application.

Tasks

1. Create the smallest safe test architecture.
2. Implement or simulate the main workflow.
3. Introduce one controlled failure.
4. Diagnose it from service evidence.
5. Document cleanup and one improvement.

Validation

• The workflow uses an immutable version.
• A required failure blocks promotion.
• The diagnosis identifies the first failed transition.

Cost control / Kostenkontrolle: Keep resources short lived; read cleanup before starting.

Cleanup

1. Delete pipeline/build/deployment resources.
2. Delete temporary artifacts, images, logs, and roles.

Exam traps

• Putting credentials in buildspec.
• Uploading the entire work directory.

Key takeaways

• CodeBuild executes commands in a managed build environment.
• Non-zero command status must represent required failure.
• Decisions must be justified by requirements and failure behavior.

Review questions

1. What is the immutable release identity?
2. Which evidence proves failure or success?
3. What is the safest recovery action?

Answers

1. A version, digest, or uniquely versioned artifact.
2. Service events, logs, reports, health checks, and runtime metrics.
3. Restore the known-good version using the configured rollback path.