---
id: aws-cdk-aws-codebuild
version: "1.204.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-codebuild — The CDK Construct Library for AWS::CodeBuild

License: permissive · Maintenance: active · Downloads: 150.3K/mo

## What it is and what it does

This package provides CDK constructs for defining AWS CodeBuild projects—fully managed continuous integration build environments—as Python code. It allows you to specify build sources (CodeCommit, S3, GitHub, BitBucket), build specifications, artifacts, caching strategies, and CodePipeline integration declaratively within your infrastructure-as-code stack.

The package wraps AWS CodeBuild's API surface into CDK-native classes like Project, PipelineProject, Source, Artifacts, and Cache, letting you configure builds, their inputs, outputs, and execution parameters without writing CloudFormation templates directly. It depends on 20 AWS CDK modules (IAM, EC2, S3, CloudWatch, Logs, KMS, and others) to manage permissions, networking, storage, and observability for your builds.

Use it for:

- Define a CI/CD build project that compiles code and runs tests from a GitHub repository, with artifacts uploaded to S3.
- Set up a CodePipeline action that triggers CodeBuild to run on every commit to a CodeCommit repository.
- Configure S3 or local caching to speed up repeated builds by reusing dependencies and Docker layers.
- Create a build project with no source that runs custom build commands (e.g., data processing or scheduled tasks).
- Integrate CodeBuild with SNS notifications via CodeStar Notifications for build status alerts.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Defines AWS CodeBuild projects and build configurations as infrastructure-as-code constructs for the AWS CDK v1 framework.

No—do not install. This is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer maintained. AWS explicitly recommends migrating to AWS CDK v2. While the package has low install friction and permissive licensing, its end-of-life status and known vulnerability make it unsuitable for new projects. Migrate to the v2 equivalent instead.

## Install

pip install aws-cdk-aws-codebuild
uv add aws-cdk-aws-codebuild
poetry add aws-cdk-aws-codebuild

## Installing aws-cdk.aws-codebuild

Before you install: Low install friction with a wheel distribution. However, this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated; users should migrate to AWS CDK v2 instead.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install aws-cdk.aws-codebuild

import aws_cdk.aws_codebuild as codebuild

project = codebuild.Project(self, "MyProject",
    build_spec=codebuild.BuildSpec.from_object({
        "version": "0.2",
        "phases": {"build": {"commands": ["echo 'Hello, CodeBuild!'"]}}  
    })
)

Requires AWS CDK v1 core library and constructs module; v1 is end-of-support as of 2023-06-01.

Verify before relying:

- Whether the single known vulnerability (GHSA-464c-974j-9xm6) affects this specific version or is already patched.
- Whether migration tooling or documentation exists to help users transition from v1 to v2.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 150.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: 1

## Tags

AWS CodeBuild CDK construct, CI/CD build projects infrastructure, AWS CDK v1 build automation, CodeBuild source and artifacts, managed build environments CDK, buildspec configuration as code, aws-cdk, end-of-life, infrastructure-as-code

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-codebuild) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-codebuild/)