기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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:** | CodeDeploy 에이전트가 Amazon S3에서 와이어 로그를 캡처하고 **:log\_dir:** 설정이 가리키는 위치에 있는 `codedeploy-agent.wire.log`(이)라는 파일에 기록하도록 하려면 `true`(으)로 설정합니다. 와이어 로그를 캡처하는 데 필요한 시간 동안만 **:log\_aws\_wire:**를 `true`(으)로 설정해야 합니다. `codedeploy-agent.wire.log` 파일은 매우 큰 크기로 빠르게 커질 수 있습니다. 이 파일의 유선 로그 출력에는 이 설정이 `true`로 설정된 동안 Amazon S3로 또는 Amazon S3에서 전송된 파일의 일반 텍스트 콘텐츠를 비롯한 민감한 정보가 포함될 수 있습니다. 유선 로그에는 CodeDeploy 배포와 관련된 활동뿐만 아니라 이 설정이 `true`로 설정된 동안 AWS 계정과 연결된 모든 Amazon S3 활동에 대한 정보가 포함됩니다. <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:** | CodeDeploy 에이전트가 인스턴스에서 디버그 메시지 로그 파일을 인쇄하려면 `true`(으)로 설정합니다.<br />기본 설정은 `false`입니다. | 
| **:wait\_between\_runs:** | 보류 중인 배포에 대한 CodeDeploy의 CodeDeploy의 에이전트 폴링 간격(초)입니다.<br />기본 설정은 `1`입니다. | 
| **:on\_premises\_config\_file:** | 온프레미스 인스턴스에서 (Ubuntu Server 및 RHEL의 경우) `codedeploy.onpremises.yml`(이)라는 구성 파일의 대체 위치에 대한 경로 또는 (Windows Server의 경우) `conf.onpremises.yml`(이)라는 구성 파일의 대체 위치에 대한 경로입니다.<br />기본적으로 이러한 파일은 Ubuntu Server 및 RHEL의 경우 `/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml`, Windows Server의 경우 `C:\ProgramData\Amazon\CodeDeploy`\\`conf.onpremises.yml`에 저장됩니다.<br />버전 1.0.1.686 및 이후 버전의 CodeDeploy 에이전트에서 사용할 수 있습니다. | 
| **:proxy\_uri:** | (선택 사항) CodeDeploy 에이전트가 CodeDeploy 작업을 AWS 위해 연결할 HTTP 프록시입니다. `https://user:password@my.proxy:443/path?query`와(과) 유사한 형식을 사용합니다.<br />버전 1.0.1.824 및 이후 버전의 CodeDeploy 에이전트에서 사용할 수 있습니다. | 
| **:max\_revisions:** | (선택 사항) CodeDeploy 에이전트에서 보관하도록 하려는 배포 그룹의 애플리케이션 수정 버전의 개수입니다. 지정된 수를 초과하는 수정 버전은 모두 삭제됩니다.<br />양수 정수를 입력합니다. 값을 지정하지 않으면 CodeDeploy는 현재 배포된 수정 이외에 최근 수정 5개를 보유합니다.<br />버전 1.0.1.966 이상 버전의 CodeDeploy 에이전트에서 지원됩니다. | 
| **:enable\_auth\_policy:** | (선택 사항) [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`이어야 합니다.<br />기본 설정은 `false`입니다. | 
| **:disable\_imds\_v1:** | 이 설정은 CodeDeploy 에이전트 1.7.0 이상에서 사용할 수 있습니다.<br />IMDSv2 오류 발생 시 IMDSv1으로의 대체 기능을 비활성화하려면 `true`로 설정합니다. 기본값은 `false`입니다(폴백 활성화). | 

## 관련 주제
<a name="reference-agent-configuration-related-topics"></a>

[CodeDeploy 에이전트 작업](codedeploy-agent.md)

[CodeDeploy 에이전트 작업 관리](codedeploy-agent-operations.md)