Before getting started with the {aws} CDK, complete all prerequisites. These prerequisites are required for those that are new to {aws} or new to programming. For instructions, see {aws} CDK prerequisites.

We recommend that you have a basic understanding of what the {aws} CDK is. For more information, see What is the {aws} CDK? and Learn {aws} CDK core concepts.

Use the Node Package Manager to install the CDK CLI. We recommend that you install it globally using the following command:

To install a specific version of the CDK CLI, use the following command structure:

If you want to use multiple versions of the {aws} CDK, consider installing a matching version of the CDK CLI in individual CDK projects. To do this, remove the -g option from the npm install command. Then, use npx aws-cdk to invoke the CDK CLI. This will run a local version if it exists. Otherwise, the globally installed version will be used.

Troubleshoot a CDK CLI installation

If you get a permission error, and have administrator access on your system, run the following:

$ sudo npm install -g aws-cdk

If you receive an error message, try uninstalling the CDK CLI by running the following:

$ npm uninstall -g aws-cdk

Then, repeat steps to reinstall the CDK CLI.

Run the following command to verify a successful installation. The {aws} CDK CLI should output the version number:

After installing the CDK CLI, you can start using it to develop applications on your local machine. To interact with {aws}, such as deploying applications, you must have security credentials configured on your local machine with permissions to perform any actions that you initiate.

To configure security credentials on your local machine, you use the {aws} CLI. How you configure security credentials depends on how you manage users. For instructions, see Authentication and access credentials in the {aws} Command Line Interface User Guide.

The CDK CLI will automatically use the security credentials that you configure with the {aws} CLI. For example, if you are an IAM Identity Center user, you can use the aws configure sso command to configure security credentials. If you are an IAM user, you can use the aws configure command. The {aws} CLI will guide you through configuring security credentials on your local machine and save the necessary information in your config and credentials files. Then, when you use the CDK CLI, such as deploying an application with cdk deploy, the CDK CLI will use your configured security credentials.

Just like the {aws} CLI, the CDK CLI will use your default profile by default. You can specify a profile using the CDK CLI --profile option. For more information on using security credentials with the CDK CLI, see Configure security credentials for the {aws} CDK CLI.

The {aws} Toolkit for Visual Studio Code is an open source plug-in for Visual Studio Code that helps you create, debug, and deploy applications on {aws}. The toolkit provides an integrated experience for developing {aws} CDK applications. It includes the {aws} CDK Explorer feature to list your {aws} CDK projects and browse the various components of the CDK application. For instructions, see the following:

• Installing the {aws} Toolkit for Visual Studio Code.

• {aws} CDK for VS Code.

You’re now ready to get started with using the {aws} CDK by creating your first CDK app. For instructions, see Tutorial: Create your first {aws} CDK app.

hello-world.adoc