Building the pipeline with CDK

Author: ferdingler

workshop/content/buildpipe/cdkinit/_index.en.md

@@ -31,4 +31,9 @@ After a few seconds, our new CDK project should look like this:
 
 ![CdkInit](/images/chapter4/screenshot-cdk-init.png)
 
-The main file that you will be interacting with is the `lib/pipeline-stack.ts`. And the entry point of your CDK project is `bin/pipeline.ts`. For this workshop, don't worry about the rest of the files and folders, although if you are curious, feel free to poke around the project structure. 
+
+### Project structure
+The main files that you will be interacting with are _lib/pipeline-stack.ts_ and _bin/pipeline.ts_. Don't worry about the rest of the files and folders for now. Open the `bin/pipeline.ts` file, which is your entry point to the CDK project, and change the name of the stack to `sam-app-cicd`: 
+
+![CdkEntryPoint](/images/chapter4/screenshot-bin-pipeline-ts.png)
+

workshop/content/buildpipe/pipeascode/_index.en.md

@@ -0,0 +1,34 @@
++++
+title = "Pipeline as code"
+date = 2019-11-01T15:26:09-07:00
+weight = 22
++++
+
+Open the file `lib/pipeline-stack.ts` in your Cloud9 workspace. It is empty at the moment, but you will be adding code to describe and build your CI/CD pipeline in the following pages.
+
+![CdkEmptyLib](/images/chapter4/screenshot-cdk-empty.png)
+
+### Build the CDK project
+
+Even though we haven't wrote any code yet, let's get familiar with how to build and deploy a CDK project, as you will be doing it multiple times in this workshop and you should get comfortable with the process. Start by building the project with the following command: 
+
+```
+cd ~/environment/sam-app/pipeline
+npm run build
+```
+
+### Deploy a CDK project
+
+After the build has finished, go ahead and deploy the pipeline project by using the CDK CLI:
+
+```
+cdk deploy
+```
+
+The output should look like the following:
+
+![CdkDeploy](/images/chapter4/screenshot-cdk-deploy.png)
+
+A new CloudFormation stack was created in your account, but because your CDK project is empty, the only resource that was created was an AWS::CDK::Metadata. If you check your [CloudFormation Console](https://console.aws.amazon.com/cloudformation/home), you will see the new stack and the metadata resource. 
+
+![CdkMetadata](/images/chapter4/screenshot-cdk-metadata.png)

workshop/content/buildpipe/pipeascode/bucket/_index.en.md

@@ -0,0 +1,36 @@
++++
+title = "Artifacts Bucket"
+date = 2019-11-01T15:26:09-07:00
+weight = 10
++++
+
+Every Code Pipeline needs an artifacts bucket, also known as Artifact Store. CodePipeline will use this bucket to pass artifacts to the downstream jobs and its also where SAM will upload the artifacts during the build process. 
+
+Let's get started and write the code for creating this bucket:
+
+```js
+// lib/pipeline-stack.ts
+
+import * as cdk from '@aws-cdk/core';
+import s3 = require('@aws-cdk/aws-s3');
+
+export class PipelineStack extends cdk.Stack {
+  constructor(scope: cdk.Construct, id: string, props?: cdk.StackProps) {
+    super(scope, id, props);
+
+    // The code that defines your stack goes here
+    const artifactsBucket = new s3.Bucket(this, "ArtifactsBucket");
+  }
+}
+```
+
+Easy right? Now build and deploy the project like you did it earlier: 
+
+```
+npm run build
+cdk deploy
+```
+
+The output will show that the S3 bucket got created:
+
+![CdkBucket](/images/chapter4/screenshot-cdk-s3-bucket.png)

workshop/content/buildpipe/pipeascode/source/_index.en.md

@@ -0,0 +1,63 @@
++++
+title = "Source Stage"
+date = 2019-11-01T15:26:09-07:00
+weight = 15
++++
+
+The source stage is the first step of any CI/CD pipeline and it represents your source code. This stage is in charge of triggering the pipeline based on new code changes (i.e. git push or pull requests). In this workshop, we will be using AWS CodeCommit as the source provider, but CodePipeline also supports S3, GitHub and Amazon ECR as source providers.
+
+Let's go ahead and add a Source provider to our pipeline:
+
+```js
+// lib/pipeline-stack.ts
+
+import * as cdk from '@aws-cdk/core';
+import s3 = require('@aws-cdk/aws-s3');
+import codecommit = require('@aws-cdk/aws-codecommit');
+import codepipeline = require('@aws-cdk/aws-codepipeline');
+import codepipeline_actions = require('@aws-cdk/aws-codepipeline-actions');
+
+export class PipelineStack extends cdk.Stack {
+  constructor(scope: cdk.Construct, id: string, props?: cdk.StackProps) {
+    super(scope, id, props);
+
+    // The code that defines your stack goes here
+    const artifactsBucket = new s3.Bucket(this, "ArtifactsBucket");
+
+    // Import existing CodeCommit sam-app repository
+    const codeRepo = codecommit.Repository.fromRepositoryName(
+      this,
+      'AppRepository', // Logical name within CloudFormation
+      'sam-app' // Repository name
+    );
+
+    // Pipeline creation starts
+    const pipeline = new codepipeline.Pipeline(this, 'Pipeline', {
+      artifactBucket: artifactsBucket
+    });
+
+    // Declare source code as an artifact
+    const sourceOutput = new codepipeline.Artifact();
+
+    // Add source stage to pipeline
+    pipeline.addStage({
+      stageName: 'Source',
+      actions: [
+        new codepipeline_actions.CodeCommitSourceAction({
+          actionName: 'CodeCommit_Source',
+          repository: codeRepo,
+          output: sourceOutput,
+        }),
+      ],
+    });
+  }
+}
+```
+
+Since we already have the CodeCommit repository, we don't need to create a new one, we just need to import it using the repository name. 
+
+Also notice how we define an object `sourceOutput` as a pipeline artifact; This is necessary for any files that you want CodePipeline to pass to downstream stages. In this case, we want our source code to be passed to the Build stage.
+
+{{% notice info %}}
+Don't do a `cdk deploy` just yet because you will get an error saying that a Pipeline needs to have at least 2 stages to be created. So, let's continue adding the Build stage in the next page.
+{{% /notice%}}

workshop/content/buildpipe/pipeline/_index.en.md

@@ -1,5 +1,5 @@
 +++
-title = "Creating the pipeline"
+title = "How to build a pipeline"
 date = 2019-11-01T15:26:09-07:00
 weight = 20
 +++