Install the CodeDeploy agent for Amazon Linux or RHEL - Amazon CodeDeploy
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Install the CodeDeploy agent for Amazon Linux or RHEL

Sign in to the instance, and run the following commands, one at a time. Running the command sudo yum update first is considered best practice when using yum to install packages, but you can skip it if you do not wish to update all of your packages.

sudo yum update
sudo yum install ruby
sudo yum install wget

(Optional) To clean the AMI of any previous agent caching information, run the following script:

#!/bin/bash CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent" $CODEDEPLOY_BIN stop yum erase codedeploy-agent -y

Change to your home directory:

cd /home/ec2-user

In the previous command, /home/ec2-user represents the default user name for an Amazon Linux or RHEL Amazon EC2 instance. If your instance was created using a custom AMI, the AMI owner might have specified a different default user name.

Download the CodeDeploy agent installer:

For the China (Beijing) Region:

  • wget

For the China (Ningxia) Region:

  • wget

For example:

For a list of bucket names and region identifiers, see Resource kit bucket names by Region.

Set execute permissions on the install file:

chmod +x ./install

To install the latest version of the CodeDeploy agent:

  • sudo ./install auto

To install a specific version of the CodeDeploy agent:

  • List the available versions in your region:

    aws s3 ls s3://aws-codedeploy-region-identifier/releases/ | grep '\.rpm$'
  • Install one of the versions:

    sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm

    The minimum supported version of the CodeDeploy agent is 1.5.0. CodeDeploy agent 1.5.0 is not supported on Amazon Linux 2023.

To check that the service is running, run the following command:

sudo service codedeploy-agent status

If the CodeDeploy agent is installed and running, you should see a message like The AWS CodeDeploy agent is running.

If you see a message like error: No AWS CodeDeploy agent running, start the service and run the following two commands, one at a time:

sudo service codedeploy-agent start
sudo service codedeploy-agent status