Menu
AWS CodeDeploy
User Guide (API Version 2014-10-06)

Update the AWS CodeDeploy Agent on Windows Server

To enable automatic updates of the AWS CodeDeploy agent whenever a new version is released, install the AWS CodeDeploy agent updater for Windows Server on new or existing instances. The updater will check periodically for new versions. When a new version is detected, the updater will uninstall the current version of the agent, if one is installed, before installing the newest version.

If a deployment is already underway when the updater detects a new version, the deployment will continue to completion; however, if a deployment attempts to start during the update process, the deployment will fail.

If you want to force an update of the AWS CodeDeploy agent, follow the instructions in Install or reinstall the AWS CodeDeploy agent for Windows Server.

On Windows Server instances, you can download and install the AWS CodeDeploy agent updater by running a series of Windows PowerShell commands, using a direct download link, or running an Amazon S3 copy command.

Use Windows PowerShell

Sign in to the instance, and run the following commands in Windows PowerShell, one at a time:

Copy
Set-ExecutionPolicy RemoteSigned
Copy
Import-Module AWSPowerShell
Copy
New-Item –Path "c:\temp" –ItemType "directory" -Force
Copy
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
Copy
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
Copy
powershell.exe -Command Get-Service -Name codedeployagent

bucket-name is the name of the Amazon S3 bucket that contains the AWS CodeDeploy Resource Kit files for your region. For example, for the US East (Ohio) Region, replace bucket-name with aws-codedeploy-us-east-2. For a list of bucket names, see Resource Kit Bucket Names by Region.

If you need to troubleshoot an update process error, type the following command to open the AWS CodeDeploy agent updater log file:

Copy
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log

If the browser security settings on the Windows Server instance provide the necessary permissions (for example, to http://*.s3.amazonaws.com), you can use a direct link to download the AWS CodeDeploy agent updater by entering the following in your browser's address bar and then download and run the installer manually.

Region name Download link

US East (Ohio)

https://aws-codedeploy-us-east-2.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

US East (N. Virginia)

https://aws-codedeploy-us-east-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

US West (N. California)

https://aws-codedeploy-us-west-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

US West (Oregon)

https://aws-codedeploy-us-west-2.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

Canada (Central)

https://aws-codedeploy-ca-central-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

EU (Ireland)

https://aws-codedeploy-eu-west-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

EU (London)

https://aws-codedeploy-eu-west-2.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

EU (Frankfurt)

https://aws-codedeploy-eu-central-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

Asia Pacific (Tokyo)

https://aws-codedeploy-ap-northeast-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

Asia Pacific (Seoul)

https://aws-codedeploy-ap-northeast-2.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

Asia Pacific (Singapore)

https://aws-codedeploy-ap-southeast-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

Asia Pacific (Sydney)

https://aws-codedeploy-ap-southeast-2.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

Asia Pacific (Mumbai)

https://aws-codedeploy-ap-south-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

South America (São Paulo)

https://aws-codedeploy-sa-east-1.s3.amazonaws.com/latest/codedeploy-agent-updater.msi

Use an Amazon S3 copy command

If the AWS CLI is installed on the instance, you can use the Amazon S3 cp command to download the AWS CodeDeploy agent updater and then run the installer manually. For information, see Install the AWS Command Line Interface on Microsoft Windows.

Region name Amazon S3 copy command

US East (Ohio)

Copy
aws s3 cp s3://aws-codedeploy-us-east-2/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

US East (N. Virginia)

Copy
aws s3 cp s3://aws-codedeploy-us-east-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

US West (N. California)

Copy
aws s3 cp s3://aws-codedeploy-us-west-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

US West (Oregon)

Copy
aws s3 cp s3://aws-codedeploy-us-west-2/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

Canada (Central)

Copy
aws s3 cp s3://aws-codedeploy-ca-central-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

EU (Ireland)

Copy
aws s3 cp s3://aws-codedeploy-eu-west-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

EU (London)

Copy
aws s3 cp s3://aws-codedeploy-eu-west-2/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

EU (Frankfurt)

Copy
aws s3 cp s3://aws-codedeploy-eu-central-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

Asia Pacific (Tokyo)

Copy
aws s3 cp s3://aws-codedeploy-ap-northeast-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

Asia Pacific (Seoul)

Copy
aws s3 cp s3://aws-codedeploy-ap-northeast-2/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

Asia Pacific (Singapore)

Copy
aws s3 cp s3://aws-codedeploy-ap-southeast-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

Asia Pacific (Sydney)

Copy
aws s3 cp s3://aws-codedeploy-ap-southeast-2/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

Asia Pacific (Mumbai)

Copy
aws s3 cp s3://aws-codedeploy-ap-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi

South America (São Paulo)

Copy
aws s3 cp s3://aws-codedeploy-sa-east-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi