lab

lab title

AWS Continuous Integration and Delivery (CI/CD)

V1.01

Course title
BackSpace Academy
AWS Certified Associate
 BackSpace Academy AWS Certified Associate

Table of Contents

Contents

Table of Contents ....................................................................................................................................................... 1

About the Lab ............................................................................................................................................................. 2
NodeJS Application Highly Available and Fault Tolerant Architecture .............................................................. 3
Create the Architecture ........................................................................................................................................ 3
Creating a Continuous Integration and Delivery (CI/CD) Pipeline ..................................................................... 8
Create a GitHub Repository .................................................................................................................................. 8
Creating the Pipeline .......................................................................................................................................... 12
Pushing Updates to our Elastic Beanstalk Environment..................................................................................... 17
Clean Up.............................................................................................................................................................. 20
Integrating CI/CD Build and Test Processes with CodeBuild ........................................................................... 22
Deploy an Elastic Beanstalk Application ............................................................................................................. 22
Fork a GitHub Repository ................................................................................................................................... 23
AWS CodeBuild Files ........................................................................................................................................... 24
Create the CI/CD Pipeline ................................................................................................................................... 25
Clean Up.............................................................................................................................................................. 29

1 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

About the Lab

Please note that not all AWS services are supported in all regions. Please use
the US-East-1 (North Virginia) region for this lab.
These lab notes are to support the hands on instructional videos of the AWS Deployment Services section of the
AWS Certified Associate Course.

Please note that AWS services change on a weekly basis and it is extremely important
you check the version number on this document to ensure you have the lastest version
with any updates or corrections.

Copyright 2017 all rights reserved - BackSpace.Academy 2

 BackSpace Academy AWS Certified Associate

NodeJS Application Highly Available

and Fault Tolerant Architecture

In this section, we will use the Elastic Beanstalk Service to create a highly available and
fault tolerant architecture for deploying our application.

* Please note these notes have been created using the new Elastic Beanstalk console/user interface. You may
need to opt-in to use the new user interface.

Create the Architecture

The simplest and quickest way to get our architecture deployed is using the sample NodeJS application.

3 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Make sure you are in US-East (N. Virginia) region. From the AWS console select “Elastic Beanstalk” from the
Compute services.

Click “Create New Application”

Give your application a name and description.

Click “Create”

Select “Actions” – “Create Environment”

Copyright 2017 all rights reserved - BackSpace.Academy 4

 BackSpace Academy AWS Certified Associate

Select “Web server environment”

Click “Select”

Give your environment a name, domain name and description.

Select “Platform” - “Preconfigured platform” – “Node.js”

Select “Application code” -Sample application”

Click “Configure more options”

5 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Select “Configuration presets” – “High availability”

Scroll down and Click “Create Environment”

Elastic Beanstalk will start creating your environment and displaying log messages

Copyright 2017 all rights reserved - BackSpace.Academy 6

 BackSpace Academy AWS Certified Associate

When the environment has launched you can view the sample application by clicking on the URL

7 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Creating a Continuous Integration

and Delivery (CI/CD) Pipeline

In this section, we will use the CodePipeline Service to create a Continuous Integration
and Continuous Delivery (CI/CD) pipeline our application. We will also create a GitHub
repository to store our code and provide updates to be pushed our AWS environment.

Create a GitHub Repository

If you don’t already have a GitHub account go to github.com and sign up (its free).

Go to github.com and select “New repository” from the “Create” menu on the top right.

Give your repository a name.

Set permission as “private”

Select “Initialize this repository with a README”

Click “Create repository”

Copyright 2017 all rights reserved - BackSpace.Academy 8

 BackSpace Academy AWS Certified Associate

Download the sample NodeJS application from the Elastic Beanstalk documentation page:

http://docs.aws.amazon.com/elasticbeanstalk/latest/dg/samples/nodejs-v1.zip

Unzip the archive and drag and drop the files onto the repository code page.

Scroll down and enter a commit description.

Click “Commit changes”

9 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Your files will now be uploaded.

Click on index.html

Click on the edit icon

Scroll down to line 38 and change the colour from #73A53E to Magenta

Copyright 2017 all rights reserved - BackSpace.Academy 10

 BackSpace Academy AWS Certified Associate

Scroll down and enter a commit description.

Click “Commit changes”

11 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Creating the Pipeline

Make sure you are in US-East (N. Virginia) region. From the AWS console select “CodePipeline” from the
Developer Tools services.

Click “Get Started”

Give your pipeline a name and click “Next Step”

Select “GitHub” as Source Location

Copyright 2017 all rights reserved - BackSpace.Academy 12

 BackSpace Academy AWS Certified Associate

Click “Connect to GitHub”

Click “Authorize aws-codesuite”

*Note this step may force a re-login to the console which may reset your screen. If this occurs go back and start
the pipeline creation process again including “Connect to GitHub”.

Select the GitHub repository you created.

Select master branch

Leave advanced settings as they are and click “Next Step”

