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

# CodeDeploy 代理配置参考
<a name="reference-agent-configuration"></a>

安装 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:** 设置为 `true`。`codedeploy-agent.wire.log` 文件可以快速增长到非常大的大小。此文件中的线路日志输出可能包含敏感信息，包括在此设置设为 `true` 时传入或传出 Amazon S3 的文件的纯文本内容。此设置设置为时，电汇日志包含与 AWS 账户关联的所有 Amazon S3 活动的信息`true`，而不仅仅是与 CodeDeploy 部署相关的活动。 <br />默认设置为 `false`。<br />此设置适用于所有实例类型。您必须将此配置设置添加到 Windows Server 实例才能使用它。 | 
| **:log\_dir:** | 实例上存储与 CodeDeploy 代理操作相关的日志文件的文件夹。<br />对于 Amazon Linux、Ubuntu Server 和 RHEL 实例，默认设置是 `'/var/log/aws/codedeploy-agent'`，对于 Windows Server 实例，默认设置是 `C:\ProgramData\Amazon\CodeDeploy\log`。 | 
| **:pid\_dir:** | 存储 `codedeploy-agent.pid` 的文件夹。<br />此文件包含 CodeDeploy 代理的进程 ID (PID)。默认设置为 `'/opt/codedeploy-agent/state/.pid'`。<br />此设置仅适用于 Amazon Linux、Ubuntu Server 和 RHEL 实例。 | 
| **:program\_name:** |  CodeDeploy 代理程序名称。<br />默认设置为 `codedeploy-agent`。<br />此设置仅适用于 Amazon Linux、Ubuntu Server 和 RHEL 实例。 | 
| **:root\_dir:** | 实例上用于存储相关修订、部署历史记录和部署脚本的文件夹。<br />对于 Amazon Linux、Ubuntu Server 和 RHEL 实例，默认设置是 `/opt/codedeploy-agent/deployment-root`，对于 Windows Server 实例，默认设置是 `C:\ProgramData\Amazon\CodeDeploy`。 | 
| **:verbose:** | 设置`true`为， CodeDeploy 代理可以在实例上打印调试消息日志文件。<br />默认设置为 `false`。 | 
| **:wait\_between\_runs:** |  CodeDeploy 代理轮询待处理部署之间的间隔，以秒 CodeDeploy 为单位。<br />默认设置为 `1`。 | 
| **:on\_premises\_config\_file:** | 对于本地实例，这是名为 `codedeploy.onpremises.yml`（对于 Ubuntu Server 和 RHEL）或 `conf.onpremises.yml`（对于 Windows Server）的配置文件的备用位置的路径。<br />默认情况下，这些文件存储在 `/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml`（对于 Ubuntu Server 和 RHEL）以及 `C:\ProgramData\Amazon\CodeDeploy`\\`conf.onpremises.yml`（对于 Windows Server）中。<br />在 CodeDeploy 代理版本 1.0.1.686 及更高版本中可用。 | 
| **:proxy\_uri:** | （可选）您希望代理通过它连接以 AWS 进行 CodeDeploy 操作的 HTTP CodeDeploy 代理。使用类似于 `https://user:password@my.proxy:443/path?query` 的格式。<br />在 CodeDeploy 代理版本 1.0.1.824 及更高版本中可用。 | 
| **:max\_revisions:** | （可选）您希望 CodeDeploy 代理存档的部署组的应用程序修订数量。超过指定数量的任何修订都将被删除。<br />输入任意正整数。如果未指定任何值，则除了当前部署的修订版外， CodeDeploy 还将保留最新的五个修订版。<br />在 CodeDeploy 代理版本 1.0.1.966 及更高版本中受支持。 | 
| **:enable\_auth\_policy：** | （可选）`true`如果您想使用 [IAM 授权](https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-authorization)来配置访问控制并限制 CodeDeploy 代理正在使用的 IAM 角色或用户的权限，请将其设置为。要[CodeDeploy 与亚马逊 Virtual Private Cloud 配合使用](vpc-endpoints.md)，此值必须是 `true`。<br />默认设置为 `false`。 | 
| **:disable\_imds\_v1:** | 此设置适用于 CodeDeploy 代理 1.7.0 及更高版本。<br />设置`true`为可禁用 IMDSv2错误发生 IMDSv1 时的回退功能。默认为 `false`（启用回退）。 | 

## 相关主题
<a name="reference-agent-configuration-related-topics"></a>

[与 CodeDeploy 代理合作](codedeploy-agent.md)

[管理 CodeDeploy 代理操作](codedeploy-agent-operations.md)