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

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

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

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

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