feat(ecr-assets): add support for docker build context by cogwirrel · Pull Request #36930 · aws/aws-cdk

cogwirrel · 2026-02-10T06:09:18Z

Issue # (if applicable)

Reason for this change

Add support for docker's --build-context flag in docker builds. This is useful for a few reasons outlined in the linked issue (and other similar issues), such as:

Sharing files from directories outside the Docker build directory
Using specific image versions as build contexts (docker-image://alpine:latest)
Referencing remote URLs as build contexts

Description of changes

Adds support for Docker's --build-context flag when building Docker image assets. This allows users to specify additional named build contexts that can be referenced in Dockerfiles via COPY --from=<name>.

Added buildContexts (optional Record<string, string>) to DockerBuildOptions, DockerImageAssetOptions, DockerImageAssetInvalidationOptions, and DockerImageAssetSource
Updated DockerImage.fromBuild() to pass --build-context key=value flags to the docker build command
Wired buildContexts through the full asset pipeline: DockerImageAsset → synthesizer → asset manifest → cloud assembly schema
Added token validation for buildContexts keys and values (same as buildArgs)
Added buildContexts to asset hash invalidation (controllable via invalidation.buildContexts)
Added ASSET_RESOURCE_METADATA_DOCKER_BUILD_CONTEXTS_KEY metadata constant
Updated the aws-ecr-assets README with documentation and usage example

In terms of design decisions, this follows the same pattern as buildArgs.

The necessary changes to the CLI have been released: aws/aws-cdk-cli#1128

Describe any new or updated permissions being added

N/A

Description of how you validated changes

Integration test

Checklist

My code adheres to the CONTRIBUTING GUIDE and DESIGN GUIDELINES

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

aws-cdk-automation

(This review is outdated)

github-actions · 2026-02-10T06:11:45Z

⚠️ Experimental Feature: This security report is currently in experimental phase. Results may include false positives and the rules are being actively refined.
This security report is NOT a review blocker. Please try merge from main to avoid findings unrelated to the PR.

	Tests	Passed ✅	Skipped	Failed
Security Guardian Results	48 ran	48 passed

Test	Result
No test annotations available

View Security Guardian Results

github-actions · 2026-02-10T06:11:48Z

⚠️ Experimental Feature: This security report is currently in experimental phase. Results may include false positives and the rules are being actively refined.
This security report is NOT a review blocker. Please try merge from main to avoid findings unrelated to the PR.

	Tests	Passed ✅	Skipped	Failed
Security Guardian Results with resolved templates	48 ran	48 passed

Test	Result
No test annotations available

View Security Guardian Results with resolved templates

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

cogwirrel · 2026-02-27T02:07:52Z

aws/aws-cdk-cli#1128 has been merged and released:

Updated this PR to depend on the latest versions.

aws-cdk-automation · 2026-03-03T00:19:31Z

This PR cannot be merged because it has conflicts. Please resolve them. The PR will be considered stale and closed if it remains in an unmergeable state.

aws-cdk-automation · 2026-03-07T00:17:31Z

This PR cannot be merged because it has conflicts. Please resolve them. The PR will be considered stale and closed if it remains in an unmergeable state.

aws-cdk-automation · 2026-03-08T00:17:56Z

This PR cannot be merged because it has conflicts. Please resolve them. The PR will be considered stale and closed if it remains in an unmergeable state.

mrgrain

@cogwirrel Happy with this once the build passes. Thanks for the contribution! Might be easier to split the package updates out into a separate PR. Feel free to ping me internally to move this forward.

…de docker build context (#37350) ### Issue # (if applicable) References #31598 ### Reason for this change Splitting dependency updates out of #36930 ### Description of changes Update the following dependencies: - @aws-cdk/integ-runner: ^2.196.1 -> ^2.197.1 - @aws-cdk/cloud-assembly-api: ^2.1.1 -> ^2.2.0 - @aws-cdk/cloud-assembly-schema: ^52.1.0 -> ^53.0.0 - yarn.lock transitive dependency updates Fix the integration tests due to the update. Details below from our friend Kiro: > The PR that introduced the @aws-cdk/aws-eks:useNativeOidcProvider feature flag is #36589 > This PR added the EKS_USE_NATIVE_OIDC_PROVIDER flag with `recommendedValue: true`. Because it's a recommended flag, it was automatically included in the `@aws-cdk/integ-runner`'s auto-generated `recommended-feature-flags.json` when the integ-runner was built against a version of aws-cdk-lib containing this change. This is why `@aws-cdk/[email protected]` includes the flag but `@aws-cdk/[email protected]` does not — `v2.197.1` was the first integ-runner release built after PR #36589 was merged. ### Describe any new or updated permissions being added None ### Description of how you validated changes #36930 ### Checklist - [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md) ---- *By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Add support for docker's --build-context flag in docker builds. Fixes aws#31598

mergify · 2026-03-25T09:27:23Z

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

mergify · 2026-03-25T09:27:31Z

github-actions · 2026-03-25T09:27:39Z

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.

cogwirrel requested a review from a team as a code owner February 10, 2026 06:09

github-actions bot added effort/medium Medium work item – several days of effort feature-request A feature should be added or improved. p2 beginning-contributor [Pilot] contributed between 0-2 PRs to the CDK labels Feb 10, 2026

aws-cdk-automation requested a review from a team February 10, 2026 06:09

aws-cdk-automation previously requested changes Feb 10, 2026

View reviewed changes

cogwirrel changed the title ~~feat(aws-ecr-assets): add support for docker build context~~ feat(ecr-assets): add support for docker build context Feb 10, 2026

pahud mentioned this pull request Feb 10, 2026

Failed CodeBuild CI - 12 PR(s) pahud/aws-cdk#17

Open

cogwirrel force-pushed the feat/docker-build-context branch from 520b1c1 to 329214b Compare February 17, 2026 19:51

cogwirrel mentioned this pull request Feb 17, 2026

feat(cdk-assets-lib): support --build-context flag for docker image builds aws/aws-cdk-cli#1128

Merged

cogwirrel force-pushed the feat/docker-build-context branch from 1b3bd62 to a60f41a Compare February 18, 2026 00:58

cogwirrel force-pushed the feat/docker-build-context branch from a60f41a to 24a6f37 Compare February 27, 2026 02:04

cogwirrel force-pushed the feat/docker-build-context branch 2 times, most recently from aad409c to 91f648b Compare February 27, 2026 05:11

pahud mentioned this pull request Mar 2, 2026

PRs with Conflicts - 6 PR(s) pahud/aws-cdk#13

Open

cogwirrel force-pushed the feat/docker-build-context branch from 91f648b to 9ebaa8e Compare March 3, 2026 11:19

cogwirrel temporarily deployed to automation March 3, 2026 11:19 — with GitHub Actions Inactive

cogwirrel force-pushed the feat/docker-build-context branch from 9ebaa8e to 2689219 Compare March 8, 2026 23:34

cogwirrel temporarily deployed to automation March 8, 2026 23:34 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 10, 2026 23:31 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 16, 2026 02:07 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 16, 2026 23:43 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 18, 2026 18:46 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 18, 2026 18:47 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 18, 2026 19:06 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 22, 2026 02:30 — with GitHub Actions Inactive

cogwirrel temporarily deployed to automation March 23, 2026 22:33 — with GitHub Actions Inactive

mrgrain reviewed Mar 24, 2026

View reviewed changes

cogwirrel mentioned this pull request Mar 25, 2026

chore(deps): update integ runner and cloud assembly versions to include docker build context #37350

Merged

1 task

feat(aws-ecr-assets): add support for docker build context

6afbb85

Add support for docker's --build-context flag in docker builds. Fixes aws#31598

cogwirrel force-pushed the feat/docker-build-context branch from ae42ed4 to 6afbb85 Compare March 25, 2026 08:36

cogwirrel temporarily deployed to automation March 25, 2026 08:36 — with GitHub Actions Inactive

aws-cdk-automation added the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Mar 25, 2026

aws-cdk-automation temporarily deployed to automation March 25, 2026 09:22 — with GitHub Actions Inactive

aws-cdk-automation temporarily deployed to automation March 25, 2026 09:23 — with GitHub Actions Inactive

mrgrain approved these changes Mar 25, 2026

View reviewed changes

aws-cdk-automation removed the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Mar 25, 2026

aws-cdk-automation temporarily deployed to automation March 25, 2026 09:25 — with GitHub Actions Inactive

mergify bot merged commit c0849ea into aws:main Mar 25, 2026
41 of 42 checks passed

github-actions bot locked as resolved and limited conversation to collaborators Mar 25, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(ecr-assets): add support for docker build context#36930

feat(ecr-assets): add support for docker build context#36930
mergify[bot] merged 1 commit intoaws:mainfrom
cogwirrel:feat/docker-build-context

cogwirrel commented Feb 10, 2026 •

edited

Loading

Uh oh!

aws-cdk-automation left a comment •

edited

Loading

Uh oh!

github-actions bot commented Feb 10, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 10, 2026 •

edited

Loading

Uh oh!

cogwirrel commented Feb 27, 2026

Uh oh!

aws-cdk-automation commented Mar 3, 2026

Uh oh!

aws-cdk-automation commented Mar 7, 2026

Uh oh!

aws-cdk-automation commented Mar 8, 2026

Uh oh!

mrgrain left a comment

Uh oh!

mergify bot commented Mar 25, 2026

Uh oh!

Uh oh!

mergify bot commented Mar 25, 2026

Uh oh!

github-actions bot commented Mar 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

cogwirrel commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue # (if applicable)

Reason for this change

Description of changes

Describe any new or updated permissions being added

Description of how you validated changes

Checklist

Uh oh!

aws-cdk-automation left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cogwirrel commented Feb 27, 2026

Uh oh!

aws-cdk-automation commented Mar 3, 2026

Uh oh!

aws-cdk-automation commented Mar 7, 2026

Uh oh!

aws-cdk-automation commented Mar 8, 2026

Uh oh!

mrgrain left a comment

Choose a reason for hiding this comment

Uh oh!

mergify bot commented Mar 25, 2026

Uh oh!

Uh oh!

mergify bot commented Mar 25, 2026

Merge Queue Status

Uh oh!

github-actions bot commented Mar 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

cogwirrel commented Feb 10, 2026 •

edited

Loading

aws-cdk-automation left a comment •

edited

Loading

github-actions bot commented Feb 10, 2026 •

edited

Loading

github-actions bot commented Feb 10, 2026 •

edited

Loading