翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 からワイヤログをキャプチャし、**:log\$1dir:** 設定で指定された場所にある `codedeploy-agent.wire.log` という名前のファイルに書き込みます。  ワイヤログの取得に必要な時間のみ、**:log\$1aws\$1wire:** を `true` に設定する必要があります。`codedeploy-agent.wire.log` ファイルは非常に大きなサイズになる場合があります。このファイルのワイヤログ出力には、この設定が `true` に設定されている間に Amazon S3 との間で転送されたファイルのプレーンテキストの内容などの重要情報が含まれている場合があります。ワイヤログには、CodeDeploy デプロイに関連するアクティビティだけでなく、この設定が AWS に設定されている間に `true` アカウントに関連付けられていたすべての Amazon S3 アクティビティに関する情報が含まれます。  デフォルトの設定は`false` です。 この設定は、すべてのインスタンスタイプに適用されます。この設定を使用できるようにするには、この設定を Windows サーバーインスタンスに追加する必要があります。  | 
|  **: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:**  | CodeDeploy エージェントでインスタンスのデバッグメッセージログファイルを表示する場合は、`true` に設定します。 デフォルトの設定は`false` です。 | 
|  **:wait\$1between\$1runs:**  | 保留中のデプロイに対する CodeDeploy エージェントによる CodeDeploy のポーリング間隔 (秒単位)。 デフォルトの設定は`1` です。 | 
|  **:on\$1premises\$1config\$1file:**  | オンプレミスインスタンスの場合、`codedeploy.onpremises.yml` ( Ubuntu Server および RHEL の場合)、または `conf.onpremises.yml` (Windows Server の場合) という名前の設定ファイルの別の場所へのパスです。デフォルトでは、これらのファイルは Ubuntu Server および RHEL の場合は `/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml`、 Windows Server の場合は `C:\ProgramData\Amazon\CodeDeploy``conf.onpremises.yml` に保存されます。 バージョン 1.0.1.686 以降のバージョンの CodeDeploy エージェントで利用できます。  | 
|  **:proxy\$1uri:**  |  (オプション) CodeDeploy オペレーション用に エージェントが AWS に接続するために経由する HTTP プロキシ。`https://user:password@my.proxy:443/path?query` のような形式を使用します。 バージョン 1.0.1.824 以降のバージョンの CodeDeploy エージェントで利用できます。  | 
|  **:max\$1revisions:**  |  (オプション) CodeDeploy エージェントでアーカイブするデプロイグループ用のアプリケーションリビジョンの数。指定された数を超えるリビジョンは削除されます。 正の整数を入力します。値を指定しない場合、CodeDeploy は現在デプロイされたリビジョンに加えて 5 つの最新のリビジョンを保持します。 バージョン 1.0.1.966 以降のバージョンの CodeDeploy エージェント でサポートされます。  | 
|  **:enable\$1auth\$1policy:**  |  (オプション) [IAM 認可](https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-authorization) を使用して、アクセスコントロールを設定し、CodeDeploy エージェントが使用している IAM ロールまたはユーザーのアクセス許可を制限する場合に `true` に設定します。[Amazon Virtual Private Cloud で CodeDeploy を使用](vpc-endpoints.md) にするには、この値は、`true` である必要があります。 デフォルトの設定は`false` です。  | 
|  **:disable\$1imds\$1v1:**  |  この設定は、CodeDeploy エージェント 1.7.0 以降で使用できます。 IMDSv2 エラーが発生したときに IMDSv1 へのフォールバックを無効にするには、`true` に設定します。デフォルトは `false` です (フォールバックを有効にします）。 | 

## 関連トピック
<a name="reference-agent-configuration-related-topics"></a>

[CodeDeploy エージェントの使用](codedeploy-agent.md)

[CodeDeploy エージェントのオペレーションの管理](codedeploy-agent-operations.md)