AWS CodeDeploy - Deploy an Application from GitHub

bogotobogo.com site search:

What is CodeDeploy

In this tutorial, we'll use AWS CodeDeploy to deploy a sample application revision from GitHub to a Red Hat Enterprise Linux (RHEL) instance.

AWS CodeDeploy automates code deployments to Amazon EC2 instances. It deploys applications from Amazon S3 buckets and GitHub repositories.

The following diagram illustrates the flow of a typical AWS CodeDeploy deployment:

Here are the characteristics of CodeDeploy:

Deploys our code to a "fleet" of EC2 instances.
1-10,000s of insances.
Automatically schedules updates (multiple AZs).
Application and Deployment groups described in YAML-formatted files.
Can reference Auto Scaling Group.
AWS Management Console, CLI, or APIs.
Can be used with Check recipes or Puppet scripts.

Upload a Sample Application to GitHub Repository

Get a sample app (SampleApp_Linux.zip) from this link:

Push zip file to Github (CodeDeployGitHubDemo):

$ git add SampleApp_Linux.zip
$ git commit -m "initial commit"
$ git push

Create a Service Role via Console : AWSCodeDeployRole

In the navigation pane, choose "Roles", and then choose "Create New Role". Then, in the Role Name box, give the service role a name ("CodeDeployServiceRole:), and then choose Next Step.

On the Select Role Type page, with AWS Service Roles selected, next to AWS CodeDeploy, choose Select:

On the Attach Policy page, select the box next to the AWSCodeDeployRole policy, and then choose Next Step.

Create an IAM Instance Profile

Our Amazon EC2 instances need permission to access the Amazon S3 buckets or GitHub repositories where the applications that will be deployed by AWS CodeDeploy are stored.

To launch Amazon EC2 instances that are compatible with AWS CodeDeploy, we must create an additional IAM role, an instance profile. This role gives AWS CodeDeploy permission to access the Amazon S3 buckets or GitHub repositories where our applications are stored.

In the IAM console, in the navigation pane, choose Policies, and then choose Create Policy.

Next to Create Your Own Policy, choose Select:

In the Policy Name box, type CodeDeployDemo-EC2-Permissions. In the Policy Document box, paste the following:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "s3:Get*",
        "s3:List*"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Choose Create Policy.

In the navigation pane, choose Roles, and then choose Create New Role.

In the Role Name box, give the IAM instance profile a name like CodeDeployDemo-EC2, and then choose Next Step.

On the Select Role Type page, next to Amazon EC2, choose Select.

On the Attach Policy page, select the box next to CodeDeployDemo-EC2-Permissions:

Then, choose Next Step.

Choose Create Role.

We've now created an IAM instance profile to attach to Amazon EC2 instances.

Launch an RHEL EC2 Instance

Now that we've created an IAM instance profile named CodeDeployDemo-EC2-Instance-Profile, let's launch an instance with an appropriate IAM role:

Next to User data, with the As text option selected, type the following to install the AWS CodeDeploy agent as the Amazon EC2 instance is launched:

#!/bin/bash
sudo yum -y update
sudo yum install -y ruby
curl -O https://bootstrap.pypa.io/get-pip.py
sudo python get-pip.py
sudo pip install awscli
cd /home/ec2-user
sudo aws s3 cp s3://aws-codedeploy-us-west-1/latest/install . --region us-west-1
sudo chmod +x ./install
sudo ./install auto

The rest of the steps remain the same as usual.

Verify the AWS CodeDeploy Agent Is Running

To see if the AWS CodeDeploy agent is installed and running, sign in to the instance, and run the following command:

$ ssh -i bogo.pem ec2-user@54.153.66.39

[ec2-user@ip-172-31-6-89 ~]$ 
[ec2-user@ip-172-31-6-89 ~]$ sudo service codedeploy-agent status
The AWS CodeDeploy agent is running as PID 26896

The AWS CodeDeploy agent is installed and running as we can see from the output message.

Deploy the Application to the Instance

Now we have an instance configured for use in AWS CodeDeploy deployments, and we successfully launched the instance and verified the AWS CodeDeploy agent is running.

In this section, we will use the AWS CodeDeploy console or the AWS CLI to deploy the sample revision from our GitHub repository to the instance.

Our sample revision is a single web page deployed to the instance.

We already have an instance, so click "Skip"

In the Application Name box, type "CodeDeployGitHubDemo-App":

In the Deployment Group Name box, type CodeDeployGitHubDemo-DepGrp:

Click "Deploy Now":

Monitor and Verify the Deployment

We will use the AWS CodeDeploy console to verify the success of the deployment.

We will use our web browser to view the web page that was deployed to the Amazon EC2 instance running RHEL instance.

In the list of deployments, look for the row with an Application value of CodeDeployGitHubDemo-App and a Deployment group value of CodeDeployGitHubDemo-DepGrp.

Since "Succeeded" appears in the Status column, we can now verify the deployment through our web browser. Our sample revision deploys a single web page to the instance.

Go to http://PublicDNS for the instance (for example, http://ec2-01-234-567-890.compute-1.amazonaws.com):