docs(lambda): document bundling image version pinning by fukunaga-kengo · Pull Request #38650 · aws/aws-cdk · GitHub
Skip to content

docs(lambda): document bundling image version pinning - #38650

Open
fukunaga-kengo wants to merge 4 commits into
aws:mainfrom
fukunaga-kengo:fix/issue-38404-document-bundling-image-tags
Open

fukunaga-kengo wants to merge 4 commits into
aws:mainfrom
fukunaga-kengo:fix/issue-38404-document-bundling-image-tags

Conversation

@fukunaga-kengo

@fukunaga-kengo fukunaga-kengo commented Aug 24, 2026 •

Copy link
Copy Markdown
Contributor

Issue # (if applicable)

Closes #38404.

Reason for this change

Predefined Lambda runtimes expose untagged AWS SAM build images. Those images follow the latest published image, so their bundled tool versions can change independently of the AWS CDK version. Users whose builds require a specific tool version need clear guidance on selecting an explicit image tag.

Description of changes

  • Document the untagged/latest behavior on Runtime.bundlingImage.
  • Expand the Lambda README with an explicit Java 21 SAM build image tag example.
  • Recommend choosing a compatible tag and updating pinned images regularly for tool and security updates.
  • Link to the official AWS SAM build image repository documentation.

This is a documentation-only change. It does not pin CDK's predefined runtime images or change any runtime behavior.

Describe any new or updated permissions being added

None.

Description of how you validated changes

  • Ran yarn build --fix in packages/aws-cdk-lib.
  • Ran npx jest aws-lambda/test/runtime.test.ts --runInBand --coverage=false (7 tests passed).
  • Ran strict Rosetta validation for the new README snippet.
  • Ran git diff --check.
  • Integration tests were not run because no executable or CloudFormation behavior changed.

Checklist


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

@github-actions github-actions Bot added the beginning-contributor [Pilot] contributed between 0-2 PRs to the CDK label Aug 24, 2026
@github-actions github-actions Bot added bug This issue is a bug. effort/small Small work item – less than a day of effort p2 labels Aug 24, 2026
@aws-cdk-automation
aws-cdk-automation requested a review from a team August 24, 2026 18:58
@aws-cdk-automation aws-cdk-automation added the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Aug 24, 2026
@aws-cdk-automation aws-cdk-automation added pr/community-review-timeout pr/needs-maintainer-review This PR needs a review from a Core Team Member and removed pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. labels Sep 24, 2026
@maintainer-for-aws

maintainer-for-aws Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

This branch was previously deployed

1 inactive deployment
automation — 6674d783 Deployed Oct 10, 2026 by fukunaga-kengo via validate-pr #371760
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

beginning-contributor [Pilot] contributed between 0-2 PRs to the CDK bug This issue is a bug. effort/small Small work item – less than a day of effort p2 pr/community-review-timeout pr/needs-maintainer-review This PR needs a review from a Core Team Member

Projects

None yet

Development

Successfully merging this pull request may close these issues.

(lambda): lambda.Runtime.JAVA_21.bundlingImage changed from providing Gradle 8.4 to Gradle 9, breaking builds

2 participants