aws-cdk.aws-s3-deployment
Constructs for deploying contents to S3 buckets
Decision gist · record as of 2026-08-14
No—this package is part of AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer maintained. Users should migrate to AWS CDK v2 instead. If you are already on CDK v1 and cannot migrate immediately, it is functional but carries the risk of unpatched vulnerabilities and lack of ongoing support.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires AWS CDK v1 environment and valid AWS credentials configured for deployment.
- Low install friction with pure Python wheels.
- 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 · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.
last release 2023-06-19 (1152 days) · last repo commit 2026-08-14 · 12,868 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 145,598 downloads/mo, #11,123 on PyPI
Alternatives
Verify before relying
pip install aws-cdk.aws-s3-deployment
from aws_cdk import aws_s3 as s3
from aws_cdk.aws_s3_deployment import BucketDeployment, Source
deployment = BucketDeployment(self, "DeployWebsite",
sources=[Source.asset("./website-dist")],
destination_bucket=website_bucket
)- Whether migration path and tooling from CDK v1 to v2 are straightforward for existing deployments.
- Performance characteristics when deploying large numbers of files or multi-gigabyte archives.
What it is and what it does
This package provides a CDK construct that automates uploading and synchronizing file contents to S3 buckets during infrastructure deployment. It accepts sources from local directories, local zip files, other S3 buckets, or inline string/JSON data, and uses a Lambda-backed custom CloudFormation resource to extract and sync the files to a destination bucket with optional pruning and cache-control headers.
The construct handles the intermediate steps of archiving, uploading to a staging assets bucket, and then deploying to the final destination—all declaratively within your CDK stack. It integrates with the broader AWS CDK ecosystem (aws-cdk.aws-s3, aws-cdk.aws-iam, aws-cdk.aws-lambda) and supports dependency ordering via `deployed_bucket` to ensure files are present before dependent resources are created.
Use it for
- Deploy a static website (HTML, CSS, JS) from a local directory to an S3 bucket with web hosting enabled.
- Populate an S3 bucket with application assets during stack deployment without manual upload steps.
- Sync multiple source directories to the same bucket with different cache-control policies using multiple BucketDeployment constructs.
- Reference deployed files in downstream CDK constructs by using `deployment.deployed_bucket` to enforce deployment ordering.
- Deploy configuration or data files from version control to S3 as part of infrastructure provisioning.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—this package is part of AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer maintained.
Users should migrate to AWS CDK v2 instead. If you are already on CDK v1 and cannot migrate immediately, it is functional but carries the risk of unpatched vulnerabilities and lack of ongoing support.
Install
aws-cdk-aws-s3-deployment on PyPI
Before you install
Low install friction with pure Python wheels. 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.
Requires AWS CDK v1 environment and valid AWS credentials configured for deployment.
License in practice
Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.
Quickstart
pip install aws-cdk.aws-s3-deployment
from aws_cdk import aws_s3 as s3
from aws_cdk.aws_s3_deployment import BucketDeployment, Source
deployment = BucketDeployment(self, "DeployWebsite",
sources=[Source.asset("./website-dist")],
destination_bucket=website_bucket
)
Verify before relying
- Whether migration path and tooling from CDK v1 to v2 are straightforward for existing deployments.
- Performance characteristics when deploying large numbers of files or multi-gigabyte archives.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release ~=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 14 packagesaws-cdk.aws-cloudfrontaws-cdk.aws-ec2aws-cdk.aws-efsaws-cdk.aws-iamaws-cdk.aws-lambdaaws-cdk.aws-logsaws-cdk.aws-s3-assetsaws-cdk.aws-s3aws-cdk.coreaws-cdk.lambda-layer-awscliconstructsjsiipublicationtypeguard |
| Maintenance | Actively maintained 1,152 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 145,598 / month, #11,123 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 7 - InactiveFramework :: AWS CDKFramework :: AWS CDK :: 1Intended Audience :: DevelopersLicense :: OSI ApprovedOperating System :: OS IndependentProgramming Language :: JavaScriptProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Typing :: Typed |
Evidence: aws_cdk.aws_s3_deployment-1.204.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “s3 bucket deployment cdk”
- aws-cdk.aws-s3-deploymentDeploys files and directories to AWS S3 buckets as part of AWS CDK…
- aws-cdk.aws-s3-assetsPackages local files and directories for deployment to S3 as part of…
- aws-cdk.aws-s3Defines AWS S3 buckets and related resources as code using the AWS…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also aws-cdk.aws-s3-assets · aws-cdk.aws-s3 · git-remote-s3 · aws-cdk.cx-api · aws-cdk.aws-cloudfront · aws-cdk.aws-codebuild · aws-cdk.aws-ecr-assets · aws-cdk.core · cdk-ecr-deployment · aws-cdk.cloud-assembly-schema