Install or reinstall the AWS CodeDeploy agent for Windows Server
On Windows Server instances, you can use one of these methods to download and install the AWS CodeDeploy agent:
-
Run a series of Windows PowerShell commands
-
Choose a direct download link
-
Run an Amazon S3 copy command
Note
On both new and existing instances, we recommend installing the AWS CodeDeploy agent updater for Windows Server. The updater checks periodically for new versions of the agent and installs it when a new version is available. On new instances, you can install the updater instead of the agent, and the current version of the agent will be installed immediately after the updater. For more information, see Update the AWS CodeDeploy Agent on Windows Server.
Use Windows PowerShell
Sign in to the instance, and run the following commands in Windows PowerShell:
-
Require that all scripts and configuration files downloaded from the Internet be signed by a trusted publisher. If you are prompted to change the execution policy, type "
Y."Set-ExecutionPolicy RemoteSigned -
Load the AWS Tools for Windows PowerShell.
Import-Module AWSPowerShell -
Create a directory into where the AWS CodeDeploy agent installation file is downloaded.
New-Item -Path "c:\temp" -ItemType "directory" -Force -
Download the AWS CodeDeploy agent installation file.
powershell.exe -Command Read-S3Object -BucketNamebucket-name-Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi -
Run the AWS CodeDeploy agent installation file.
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txtbucket-nameis the name of the Amazon S3 sds-s3-latest-bucket-name bucket that contains the AWS CodeDeploy Resource Kit files for your region. For example, for the US East (Ohio) Region, replacebucket-namewithaws-codedeploy-us-east-2. For a list of bucket names, see Resource Kit Bucket Names by Region.
To check that the service is running, run the following command:
powershell.exe -Command Get-Service -Name codedeployagent
If the AWS CodeDeploy agent was just installed and has not been started, then after
running
the Get-Service command, under Status, you should
see Start...:
Status Name DisplayName ------ ---- ----------- Start... codedeployagent CodeDeploy Host Agent Service
If the AWS CodeDeploy agent is already running, after running the
Get-Service command, under Status, you should
see Running:
Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service
Use a Direct Link
If the browser security settings on the Windows Server instance
provide the permissions (for example, to http://*.s3.amazonaws.com), you can
use a direct link for your region to download the AWS CodeDeploy agent and then run
the installer
manually.
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 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) |
|
|
US East (N. Virginia) |
|
|
US West (N. California) |
|
|
US West (Oregon) |
|
|
Canada (Central) |
|
|
EU (Ireland) |
|
|
EU (London) |
|
|
EU (Paris) |
|
|
EU (Frankfurt) |
|
|
Asia Pacific (Tokyo) |
|
|
Asia Pacific (Seoul) |
|
|
Asia Pacific (Singapore) |
|
|
Asia Pacific (Sydney) |
|
|
Asia Pacific (Mumbai) |
|
|
South America (São Paulo) |
|
