The AWS Cloud Development Kit is a framework for defining cloud infrastructure in code
justinmchase and rix0rrr feat(aws-cdk): directory assets follow symlinks (#1318)
When building a nodejs lambda it is really common for dependencies under the `node_modules` folder to actually be symlink'd to other folders on your system. The symlinks will now be followed and the indicated files packaged (instead of the symlinks themselves).

Fixes #731
Latest commit 2dfd593 Dec 11, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github chore: Specify code owners (#1315) Dec 10, 2018
design feat(docs): add design process description & basic style guide (#1229) Dec 5, 2018
docs feat(aws-cdk): add security impact prompt to 'cdk deploy' (#1240) Dec 10, 2018
examples v0.19.0 (#1281) Dec 4, 2018
packages feat(aws-cdk): directory assets follow symlinks (#1318) Dec 11, 2018
scripts fix(aws-ecs): set permissions for 'awslogs' log driver (#1291) Dec 6, 2018
tools feat(aws-cdk): add security impact prompt to 'cdk deploy' (#1240) Dec 10, 2018
.gitallowed feat(toolkit): add 'cdk context' command (#1169) Nov 15, 2018
.gitattributes chore: tell git that images are binary (#1082) Nov 5, 2018
.gitignore feat: embed construct paths in CloudFormation metadata (#1183) Nov 15, 2018
.travis.yml feat(aws-s3-deployment): bucket deployments (#971) Oct 19, 2018
CHANGELOG.md v0.19.0 (#1281) Dec 4, 2018
CONTRIBUTING.md feat(docs): add design process description & basic style guide (#1229) Dec 5, 2018
LICENSE Change license to Apache-2.0 (#428) Jul 30, 2018
MANUAL_INSTALLATION.md Update README (#433) Jul 31, 2018
NOTICE Change license to Apache-2.0 (#428) Jul 30, 2018
README.md docs: Added logos for supported languages (#1066) Nov 2, 2018
build-docs.sh chore: prepare aws-cdk for auto-publish (#710) Sep 13, 2018
build.sh build: fix-peers and --skip-tests (#1155) Nov 13, 2018
buildspec.yaml chore: prepare aws-cdk for auto-publish (#710) Sep 13, 2018
bump.sh chore: upgrade to jsii 0.7.10 (#1147) Nov 12, 2018
create-missing-libraries.sh feat: update to CloudFormation spec v2.13.0 (#1203) Nov 19, 2018
fetch-dotnet-snk.sh build: fix usage of "-z" in fetch-dotnet-snk.sh (#1010) Oct 25, 2018
git-secrets-scan.sh Add git-secrets check to build Jul 31, 2018
install.sh Remove dependency from toolkit on CDK (#352) Jul 17, 2018
lerna.json v0.19.0 (#1281) Dec 4, 2018
link-all.sh link-all: remove existing node_modules (#511) Aug 6, 2018
pack.sh chore: prepare aws-cdk for auto-publish (#710) Sep 13, 2018
package-lock.json feat(aws-autoscaling): add instance AutoScaling (#1134) Nov 15, 2018
package.json chore: Add rule to guarantee node runtime compatibility (#1205) Nov 19, 2018
screencast.gif Update README (#433) Jul 31, 2018
tslint.yaml chore: update jsii to 0.7.4 (#687) Sep 10, 2018

README.md

AWS Cloud Development Kit (AWS CDK)

Build Status Build Status Version Gitter chat

The AWS Cloud Development Kit (AWS CDK) is an open-source software development framework to define cloud infrastructure in code and provision it through AWS CloudFormation. The CDK integrates fully with AWS services and offers a higher level object-oriented abstraction to define AWS resources imperatively. Using the CDK’s library of infrastructure constructs, you can easily encapsulate AWS best practices in your infrastructure definition and share it without worrying about boilerplate logic. The CDK improves the end-to-end development experience because you get to use the power of modern programming languages to define your AWS infrastructure in a predictable and efficient manner.

The following languages are currently supported:

  • Java
  • JavaScript, TypeScript
  • .NET

The CDK is currently in developer preview and we look forward to community feedback and collaboration!

User Guide | Getting Started | API Reference | Getting Help

Example usage of CDK

Developers can use one of the supported programming languages to define reusable cloud components called constructs, which are composed together into stacks and apps.

The AWS CDK Toolkit is a command-line tool for interacting with CDK apps. It allows developers to synthesize artifacts such as AWS CloudFormation Templates, deploy stacks to development AWS accounts and "diff" against a deployed stack to understand the impact of a code change.

The AWS Construct Library includes a module for each AWS service with constructs that offer rich APIs that encapsulate the details of how to use AWS. The AWS Construct Library aims to reduce the complexity and glue-logic required when integrating various AWS services to achieve your goals on AWS.

Getting Started

Install or update the AWS CDK Toolkit from npm (requires Node.js ≥ 8.11.x):

$ npm i -g aws-cdk

Initialize a project:

$ mkdir hello-cdk
$ cd hello-cdk
$ cdk init app --language=typescript
# or
$ cdk init app --language=java
# more languages (coming soon)...

Use the cdk command-line toolkit to interact with your project:

  • cdk deploy: deploys your app into an AWS account
  • cdk synth: synthesizes an AWS CloudFormation template for your app
  • cdk diff: compares your app with the deployed stack

Read the docs:

$ cdk docs

Getting Help

Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests.

  • Ask a question on Stack Overflow and tag it with aws-cdk
  • Come join the AWS CDK community on Gitter
  • Open a support ticket with AWS Support
  • If it turns out that you may have found a bug, please open an issue

Contributing

We welcome community contributions and pull requests. See CONTRIBUTING for information on how to set up a development environment and submit code.

License

The AWS CDK is distributed under the Apache License, Version 2.0.

See LICENSE and NOTICE for more information.