安装适用于 Windows Server 的 CodeDeploy 代理 - AWS CodeDeploy
使用 Systems Manager使用 Windows PowerShell使用直接链接使用 Amazon S3 复制命令

安装适用于 Windows Server 的 CodeDeploy 代理

在 Windows Server 实例上，您可以使用下列方法之一来下载并安装 CodeDeploy 代理：

  • 使用 AWS Systems Manager（推荐）

  • 运行一系列 Windows PowerShell 命令。

  • 选择直接下载链接。

  • 运行 Amazon S3 复制命令。

注意

安装 CodeDeploy 代理的文件夹是 C:\Program Data\Amazon\CodeDeploy。确保此路径上没有目录连接或符号链接。

使用 Systems Manager

按照使用 AWS Systems Manager 安装 CodeDeploy 代理中的说明安装 CodeDeploy 代理。

使用 Windows PowerShell

登录到实例，然后在 Windows PowerShell 中运行以下命令：

  1. 要求从 Internet 下载的所有脚本和配置文件由可信发布者签名。如果系统提示您更改执行策略，请键入“Y”。

     Set-ExecutionPolicy RemoteSigned

  2. 加载 AWS Tools for Windows PowerShell。

    Import-Module AWSPowerShell

  3. 创建目录，将 CodeDeploy 代理安装文件下载到其中。

    New-Item -Path "c:\temp" -ItemType "directory" -Force

  4. 使用 Set-AWSCredential 和 Initialize-AWSDefaultConfiguration 命令配置 AWS 凭证。有关更多信息，请参阅《AWS tools for PowerShell 用户指南》中的使用 AWS 凭证。

  5. 下载 CodeDeploy 代理安装文件。

    注意

    AWS 支持 CodeDeploy 代理的最新次要版本。目前，最新的次要版本是 1.7.x。

    要安装最新版本的 CodeDeploy 代理，请执行以下操作：

    • powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi

    要安装特定版本的 CodeDeploy 代理，请执行以下操作：

    • powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi

    bucket-name 是包含适用于您所在区域的 CodeDeploy 资源工具包文件的 Amazon S3 存储桶的名称。例如，对于美国东部（俄亥俄州）区域，将 bucket-name 替换为 aws-codedeploy-us-east-2。有关存储桶名称的列表，请参阅各区域的资源工具包存储桶名称。

  6. 运行 CodeDeploy 代理安装文件。

    c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt

要检查服务是否正在运行，请运行以下命令：

powershell.exe -Command Get-Service -Name codedeployagent

如果刚刚安装了 CodeDeploy 代理并且未启动，则在运行 Get-Service 命令之后，您应在状态下看到 Start...：


Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service

如果 CodeDeploy 代理已经运行，则在运行 Get-Service 命令之后，您应在状态下看到 Running：


Status     Name                DisplayName
------     ----                -----------
Running    codedeployagent    CodeDeploy Host Agent Service

如果 Windows Server 实例上的浏览器安全设置提供权限（例如，针对 https://s3.*.amazonaws.com 的权限），则您可以使用适用于所在区域的直接链接来下载 CodeDeploy 代理，然后手动运行安装程序。

链接是：

https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi

... 其中 region 是您要部署应用程序的 AWS 区域。

例如：

https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
重要

从与 CodeDeploy 应用程序相同的区域获取 .msi 文件。选择不同的区域可能会导致运行 .msi 文件时 codedeploy-agent-log 文件中出现 inconsistent region 错误。

使用 Amazon S3 复制命令

如果实例上已安装 AWS CLI，则可使用 Amazon S3 cp 命令下载 CodeDeploy 代理，然后手动运行安装程序。有关信息，请参阅在 Microsoft Windows 上安装 AWS Command Line Interface。

Amazon S3 命令是：

aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region

... 其中 region 是您要部署应用程序的 AWS 区域。

例如：

aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1