View a markdown version of this page

Install the CodeDeploy agent for macOS - 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 macOS

Sign in to the instance, and run the following commands, one at a time.

Change to your home directory:

cd ~

Download the CodeDeploy agent installer package:

curl -O https://bucket-name.s3.region-identifier.amazonaws.com.cn/latestv2/codedeploy-agent.aarch64.pkg

bucket-name is the name of the Amazon S3 bucket that contains the CodeDeploy Resource Kit files for your region, and region-identifier is the identifier for your region.

For example:

https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latestv2/codedeploy-agent.aarch64.pkg

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

To install the latest version of the CodeDeploy agent:

  • sudo installer -pkg codedeploy-agent.aarch64.pkg -target /

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/ --region region-identifier | grep '\.pkg$'

  • Download and install one of the versions:

    aws s3 cp s3://aws-codedeploy-region-identifier/releases/codedeploy-agent-version.aarch64.pkg codedeploy-agent.aarch64.pkg --region region-identifier
    sudo installer -pkg codedeploy-agent.aarch64.pkg -target /

    For the latest released version, see Version history of the CodeDeploy agent.

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

sudo /opt/codedeploy-agent/bin/codedeploy-agent status

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

If the agent is not running, start the service and check the status:

sudo launchctl kickstart system/com.amazon.aws.codedeploy-agent
sudo /opt/codedeploy-agent/bin/codedeploy-agent status