Cloud Assembly Schema
This module is part of the AWS Cloud Development Kit project.
Cloud Assembly
The Cloud Assembly is the output of the synthesis operation. It is produced as part of the
cdk synth
command, or the app.synth() method invocation.
Its essentially a set of files and directories, one of which is the manifest.json file. It defines the set of instructions that are
needed in order to deploy the assembly directory.
For example, when
cdk deployis executed, the CLI reads this file and performs its instructions:
- Build container images.
- Upload assets.
- Deploy CloudFormation templates.
Therefore, the assembly is how the CDK class library and CDK CLI (or any other consumer) communicate. To ensure compatibility between the assembly and its consumers, we treat the manifest file as a well defined, versioned schema.
Schema
This module contains the typescript structs that comprise the manifest.json file, as well as the
generated json-schema.
Versioning
The schema version is specified my the major version of the package release. It follows semantic versioning, but with a small twist.
When we add instructions to the assembly, they are reflected in the manifest file and the json-schema accordingly. Every such instruction, is crucial for ensuring the correct deployment behavior. This means that to properly deploy a cloud assembly, consumers must be aware of every such instruction modification.
For this reason, every change to the schema, even though it might not strictly break validation of the json-schema format,
is considered major version bump. All changes that do not impact the schema are considered a minor version bump.
How to consume
If you'd like to consume the schema file in order to do validations on manifest.json files,
simply download it from this repo and run it against standard json-schema validators, such as jsonschema.
Consumers must take into account the major version of the schema they are consuming. They should reject cloud assemblies
with a major version that is higher than what they expect. While schema validation might pass on such assemblies, the deployment integrity
cannot be guaranteed because some instructions will be ignored.
For example, if your consumer was built when the schema version was 2.0.0, you should reject deploying cloud assemblies with a manifest version of 3.0.0.
Contributing
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aws_cdk_cloud_assembly_schema-54.16.0.tar.gz.
File metadata
- Download URL: aws_cdk_cloud_assembly_schema-54.16.0.tar.gz
- Upload date:
- Size: 282.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa311904a7c5b34c40b18f13347ab21eecf951c2826079f6b4186a85e70e4d9f
|
|
| MD5 |
0cddb683eb5066026c87e4841b7cdc9d
|
|
| BLAKE2b-256 |
f333eed551b01f19a4e581f8cfd7585470136e774913bceabcf14c2ef1b79d23
|
Provenance
The following attestation bundles were made for aws_cdk_cloud_assembly_schema-54.16.0.tar.gz:
Publisher:
release.yml on aws/aws-cdk-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aws_cdk_cloud_assembly_schema-54.16.0.tar.gz -
Subject digest:
fa311904a7c5b34c40b18f13347ab21eecf951c2826079f6b4186a85e70e4d9f - Sigstore transparency entry: 2333967353
- Sigstore integration time:
-
Permalink:
aws/aws-cdk-cli@0fa27ff3f0a3a0435dfd40cd503071dce1bc21f0 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/aws
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0fa27ff3f0a3a0435dfd40cd503071dce1bc21f0 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file aws_cdk_cloud_assembly_schema-54.16.0-py3-none-any.whl.
File metadata
- Download URL: aws_cdk_cloud_assembly_schema-54.16.0-py3-none-any.whl
- Upload date:
- Size: 282.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6ae07befea2da93a7602552b88c32c1c0f49efc62a7bec7640c6c2237d9bed8a
|
|
| MD5 |
73c8f75c9388619044550777993728fb
|
|
| BLAKE2b-256 |
349e5d57060ba9722e537146ce276d916cef4cd16ed0f28ff15b249e8eb533f2
|
Provenance
The following attestation bundles were made for aws_cdk_cloud_assembly_schema-54.16.0-py3-none-any.whl:
Publisher:
release.yml on aws/aws-cdk-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aws_cdk_cloud_assembly_schema-54.16.0-py3-none-any.whl -
Subject digest:
6ae07befea2da93a7602552b88c32c1c0f49efc62a7bec7640c6c2237d9bed8a - Sigstore transparency entry: 2333967345
- Sigstore integration time:
-
Permalink:
aws/aws-cdk-cli@0fa27ff3f0a3a0435dfd40cd503071dce1bc21f0 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/aws
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0fa27ff3f0a3a0435dfd40cd503071dce1bc21f0 -
Trigger Event:
workflow_dispatch
-
Statement type:
