CodeDeploy 代理配置参考 - Amazon CodeDeploy
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

CodeDeploy 代理配置参考

安装 CodeDeploy 代理后,将在实例上放置一个配置文件。此配置文件指定 CodeDeploy 与实例交互时使用的目录路径和其他设置。可以更改此文件中的某些配置选项。

对于 Amazon Linux、Ubuntu Server 和 Red Hat Enterprise Linux (RHEL) 实例,配置文件名为 codedeployagent.yml。它放置在 /etc/codedeploy-agent/conf 目录中。

对于 Windows Server 实例,配置文件名为 conf.yml。它放置在 C:\ProgramData\Amazon\CodeDeploy 目录中。

配置设置包括:

:log_aws_wire:

设为 true 表示 CodeDeploy 代理从 Amazon S3 捕获线路日志并将它们写入一个名为 codedeploy-agent.wire.log 的文件,该文件位于 :log_dir: 设置指向的位置。

警告

您仅应在捕获线路日志需要的时间内将 :log_aws_wire: 设置为 truecodedeploy-agent.wire.log 文件可以快速增长到非常大的大小。此文件中的线路日志输出可能包含敏感信息,包括在此设置设为 true 时传入或传出 Amazon S3 的文件的纯文本内容。此设置设为 true 时,线路日志包含有关与 Amazon 账户关联的所有 Amazon S3 活动的信息,而不仅仅包含与 CodeDeploy 部署相关的活动的信息。

默认设置为 false

此设置适用于所有实例类型。您必须将此配置设置添加到 Windows Server 实例才能使用它。

:log_dir:

实例上用于存储与 CodeDeploy 代理操作相关的日志文件的文件夹。

对于 Amazon Linux、Ubuntu Server 和 RHEL 实例,默认设置是 '/var/log/aws/codedeploy-agent',对于 Windows Server 实例,默认设置是 C:\ProgramData\Amazon\CodeDeploy\log

:pid_dir:

存储 codedeploy-agent.pid 的文件夹。

此文件包含 CodeDeploy 代理的进程 ID (PID)。默认设置为 '/opt/codedeploy-agent/state/.pid'

此设置仅适用于 Amazon Linux、Ubuntu Server 和 RHEL 实例。

:program_name:

CodeDeploy 代理程序名称。

默认设置为 codedeploy-agent

此设置仅适用于 Amazon Linux、Ubuntu Server 和 RHEL 实例。

:root_dir:

实例上用于存储相关修订、部署历史记录和部署脚本的文件夹。

对于 Amazon Linux、Ubuntu Server 和 RHEL 实例,默认设置是 /opt/codedeploy-agent/deployment-root,对于 Windows Server 实例,默认设置是 C:\ProgramData\Amazon\CodeDeploy

:verbose:

设为 true 表示 CodeDeploy 代理打印实例上的调试消息日志文件。

默认设置为 false

:wait_between_runs:

CodeDeploy 代理为挂起的部署轮询 CodeDeploy 的时间间隔(以秒为单位)。

默认设置为 1

:on_premises_config_file:

对于本地实例,这是名为 codedeploy.onpremises.yml(对于 Ubuntu Server 和 RHEL)或 conf.onpremises.yml(对于 Windows Server)的配置文件的备用位置的路径。

默认情况下,这些文件存储在 /etc/codedeploy-agent/conf/codedeploy.onpremises.yml(对于 Ubuntu Server 和 RHEL)以及 C:\ProgramData\Amazon\CodeDeploy\conf.onpremises.yml(对于 Windows Server)中。

在 CodeDeploy 代理版本 1.0.1.686 及更高版本中可用。

:proxy_uri:

(可选)您希望 CodeDeploy 代理通过其连接到 Amazon 以执行 CodeDeploy 操作的 HTTP 代理。使用类似于 https://user:password@my.proxy:443/path?query 的格式。

在 CodeDeploy 代理版本 1.0.1.824 及更高版本中可用。

:max_revisions:

(可选)您希望 CodeDeploy 代理存档的部署组的应用程序修订的数量。超过指定数量的任何修订都将被删除。

输入任意正整数。如果不指定任何值,则除了当前部署的修订之外,CodeDeploy 还将保留五个最新修订。

在 CodeDeploy 代理版本 1.0.1.966 及更高版本中受支持。

:enable_auth_policy:

(可选)如果您想使用 IAM 授权来配置访问控制和限制 CodeDeploy 代理正在使用的 IAM 角色或用户的权限,请将其设置为 true。要使用 CodeDeploy 亚马逊 Virtual Private Cloud,此值必须是 true

默认设置为 false

使用 CodeDeploy 代理

管理 CodeDeploy 代理操作