// We need to work around Step numbers here if we are going to potentially exclude the AMI subscription
=== Sign in to your AWS account

. Sign in to your AWS account at https://aws.amazon.com with an IAM user or role that has the necessary permissions. For details, see link:#_planning_the_deployment[Planning the deployment] earlier in this guide.
. Make sure that your AWS account is configured correctly, as discussed in the link:#_technical_requirements[Technical requirements] section.

NOTE: You are responsible for the cost of the AWS services used while running this Quick Start reference deployment. There is no additional cost for using this Quick Start. For full details, see the pricing pages for each AWS service used by this Quick Start. Prices are subject to change.

// Optional based on Marketplace listing. Not to be edited
ifdef::marketplace_subscription[]
=== Subscribe to the {partner-product-short-name} AMI

This Quick Start requires a subscription to the AMI for {partner-product-short-name} in AWS Marketplace.

. Sign in to your AWS account.
. {marketplace_listing_url}[Open the page for the {partner-product-short-name} AMI in AWS Marketplace], and then choose *Continue to Subscribe*.
. Review the terms and conditions for software usage, and then choose *Accept Terms*. +
  A confirmation page loads, and an email confirmation is sent to the account owner. For detailed subscription instructions, see the https://aws.amazon.com/marketplace/help/200799470[AWS Marketplace documentation^].

. When the subscription process is complete, exit out of AWS Marketplace without further action. *Do not* provision the software from AWS Marketplace—the Quick Start deploys the AMI for you.
endif::marketplace_subscription[]
// \Not to be edited

=== Deployment Setup

The {partner-product-short-name} is built with the AWS CDK. If you are unfamiliar with the AWS CDK, thats OK! The CDK makes it easy to stand up infrastructure on AWS with just a few commands. When the time comes for you to to update, extend, or use some of the advanced Blueprint features, the AWS CDK makes it MUCH easier for you control your environments with code over time.

If you want to get get going as fast as possible (< 90 seconds),  https://console.aws.amazon.com/cloudshell[click here to open AWS CloudShell] and run the following commands. It may take ~60 seconds for your first CloudShell session to start.

If you prefer using your own IDE like Cloud9 or VSCode, the following commands should work as well, as long as you have the https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html#getting_started_prerequisites[prerequisites for the AWS CDK] already installed. 

```bash
sudo npm install -g aws-cdk typescript
git clone https://github.com/aws-quickstart/XXXXXXXXXXXX.git
cd quickstart-XXXXXXXXXXXXXXXXX
npm install
cdk bootstrap
npm run build
```

TIP: If you chose to use CloudShell, you can open it again by clicking on it's icon on the AWS Managment Console: image::../images/cloudshell.png[Config,width=100%,height=100%]

=== Deployment

Feel free to review the code and make any changes you see fit. For example, you might want to use different VPC CIDR ranges (`aws-vpcs.ts`) or a different internal DNS apex (`aws-dns.ts` defaults to corp). You don't need to make any modifications if you don't want to.

When you are ready, or when you need update the blueprint's architecture in the future based on changes you make, you just need to run:

```bash 
npm run build && cdk deploy
```

The `cdk deploy` command will give you a summary about IAM related changes about to be deployed and prompt you to acknowledge them. Simply hit 'y' and enter.

The initial deployment should take about ~12 minutes to complete.
