
## Table of Contents

1. [Introduction](#introduction)
2. [GitHub Repo with Node.js Code](#github-repo-with-nodejs-code)
3. [Register AWS Account](#register-aws-account)
4. [Create Elastic Beanstalk Application Running Node.js](#create-elastic-beanstalk-application-running-nodejs)
5. [Create AWS Pipeline](#create-aws-pipeline)
6. [Config Pipeline with GitHub Repo](#config-pipeline-with-github-repo)
7. [Config Pipeline to Deploy to Elastic Beanstalk](#config-pipeline-to-deploy-to-elastic-beanstalk)
8. [Check-in Code to GitHub](#check-in-code-to-github)
9. [Verify AWS Pipeline Building and Deploy](#verify-aws-pipeline-building-and-deploy)
10. [Conclusion](#conclusion)
11. [What's Next](#whats-next)

## Introduction

This blog will show how to use AWS CodePipeline to automate building and
deploying code from a GitHub repo. Following are the steps:

- GitHub repo with Node.js code

- Register AWS account

- Create Elastic Beanstalk application running Node.js

- Create AWS Pipeline

- Config Pipeline with GitHub Repo

- Config Pipeline to deploy to Elastic Beanstalk

- Check-in code to GitHub

- Verify AWS Pipeline building and deploy

## GitHub Repo with Node.js Code

You can create your own Node.js app, but in this blog, we'll use the
Node.js app I already created.

sample aws nodejs app

## Register AWS Account

Make sure you have created an AWS account.

## Create Elastic Beanstalk Application Running Node.js

AWS CodePipeline can deploy code to Elastic Beanstalk or other AWS cloud
platforms, but in this blog, we'll set up deployment to Elastic Beanstalk. For
CodePipeline to deploy to Beanstalk, you'll have to create an application.
Since we are deploying a Node.js app, we'll create an Elastic Beanstalk
Node.js app as follows.

![](https://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/mgbhuqkf8ajrx6qcoxxw)

## Create AWS Pipeline

You can go to AWS services to find CodePipeline and create your first AWS
pipeline based on your region. For testing purposes, be aware to only create what you
need.

![](https://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/tdcitv2egkozdipihjqj)

![](https://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/timchvl1lrv3ih5bmrsp)

## Config Pipeline with GitHub Repo

Click Connect to GitHub, type your username and password for GitHub. Once
GitHub authentication has passed, your GitHub repo is connected with AWS Code
Pipeline. You'll have to provide which GitHub repo and what branch you want
to set up with AWS CodePipeline.

![](https://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/rtyy4wgwcfbrw43vjafu)

![](https://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/tho2x9w248qhgdnjmbgq)

## Config Pipeline to Deploy to Elastic Beanstalk

After you set up the GitHub repo and branch in AWS Pipeline, you'll set up where to
deploy your code. In this blog, we'll set up deployment to AWS Elastic
Beanstalk as follows. Once you configure deployment to Elastic Beanstalk, whenever
you check in your code to the GitHub repo's target branch, the AWS CodePipeline
build process will kick off. If the build succeeds, the code will deploy to
Elastic Beanstalk.

![](https://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/voh8f9xxnfbpdma7al2e)

## Check-in Code to GitHub

Check in to GitHub just like you normally do. Once you push to the
remote repo, the AWS Pipeline build process will start.

## Verify AWS Pipeline Building and Deploy

If everything works well, once you push code to the GitHub remote repo,
your code will build and deploy to Elastic Beanstalk. However, something
might go wrong during build or deploy. Following are things I noticed when I
set up AWS Pipeline with GitHub.

### buildspec.yml

**buildspec.yml** is an important file for AWS Pipeline to build
and deploy to Elastic Beanstalk. Following is an example. You can
reference the Build Specification Reference for CodeBuild for the full reference.

```
version: 0.2
artifacts:
  files:
    - "**/*"
```

### nodecommand.config

**nodecommand.config** is used by AWS Elastic Beanstalk to
run your app. The following example shows that when deploying to AWS Elastic
Beanstalk, it should run the "npm start" command to start the app. For more detailed
syntax, see the AWS documentation for
nodecommand.config.

```
option_settings:
  aws:elasticbeanstalk:container:nodejs:
    NodeCommand: "npm start"
```

## Conclusion

AWS CodePipeline is very powerful for continuous integration and
continuous deployment. If you set up the master branch for production, once
you check in, AWS will start to build and, if the build succeeds, will deploy to
Elastic Beanstalk. You might also create lower environments — development,
QA, or staging — using AWS Pipeline, if you wish to move all your code base, build,
and deploy to the cloud.

About cost: once you set up the AWS CodePipeline, the cost is one active pipeline at $1/month. AWS will also set up CodeBuild, which is pay-as-you-go.

## What's Next

Now that we know how to use AWS CodePipeline with GitHub, next I'd like to try
other code repos and see if they work with AWS as well. Also, I'd like to try not just a
simple Node.js app, but something with Express.js or Nest.js, or
perhaps deploy a .NET app, React, or ASP.NET application.


This blog shows how to use AWS CodePipeline to automate building and deploying a Node.js app from a GitHub repo to AWS Elastic Beanstalk.

Build and Deploy with AWS CodePipeline


## Table of Contents

1. [Introduction](#introduction)
2. [Create Amazon AWS Account](#create-amazon-aws-account)
3. [Create New Application at Elastic Beanstalk](#create-new-application-at-elastic-beanstalk)
4. [Upload Node.js Application to Elastic Beanstalk](#upload-nodejs-application-to-elastic-beanstalk)
5. [Verify Node.js Application Running at AWS Elastic Beanstalk](#verify-nodejs-application-running-at-aws-elastic-beanstalk)
6. [Conclusion](#conclusion)

## Introduction

The following shows how to deploy a Node.js app to AWS Elastic Beanstalk.

## Create Amazon AWS Account

Registering for Amazon AWS is free, so the first thing you have to do is create an
AWS account. You can use AWS as a free trial for up to a year.

The AWS free trial is not unlimited, so be aware of not creating too many instances
of Elastic Beanstalk.

## Create New Application at Elastic Beanstalk

After you have your AWS account, go to Elastic Beanstalk and create a new application.

At the Select environment tier, choose Web server environment.

![](http://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/yasypoxlexwfgz1dmkr8)

At the base configuration, choose the platform as Node.js.

## Upload Node.js Application to Elastic Beanstalk

You can create your own Node.js app, but in this blog I'll use the one I
already created at my GitHub repo sample-aws-nodejs. For testing, you can just download the aws-deploy.zip file.

Once you upload the aws-deploy.zip to Elastic Beanstalk, AWS Elastic Beanstalk will start building the
solution and deploy it to the AWS server.

### nodecommand.config

The important thing for AWS Elastic Beanstalk to build and deploy your Node.js
app is the **nodecommand.config** file.
**NodeCommand** will tell AWS what command to run when you
upload your code. In my sample code, it'll run `npm start`.

![](http://res.cloudinary.com/keystone-demo/image/upload/c_fit,h_600,q_80,w_900/hfr9gury738okwtqivkg)

## Verify Node.js Application Running at AWS Elastic Beanstalk

Click the URL of the site. If the site is not up, go to the Logs and check the log
to see what error message was logged. That'll help you troubleshoot
your issue.

## Conclusion

Now you know you can simply upload your Node.js app to Elastic Beanstalk and
have it hosted. Elastic Beanstalk handles the provisioning, load balancing, and scaling for you, making it a straightforward way to deploy Node.js applications on AWS.


How to deploy a Node.js app to AWS Elastic Beanstalk.

ElasticBeanstalk

Build and Deploy with AWS CodePipeline

How to Deploy Node.js App to the AWS Elastic Beanstalk