Skip to content

feat(s3files): alpha package for L2 Constructs - #38435

Open
Adonca2203 wants to merge 1 commit into
aws:mainfrom
Adonca2203:adonca2203/s3files-alpha-l2
Open

feat(s3files): alpha package for L2 Constructs#38435
Adonca2203 wants to merge 1 commit into
aws:mainfrom
Adonca2203:adonca2203/s3files-alpha-l2

Conversation

@Adonca2203

Copy link
Copy Markdown

Issue # (if applicable)

Closes #37568.

Reason for this change

Introduces L2 constructs for AWS S3Files abstracting L1 constructs behind easier to digest and sensible defaults.

Description of changes

Introduced new package @aws-cdk/aws-s3files-alpha which adds L2 Constructs for:

CfnAccessPoint -> s3files.AccessPoint
CfnFileSystem -> s3files.FileSystem
CfnMountTarget -> s3files.MountTarget

AccessPoint: Represents an application-specific view into a file system
FileSystem: Represents the S3Files file system
MountTarget: Represents a mount point for the file system

Alongside unit and integration tests

Describe any new or updated permissions being added

The L2 Constructs create a default role for S3Files if one is not provided. This role is required for S3Files to work properly and is used to grant the file system layer access to the customer's S3 Bucket prefixes, kms keys, and event bridge rules.

Description of how you validated changes

Ran the provided integration tests

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 Jul 28, 2026
@aws-cdk-automation
aws-cdk-automation requested a review from a team July 28, 2026 18:10
@github-actions github-actions Bot added effort/medium Medium work item – several days of effort feature-request A feature should be added or improved. p2 labels Jul 28, 2026

@aws-cdk-automation aws-cdk-automation left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(This review is outdated)

@Adonca2203 Adonca2203 changed the title feat(s3files): Alpha Package for L2 Constructs feat(s3files): alpha package for L2 Constructs Jul 28, 2026
@aws-cdk-automation
aws-cdk-automation dismissed their stale review July 28, 2026 18:15

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

@aws-cdk-automation aws-cdk-automation added the pr/needs-further-review PR requires additional review from our team specialists due to the scope or complexity of changes. label Jul 28, 2026
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from 1faf21b to 512d5c7 Compare July 28, 2026 19:11
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from 512d5c7 to 89146f7 Compare July 28, 2026 20:05
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from 89146f7 to 155d8b9 Compare July 29, 2026 14:29
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from 155d8b9 to c01302c Compare July 29, 2026 14:54
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from c01302c to c091863 Compare July 29, 2026 15:58
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from c091863 to bdd2ed8 Compare July 29, 2026 21:23
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from bdd2ed8 to 3c5c31d Compare July 31, 2026 15:08
@Adonca2203
Adonca2203 requested a review from a team as a code owner August 4, 2026 17:26

@aws-cdk-automation aws-cdk-automation left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(This review is outdated)

Add @aws-cdk/aws-s3files-alpha package with FileSystem and AccessPoint
L2 constructs. Includes VPC mount target management, IAM role automation,
grants facade, resource policies, and integration tests.
@Adonca2203
Adonca2203 force-pushed the adonca2203/s3files-alpha-l2 branch from 4bec28d to ee84592 Compare August 4, 2026 17:38
@aws-cdk-automation
aws-cdk-automation dismissed their stale review August 4, 2026 17:40

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

@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 4, 2026
* Number of days after last access before cached data expires.
* Must be a whole number of days between 1 and 365.
*/
readonly daysAfterLastAccess: Duration;

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the RFC should be dataExpiration any reason to change it ?

importDataRules: config.importDataRules.map(rule => ({
prefix: rule.prefix,
sizeLessThan: rule.sizeLessThan.toBytes(),
trigger: rule.trigger ?? ImportDataRuleTrigger.ON_FILE_ACCESS,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line 100 says that the default is ON_DIRECTORY_FIRST_ACCESS


const basicStack = new BasicFileSystemStack(app, 'S3FilesBasicStack');
const syncConfigStack = new FileSystemWithSyncConfigStack(app, 'S3FilesSyncConfigStack');
const accessPointStack = new FileSystemWithAccessPointStack(app, 'S3FilesAccessPointStack');

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we split this in 3 integ tests, this allows for faster deployment and more clarity

@aws-cdk-automation aws-cdk-automation removed the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Aug 7, 2026
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 effort/medium Medium work item – several days of effort feature-request A feature should be added or improved. p2 pr/needs-further-review PR requires additional review from our team specialists due to the scope or complexity of changes.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

(aws-s3files): Support S3 Files

3 participants