Setup a CDK project

Install the CDK V1

If you are using Cloud9, the CDK is already pre-installed but it will likely be a the CDK V2. Where this workshop was published for AWS CDK V1. Run the following commands from the Cloud9 terminal to remove your current version we will initialize the pipeline with V1 in a bit:

npm uninstall -g cdk

Initialize project

Now, let’s create a folder within our sam-app directory where the pipeline code will reside.

cd ~/environment/sam-app
mkdir pipeline
cd pipeline

Initialize a new CDK project within the pipeline folder by running the following command:

npx aws-cdk@1.x init app --language csharp

You will be prompted to install aws-cdk@1.x, go ahead and accept with y.

Now add an alias as cdk for AWS CDK V1:

alias cdk="npx aws-cdk@1.x"

Now install the CDK modules that we will be using to build a pipeline:

cd src/Pipeline
dotnet restore
dotnet add package Amazon.CDK
dotnet add package Amazon.CDK.AWS.CodeBuild
dotnet add package Amazon.CDK.AWS.CodeCommit
dotnet add package Amazon.CDK.AWS.CodePipeline
dotnet add package Amazon.CDK.AWS.CodePipeline.Actions
dotnet add package Amazon.CDK.AWS.IAM
dotnet add package Amazon.CDK.AWS.S3
dotnet add package Amazon.CDK.Pipelines

Project structure

At this point, your project should have the structure below (only the most relevant files and folders are shown). Within the CDK project, the main file you will be interacting with is the PipelineStack.cs. Don’t worry about the rest of the files for now.

sam-app                             # SAM application root
├── pipeline                        # CDK project root
│   └── src
│       ├── Pipeline
│       │   ├── Pipeline.csproj
│       │   ├── PipelineStack.cs    # Pipeline definition
│       │   └── Program.cs          # Entry point for CDK project
├── samconfig.toml                  # Config file for manual deployments
├── src
│   └── HelloWorld                  # Lambda code
├── template.yaml                   # SAM template
└── test

Modify stack name

Open the Program.cs file, which is your entry point to the CDK project, and change the name of the stack to sam-app-cicd.

CdkEntryPoint

Save the file.