本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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:**  |  將 CodeDeploy 代理程式`true`設定為 ，以從 Amazon S3 擷取線路日誌，並將其寫入 **：log\$1dir：** 設定所指向位置`codedeploy-agent.wire.log`中名為 的檔案。  您只應該針對擷取線路日誌所需時間量，將 **:log\$1aws\$1wire:** 設定為 `true`。`codedeploy-agent.wire.log` 檔案大小可能會變很大。此檔案中的線路日誌輸出可能包含敏感資訊，包括此設定設為 時傳入或傳出 Amazon S3 的檔案純文字內容`true`。線路日誌包含與此設定設定為 時與 AWS 帳戶相關聯的所有 Amazon S3 活動的相關資訊`true`，而不只是與 CodeDeploy 部署相關的活動。  預設設定為 `false`。 此設定適用於所有執行個體類型。您必須將此組態設定新增至 Windows Server 執行個體，才能使用它。  | 
|  **:log\$1dir:**  | 執行個體上的資料夾，其中儲存與 CodeDeploy 代理程式操作相關的日誌檔案。 預設設定`'/var/log/aws/codedeploy-agent'`適用於 Amazon Linux、Ubuntu Server 和 RHEL 執行個體，以及 `C:\ProgramData\Amazon\CodeDeploy\log` Windows Server 執行個體。 | 
|  **: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:**  | 存放執行個體上相關修訂、部署歷史記錄和部署指令碼的資料夾。 預設設定`/opt/codedeploy-agent/deployment-root`適用於 Amazon Linux、Ubuntu Server 和 RHEL 執行個體，以及 `C:\ProgramData\Amazon\CodeDeploy` Windows Server 執行個體。 | 
|  **:verbose:**  | 將 CodeDeploy 代理程式`true`設定為 ，以在執行個體上列印偵錯訊息日誌檔案。 預設設定為 `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` for Ubuntu Server 和 RHEL 以及 `C:\ProgramData\Amazon\CodeDeploy`\$1`conf.onpremises.yml` for Windows Server。 適用於 CodeDeploy 代理程式的 1.0.1.686 版和更新版本。  | 
|  **:proxy\$1uri:**  |  （選用） 您希望 CodeDeploy 代理程式為 CodeDeploy 操作連線 AWS 的 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：**  |  （選用） `true` 如果您想要使用 [ IAM 授權](https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-authorization)來設定存取控制，並限制 CodeDeploy Agent 正在使用之 IAM 角色或使用者的許可，請將 設定為 。若要 [搭配 Amazon Virtual Private Cloud 使用 CodeDeploy](vpc-endpoints.md)，此值必須為 `true`。 預設設定為 `false`。  | 
|  **：disable\$1imds\$1v1：**  |  此設定適用於 CodeDeploy 代理程式 1.7.0 及更新版本。 設定為 `true` 以在發生 IMDSv2 錯誤時停用 IMDSv1 IMDSv2的後援。預設為 `false`（啟用後援）。 | 

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

[使用 CodeDeploy 代理程式](codedeploy-agent.md)

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