Skip to content

index.rst

Latest commit

 

History

History
117 lines (90 loc) · 5.02 KB

index.rst

File metadata and controls

117 lines (90 loc) · 5.02 KB

Welcome

Welcome to the |cdk-long| (|cdk|) User Guide!

The |cdk| is an infrastructure modeling framework that allows you to define your cloud resources using an imperative programming interface. The CDK is currently in developer preview. We look forward to community feedback and collaboration.

To get started see :doc:`getting-started`

screencast.gif

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

Note

Unless otherwise indicated, the code examples in this guide are in TypeScript.

To aid you in porting a TypeScript example to a supported programming language, take a look at the example code for your language in the :doc:`Reference section <reference>`.

The :ref:`AWS CDK Toolkit <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 :doc:`AWS Construct Library <aws-construct-lib>` 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.

Note

There is no charge for using the |cdk|, however you may incur AWS charges for creating or using AWS chargeable resources, such as running |EC2| instances or using |S3| storage. Use the AWS Simple Monthly Calculator to estimate charges for the use of various AWS resources.

Additional Documentation and Resources

In addition to this guide, the following are other resources available to |cdk| users:

About Amazon Web Services

Amazon Web Services (AWS) is a collection of digital infrastructure services that developers can leverage when developing their applications. The services include computing, storage, database, and application synchronization (messaging and queuing).

AWS uses a pay-as-you-go service model. You are charged only for the services that you |mdash| or your applications |mdash| use. Also, to make AWS useful as a platform for prototyping and experimentation, AWS offers a free usage tier, in which services are free below a certain level of usage. For more information about AWS costs and the free usage tier, see Test-Driving AWS in the Free Usage Tier.

To obtain an AWS account, go to aws.amazon.com and click :guilabel:`Create an AWS Account`.

.. toctree::
   :maxdepth: 2
   :hidden:

   Getting Started <getting-started>
   Tutorial <tutorial>
   Examples <examples>
   Concepts <concepts>
   AWS Construct Library <aws-construct-lib>
   AWS CloudFormation Library <cloudformation>
   Tools <tools>
   Writing Constructs <writing-constructs>
   Reference <reference>