13 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Select “No Build” for Build provider.

Click “Next step”

Select “Elastic Beanstalk” for Deployment provider

Select the Elastic Beanstalk application

Select the Elastic Beanstalk environment

Click “Next step”

Copyright 2017 all rights reserved - BackSpace.Academy 14

 BackSpace Academy AWS Certified Associate

Click “Create role”

Click “Allow” to create the role

15 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

You will now be returned to the Code Pipeline console with the new role entered.

Click “Next step”

Review the pipeline and click “Create pipeline”

Copyright 2017 all rights reserved - BackSpace.Academy 16

 BackSpace Academy AWS Certified Associate

Your pipeline has been created.

Pushing Updates to our Elastic Beanstalk Environment

Go back to the Elastic Beanstalk console.

Go to “Application versions” and click refresh to see the new version from your GitHub repository.

17 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Go back to your Elastic Beanstalk environment and click the URL.

You will see the updated version with the Magenta background deployed.

Now go back to GitHub to edit index.html again.

Change the colour at line 38 to Orange.

Copyright 2017 all rights reserved - BackSpace.Academy 18

 BackSpace Academy AWS Certified Associate

Add commit description and click “Commit changes”

If you go back to the Code Pipeline console you will see the change taking effect.

When complete the change will appear in “Staging”

19 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Go back to Elastic Beanstalk and click on the environment URL to see the updated version with the orange
background

Clean Up

Go back to the Code Pipeline console and click “Edit”

Click “Delete”

Copyright 2017 all rights reserved - BackSpace.Academy 20

 BackSpace Academy AWS Certified Associate

Go back to the Elastic Beanstalk console and delete the application.

21 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Integrating CI/CD Build and Test

Processes with CodeBuild

In this section, we will integrate the CodeBuild Service with CodePipeline to create build
and test processes in our Continuous Integration and Continuous Delivery (CI/CD)
pipeline.

Deploy an Elastic Beanstalk Application

Enter details to create a NodeJS application called backspace-aws-codebuild-codepipeline.

Click “Configure more options”

Select “High Availability”

Copyright 2017 all rights reserved - BackSpace.Academy 22

 BackSpace Academy AWS Certified Associate

Click “Create app”

Fork a GitHub Repository

The code for this lab is located in a GitHub repository. We can save time and simply fork a copy of this to your
GitHub account.

Sign in to your GitHub account.

Search for “backspace-academy/aws-nodejs-sample-codebuild”

Click on “Fork” to fork the repository.

23 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

You will now have a forked repository in your account that can be used to deploy the sample code.

AWS CodeBuild Files

The repository contains a modified copy of the AWS NodeJS sample application.

Additional files for AWS CodeBuild include:

test.js – code to test the application before deployment

package.json – modified to include an “npm async” package dependency (so that we have something to build!)

buildspec.yaml (see: Build Specification Reference for AWS CodeBuild)

Copyright 2017 all rights reserved - BackSpace.Academy 24

 BackSpace Academy AWS Certified Associate

• Details build and test commands for CodeBuild

• Install package.json dependencies
• Install Mocha and UnitJS
• Test with Mocha
• Artifacts required for Elastic Beanstalk.

Create the CI/CD Pipeline

Go to the CodePipeline console and create a pipeleline named “backspace-aws-codebuild-codepipeline”

Select GitHub as Source provider.

Connect to GitHub and select the forked repository and master branch.

Click “Next step”

Select “AWS CodeBuild” as the Build provider.

Select “Create a new build project” and name the project

25 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Select “Use an image managed by AWS CodeBuild”

Select “Ubuntu” for Operating system

Select “NodeJS” for Runtime

Select latest NodeJS version

Select “Use the buildspec.yml in the source code root directory”

Select “Create a service role in your account”

Copyright 2017 all rights reserved - BackSpace.Academy 26

 BackSpace Academy AWS Certified Associate

Click “Save Build Project”

After Build project has been saved click “Next step”

Select “AWS Elastic Beanstalk” as Deployment provider.

Select the application and environment created by Elastic Beanstalk.

Click “Next step”

27 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Select the service role created for the previous lab

Click “Next step”

Click “Create pipeline”

Your source will pulled from GitHub:

Your application will then be built and tested by CodeBuild:

Copyright 2017 all rights reserved - BackSpace.Academy 28

 BackSpace Academy AWS Certified Associate

Your application will then be staged:

Go back to the Elastic Beanstalk console to view the updated application.

Clean Up

Go back to the Code Pipeline console and click “Edit”

Click “Delete”

29 Copyright 2017 all rights reserved - BackSpace.Academy

BackSpace Academy AWS Certified Associate

Go back to the Elastic Beanstalk console and delete the application.

Go Back to AWS CodeBuild and delete the project

Copyright 2017 all rights reserved - BackSpace.Academy 30

 BackSpace Academy AWS Certified Associate

31 Copyright 2017 all rights reserved - BackSpace.Academy