기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CodeDeploy 에이전트 작업 관리
이 섹션의 지침은 CodeDeploy 에이전트 설치, 제거, 다시 설치 또는 업데이트 방법과 CodeDeploy 에이전트가 실행 중인지 여부를 확인하는 방법을 보여줍니다.
**Topics**
+ [CodeDeploy 에이전트가 실행 중인지 확인](codedeploy-agent-operations-verify.md)
+ [CodeDeploy 에이전트의 버전 확인](codedeploy-agent-operations-version.md)
+ [CodeDeploy 에이전트 설치](codedeploy-agent-operations-install.md)
+ [CodeDeploy 에이전트 업데이트](codedeploy-agent-operations-update.md)
+ [CodeDeploy 에이전트 설치 제거](codedeploy-agent-operations-uninstall.md)
+ [CloudWatch로 CodeDeploy 에이전트 로그 전송](codedeploy-agent-operations-cloudwatch-agent.md)
# CodeDeploy 에이전트가 실행 중인지 확인
이 섹션에서는 인스턴스에서 CodeDeploy 에이전트의 실행이 중지되었다고 의심하는 경우 에이전트를 실행하도록 하는 명령에 대해 설명합니다.
**Topics**
+ [Amazon Linux 또는 RHEL용 CodeDeploy 에이전트가 실행 중인지 확인합니다.](#codedeploy-agent-operations-verify-linux)
+ [Ubuntu Server용 CodeDeploy 에이전트가 실행 중인지 확인](#codedeploy-agent-operations-verify-ubuntu)
+ [Windows Server용 CodeDeploy 에이전트가 실행 중인지 확인](#codedeploy-agent-operations-verify-windows)
## Amazon Linux 또는 RHEL용 CodeDeploy 에이전트가 실행 중인지 확인합니다.
CodeDeploy 에이전트가 설치되고 실행 중인지 확인하려면 인스턴스에 로그인하여 다음 명령을 실행합니다.
```
systemctl status codedeploy-agent
```
명령이 오류를 반환하면 CodeDeploy 에이전트가 설치되지 않은 것입니다. [Amazon Linux 또는 RHEL용 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-linux.md)의 설명에 따라 설치합니다.
CodeDeploy 에이전트가 설치되어 실행 중이면 "`The AWS CodeDeploy agent is running`"와 같은 메시지가 표시되어야 합니다.
"`error: No AWS CodeDeploy agent running`"와 같은 메시지가 표시되면 서비스를 시작하고 다음 두 명령을 한 번에 하나씩 실행합니다.
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
## Ubuntu Server용 CodeDeploy 에이전트가 실행 중인지 확인
CodeDeploy 에이전트가 설치되고 실행 중인지 확인하려면 인스턴스에 로그인하여 다음 명령을 실행합니다.
```
systemctl status codedeploy-agent
```
명령이 오류를 반환하면 CodeDeploy 에이전트가 설치되지 않은 것입니다. [Ubuntu Server용 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-ubuntu.md)의 설명에 따라 설치합니다.
CodeDeploy 에이전트가 설치되어 실행 중이면 "`The AWS CodeDeploy agent is running`"와 같은 메시지가 표시되어야 합니다.
"`error: No AWS CodeDeploy agent running`"와 같은 메시지가 표시되면 서비스를 시작하고 다음 두 명령을 한 번에 하나씩 실행합니다.
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
## Windows Server용 CodeDeploy 에이전트가 실행 중인지 확인
CodeDeploy 에이전트가 설치되고 실행 중인지 확인하려면 인스턴스에 로그인하여 다음 명령을 실행합니다.
```
powershell.exe -Command Get-Service -Name codedeployagent
```
다음과 유사한 출력 화면이 표시되어야 합니다.
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
명령이 오류를 반환하면 CodeDeploy 에이전트가 설치되지 않은 것입니다. [Windows Server용 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-windows.md)의 설명에 따라 설치합니다.
`Status`에 `Running` 이외의 다른 상태가 표시되면 다음 명령을 사용해 서비스를 시작합니다.
```
powershell.exe -Command Start-Service -Name codedeployagent
```
다음 명령을 사용하여 서비스를 시작할 수 있습니다.
```
powershell.exe -Command Restart-Service -Name codedeployagent
```
다음 명령을 사용하여 서비스를 중지할 수 있습니다.
```
powershell.exe -Command Stop-Service -Name codedeployagent
```
# CodeDeploy 에이전트의 버전 확인
인스턴스에서 실행 중인 CodeDeploy 에이전트의 버전은 두 가지 방법으로 확인할 수 있습니다.
먼저, CodeDeploy 에이전트 버전 1.0.1.854부터 인스턴스의 `.version` 파일에서 버전 번호를 확인할 수 있습니다. 다음 표에는 지원되는 각 운영 체제에 대한 위치 및 샘플 버전 문자열이 나와 있습니다.
| 운영 체제 | 파일 위치 | 샘플 에이전트 버전 문자열 |
| --- | --- | --- |
| Amazon Linux 및 Red Hat Enterprise Linux(RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm |
| Ubuntu 서버 | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb |
| Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi |
두 번째로, 인스턴스에서 명령을 실행하여 CodeDeploy 에이전트의 버전을 확인할 수 있습니다.
**Topics**
+ [Amazon Linux 또는 RHEL에서 버전 확인](#codedeploy-agent-operations-version-linux)
+ [Ubuntu Server에서 버전 확인](#codedeploy-agent-operations-version-ubuntu)
+ [Windows Server에서 버전 확인](#codedeploy-agent-operations-version-windows)
## Amazon Linux 또는 RHEL에서 버전 확인
인스턴스에 로그인하여 다음 명령을 실행합니다.
```
sudo yum info codedeploy-agent
```
## Ubuntu Server에서 버전 확인
인스턴스에 로그인하여 다음 명령을 실행합니다.
```
sudo dpkg -s codedeploy-agent
```
## Windows Server에서 버전 확인
인스턴스에 로그인하여 다음 명령을 실행합니다.
```
sc qdescription codedeployagent
```
# CodeDeploy 에이전트 설치
EC2 인스턴스 또는 온프레미스 서버에서 CodeDeploy를 사용하려면 CodeDeploy 에이전트를 먼저 설치해야 합니다. 를 사용하여 CodeDeploy 에이전트를 설치하고 업데이트하는 것이 좋습니다 AWS Systems Manager. Systems Manager에 대한 자세한 내용은 [AWS Systems Manager란 무엇입니까](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)를 참조하세요. 배포 그룹을 생성할 때 콘솔에서 Systems Manager를 사용하여 CodeDeploy 에이전트의 설치 및 예약 업데이트를 설정할 수 있습니다.
명령줄을 사용하여 S3 버킷에서 직접 CodeDeploy 에이전트를 설치할 수도 있습니다.
설치할 권장 버전은 [CodeDeploy 에이전트의 버전 기록](codedeploy-agent.md#codedeploy-agent-version-history) 섹션을 참조하세요.
**Topics**
+ [를 사용하여 CodeDeploy 에이전트 설치 AWS Systems Manager](codedeploy-agent-operations-install-ssm.md)
+ [명령줄을 사용하여 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-cli.md)
# 를 사용하여 CodeDeploy 에이전트 설치 AWS Systems Manager
AWS Management Console 또는를 사용하여 AWS CLI 를 사용하여 Amazon EC2 또는 온프레미스 인스턴스에 CodeDeploy 에이전트를 설치할 수 있습니다 AWS Systems Manager. 특정 버전을 설치하거나 항상 에이전트의 최신 버전을 설치하도록 선택할 수 있습니다. 에 대한 자세한 내용은 [란 AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) 무엇입니까?를 AWS Systems Manager참조하십시오.
CodeDeploy 에이전트를 설치하고 업데이트하는 데 권장되는 방법은를 사용하는 AWS Systems Manager 것입니다. Amazon S3 버킷에서 CodeDeploy 에이전트를 설치할 수도 있습니다. Amazon S3 다운로드 링크 사용에 대한 자세한 내용은 [명령줄을 사용하여 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-cli.md) 섹션을 참조하세요.
**Topics**
+ [사전 조건](#install-codedeploy-agent-prereqs)
+ [CodeDeploy 에이전트 설치](#download-codedeploy-agent-on-EC2-Instance)
## 사전 조건
[CodeDeploy 시작하기](getting-started-codedeploy.md)의 단계에 따라 IAM 권한 및 AWS CLI를 설정합니다.
Systems Manager를 사용하여 온프레미스 서버에 CodeDeploy 에이전트를 설치하는 경우 Amazon EC2 Systems Manager 온프레미스 서버를 등록해야 합니다. 자세한 내용은 *AWS Systems Manager 사용 설명서*의 [하이브리드 환경에서 Systems Manager 설정](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html)을 참조하세요.
## CodeDeploy 에이전트 설치
Systems Manager를 사용하여 CodeDeploy 에이전트를 설치하기 전에 먼저 인스턴스가 Systems Manager에 대해 올바르게 구성되어 있는지 확인해야 합니다.
### SSM 에이전트 설치 또는 업데이트
Amazon EC2 인스턴스에서는 CodeDeploy 에이전트를 사용하려면 해당 인스턴스가 2.3.274.0 이상 버전을 실행하고 있어야 합니다. CodeDeploy 에이전트를 설치하기 전에, 인스턴스에 SSM 에이전트를 업데이트하거나 설치합니다(아직 하지 않은 경우).
SSM 에이전트는에서 제공하는 일부 Amazon EC2 AMIs에 사전 설치되어 제공됩니다 AWS. 자세한 내용은 [SSM 에이전트가 사전 설치된 Amazon Machine Image(AMI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html)를 참조하세요.
**참고**
인스턴스의 운영 체제도 CodeDeploy 에이전트에서 지원되는지 확인합니다. 자세한 내용은 [CodeDeploy 에이전트에서 지원하는 운영 체제](codedeploy-agent.md#codedeploy-agent-supported-operating-systems) 단원을 참조하십시오.
Linux를 실행하는 인스턴스에 SSM 에이전트를 설치하거나 업데이트하는 방법에 대한 자세한 내용은 *AWS Systems Manager 사용 설명서*의 [Linux 인스턴스에 SSM 에이전트 설치 및 구성](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html)을 참조하세요.
Windows Server를 실행하는 인스턴스에 SSM 에이전트를 설치하거나 업데이트하는 방법에 대한 자세한 내용은 *AWS Systems Manager 사용 설명서*의 [Windows 인스턴스에 SSM 에이전트 설치 및 구성](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html)을 참조하세요.
### (선택 사항) Systems Manager 사전 조건 확인
SystemsManager Run Command를 사용하여 CodeDeploy 에이전트를 설치하기 전에 인스턴스가 Systems Manager 최소 요구 사항을 충족하는지 확인하세요. 자세한 내용은 *AWS Systems Manager 사용 설명서*에서 [AWS Systems Manager설정](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html)을 참조하세요.
### CodeDeploy 에이전트 설치
SSM을 사용하여 CodeDeploy를 한 번만 설치하거나, 최신 버전을 계속 설치하도록 일정을 설정할 수 있습니다.
CodeDeploy 에이전트를 설치하려면 배포자를 사용하여 `AWSCodeDeployAgent` 패키지 설치 또는 업데이트의 단계를 따르는 동안 패키지를 선택합니다. [AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html)
# 명령줄을 사용하여 CodeDeploy 에이전트 설치
**참고**
에이전트의 예약된 업데이트를 구성할 수 AWS Systems Manager 있도록를 사용하여 CodeDeploy 에이전트를 설치하는 것이 좋습니다. 자세한 내용은 [를 사용하여 CodeDeploy 에이전트 설치 AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) 단원을 참조하십시오.
명령줄을 사용하여 CodeDeploy 에이전트를 설치하고 실행하는 방법에 대해서는 다음 주제를 참조하세요.
**Topics**
+ [Amazon Linux 또는 RHEL용 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-linux.md)
+ [Ubuntu Server용 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-ubuntu.md)
+ [Windows Server용 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-windows.md)
# Amazon Linux 또는 RHEL용 CodeDeploy 에이전트 설치
인스턴스에 로그인하여 다음 명령을 한 번에 하나씩 실행합니다. `yum`을 사용하여 패키지를 설치할 때 첫 번째 명령인 `sudo yum update`를 먼저 실행하는 것이 가장 좋습니다. 그러나 모든 패키지를 업데이트하지 않으려면 이 명령을 건너뛸 수 있습니다.
```
sudo yum update
```
```
sudo yum install ruby
```
```
sudo yum install wget
```
(선택 사항) 이전 에이전트 캐싱 정보의 AMI를 정리하려면 다음 스크립트를 실행합니다.
```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```
홈 디렉터리로 이동합니다.
```
cd /home/ec2-user
```
**참고**
앞의 명령에서 `/home/ec2-user`는 Amazon Linux 또는 RHEL Amazon EC2 인스턴스의 기본 사용자 이름을 나타냅니다. 사용자 지정 AMI를 사용하여 인스턴스를 만든 경우 AMI 소유자가 다른 기본 사용자 이름을 지정했을 수 있습니다.
CodeDeploy 에이전트 설치 관리자를 다운로드합니다.
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*은 해당 리전의 CodeDeploy 리소스 키트 파일이 포함되어 있는 Amazon S3 버킷의 이름이며, *region-identifier*는 리전의 식별자입니다.
예제:
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
버킷 이름 및 리전 식별자 목록은 [리전별 리소스 키트 버킷 이름](resource-kit.md#resource-kit-bucket-names) 단원을 참조하세요.
`install` 파일에 대한 실행 권한을 설정합니다.
```
chmod +x ./install
```
최신 버전의 CodeDeploy 에이전트를 설치하려면 다음을 수행합니다.
+
```
sudo ./install auto
```
특정 버전의 CodeDeploy 에이전트를 설치하려면 다음을 수행합니다.
+ 해당 리전에서 사용 가능한 버전을 나열합니다.
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
```
+ 다음 버전 중 하나를 설치합니다.
```
sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
```
**참고**
AWS 는 CodeDeploy 에이전트의 최신 마이너 버전을 지원합니다. 현재 최신 마이너 버전은 1.7.x입니다.
서비스가 실행 중인지 확인하려면 다음 명령을 실행합니다.
```
systemctl status codedeploy-agent
```
CodeDeploy 에이전트가 설치되어 실행 중이면 "`The AWS CodeDeploy agent is running`"와 같은 메시지가 표시되어야 합니다.
"`error: No AWS CodeDeploy agent running`"와 같은 메시지가 표시되면 서비스를 시작하고 다음 두 명령을 한 번에 하나씩 실행합니다.
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Ubuntu Server용 CodeDeploy 에이전트 설치
**참고**
에이전트의 예약된 업데이트를 구성할 수 AWS Systems Manager 있도록를 사용하여 CodeDeploy 에이전트를 설치하는 것이 좋습니다. 자세한 내용은 [를 사용하여 CodeDeploy 에이전트 설치 AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) 단원을 참조하십시오.
**Ubuntu Server에 CodeDeploy 에이전트를 설치하려면**
1. 인스턴스에 로그인합니다.
1. 다음 명령을 차례로 입력합니다.
```
sudo apt update
```
```
sudo apt install ruby-full
```
```
sudo apt install wget
```
1. 다음 명령을 입력합니다.
```
cd /home/ubuntu
```
*/home/Ubuntu*는 Ubuntu Server 인스턴스의 기본 사용자 이름을 나타냅니다. 사용자 지정 AMI를 사용하여 인스턴스를 만든 경우 AMI 소유자가 다른 기본 사용자 이름을 지정했을 수 있습니다.
1. 다음 명령을 입력합니다.
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*은 해당 리전의 CodeDeploy 리소스 키트 파일이 포함되어 있는 Amazon S3 버킷의 이름이며, *region-identifier*는 리전의 식별자입니다.
예제:
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
버킷 이름 및 리전 식별자 목록은 [리전별 리소스 키트 버킷 이름](resource-kit.md#resource-kit-bucket-names) 단원을 참조하세요.
1. 다음 명령을 입력합니다.
```
chmod +x ./install
```
1. 다음 중 하나를 수행하세요.
+ 20.04를 *제외한* 지원되는 버전의 Ubuntu Serer에서 최신 버전의 CodeDeploy 에이전트를 설치하려면 다음을 수행합니다.
```
sudo ./install auto
```
+ Ubuntu Server 20.04에서 최신 버전의 CodeDeploy 에이전트를 설치하려면 다음을 수행합니다.
**참고**
출력을 임시 로그 파일에 쓰는 것은 Ubuntu Server 20.04에서 `install` 스크립트를 사용하여 알려진 버그를 해결하는 동안 사용해야 하는 해결 방법입니다.
```
sudo ./install auto > /tmp/logfile
```
+ 20.04를 *제외한* 지원되는 버전의 Ubuntu Serer에서 특정 버전의 CodeDeploy 에이전트를 설치하려면 다음을 수행합니다.
+ 해당 리전에서 사용 가능한 버전을 나열합니다.
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ 다음 버전 중 하나를 설치합니다.
```
sudo ./install auto -v releases/codedeploy-agent-###.deb
```
**참고**
AWS 는 CodeDeploy 에이전트의 최신 마이너 버전을 지원합니다. 현재 최신 마이너 버전은 1.7.x입니다.
+ Ubuntu Server 20.04에서 특정 버전의 CodeDeploy 에이전트를 설치하려면 다음을 수행합니다.
+ 해당 리전에서 사용 가능한 버전을 나열합니다.
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ 다음 버전 중 하나를 설치합니다.
```
sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
```
**참고**
출력을 임시 로그 파일에 쓰는 것은 Ubuntu Server 20.04에서 `install` 스크립트를 사용하여 알려진 버그를 해결하는 동안 사용해야 하는 해결 방법입니다.
**참고**
AWS 는 CodeDeploy 에이전트의 최신 마이너 버전을 지원합니다. 현재 최신 마이너 버전은 1.7.x입니다.
**서비스가 실행 중인지 확인하려면**
1. 다음 명령을 입력합니다.
```
systemctl status codedeploy-agent
```
CodeDeploy 에이전트가 설치되어 실행 중이면 "`The AWS CodeDeploy agent is running`"와 같은 메시지가 표시되어야 합니다.
1. "`error: No AWS CodeDeploy agent running`"와 같은 메시지가 표시되면 서비스를 시작하고 다음 두 명령을 한 번에 하나씩 실행합니다.
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Windows Server용 CodeDeploy 에이전트 설치
Windows Server 인스턴스에서 다음 방법 중 하나를 사용하여 CodeDeploy 에이전트를 다운로드하고 설치할 수 있습니다.
+ 사용 AWS Systems Manager (권장)
+ 일련의 Windows PowerShell 명령 실행
+ 직접 다운로드 링크 선택
+ Amazon S3 복사 명령을 실행합니다.
**참고**
CodeDeploy 에이전트가 설치된 폴더는 `C:\Program Data\Amazon\CodeDeploy`입니다. 이 경로에 디렉터리 교차점 또는 심볼릭 링크가 없는 것을 확인해야 합니다.
**Topics**
+ [Systems Manager 사용](#codedeploy-agent-operations-install-system-manager)
+ [Windows PowerShell 사용](#codedeploy-agent-operations-install-windows-powershell)
+ [직접 링크 사용](#codedeploy-agent-operations-install-windows-direct-link)
+ [Amazon S3 복사 명령 사용](#codedeploy-agent-operations-install-windows-s3-copy)
## Systems Manager 사용
CodeDeploy 에이전트를 설치하려면 [를 사용하여 CodeDeploy 에이전트 설치 AWS Systems Manager](codedeploy-agent-operations-install-ssm.md)의 지침을 따릅니다.
## Windows PowerShell 사용
인스턴스에 로그인하여 Windows PowerShell에서 다음 명령을 실행합니다.
1. 인터넷에서 다운로드한 모든 스크립트와 구성 파일에 신뢰할 수 있는 게시자의 서명이 있어야 합니다. 실행 정책을 변경하라는 메시지가 나타나면 "**Y**"를 입력합니다.
```
Set-ExecutionPolicy RemoteSigned
```
1. 를 로드합니다 AWS Tools for Windows PowerShell.
```
Import-Module AWSPowerShell
```
1. CodeDeploy 에이전트 설치 파일이 다운로드될 디렉터리를 생성합니다.
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
1. `Set-AWSCredential` 및 `Initialize-AWSDefaultConfiguration` 명령을 사용하여 AWS 자격 증명을 구성합니다. 자세한 내용은 *AWS Tools for PowerShell 사용 설명서*의 [AWS 자격 증명 사용](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html)을 참조하세요.
1. CodeDeploy 에이전트 설치 파일을 다운로드합니다.
**참고**
AWS 는 CodeDeploy 에이전트의 최신 마이너 버전을 지원합니다. 현재 최신 마이너 버전은 1.7.x입니다.
최신 버전의 CodeDeploy 에이전트를 설치하려면 다음을 수행합니다.
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
특정 버전의 CodeDeploy 에이전트를 설치하려면
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
```
*bucket-name*은 해당 리전의 CodeDeploy 리소스 키트 파일이 포함되어 있는 Amazon S3 버킷의 이름입니다. 예를 들어 미국 동부(오하이오) 리전의 경우 *bucket-name*을 `aws-codedeploy-us-east-2`로 바꿉니다. 버킷 이름 목록은 [리전별 리소스 키트 버킷 이름](resource-kit.md#resource-kit-bucket-names) 단원을 참조하세요.
1. CodeDeploy 에이전트 설치 파일을 실행합니다.
```
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
```
서비스가 실행 중인지 확인하려면 다음 명령을 실행합니다.
```
powershell.exe -Command Get-Service -Name codedeployagent
```
CodeDeploy 에이전트를 방금 설치했고 아직 시작하지 않은 경우 **Get-Service** 명령을 실행한 후 **상태**에 **Start...**이 표시되어야 합니다.
```
Status Name DisplayName
------ ---- -----------
Start... codedeployagent CodeDeploy Host Agent Service
```
CodeDeploy 에이전트가 이미 실행 중인 경우 **Get-Service** 명령을 실행한 후 **상태**에 **Running**이 표시되어야 합니다.
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
## 직접 링크 사용
Windows Server 인스턴스의 브라우저 보안 설정이 `https://s3.*.amazonaws.com` 등에 권한을 제공하는 경우, 리전의 직접 링크를 사용하여 CodeDeploy 에이전트를 다운로드한 후 설치 관리자를 수동으로 실행할 수 있습니다.
링크는 다음과 같습니다.
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```
여기서 *리전*은 애플리케이션을 배포하는 AWS 리전입니다.
예제:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```
**중요**
CodeDeploy 애플리케이션과 같은 리전에 있는 `.msi` 파일을 가져옵니다. 다른 리전을 선택하면 `.msi` 파일을 실행할 때 `codedeploy-agent-log` 파일에 `inconsistent region` 오류가 발생할 수 있습니다.
## Amazon S3 복사 명령 사용
AWS CLI 가 인스턴스에 설치된 경우 Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) 명령을 사용하여 CodeDeploy 에이전트를 다운로드한 다음 설치 관리자를 수동으로 실행할 수 있습니다. 자세한 내용은 [Microsoft Windows AWS Command Line Interface 에 설치를](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html) 참조하세요.
Amazon S3 명령은 다음과 같습니다.
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```
여기서 *리전*은 애플리케이션을 배포하는 AWS 리전입니다.
예제:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```
# CodeDeploy 에이전트 업데이트
AWS Systems Manager를 사용하여 지원되는 모든 운영 체제에서 CodeDeploy 에이전트의 자동 예약 업데이트를 구성할 수 있습니다. 또한 에이전트에서 명령을 실행하여 지원되는 모든 운영 체제에 대한 업데이트를 강제로 수행할 수도 있습니다.
**Topics**
+ [Amazon Linux 또는 RHEL용 CodeDeploy 에이전트 업데이트](codedeploy-agent-operations-update-linux.md)
+ [Ubuntu Server에서 CodeDeploy 에이전트 업데이트](codedeploy-agent-operations-update-ubuntu.md)
+ [Windows Server에서 CodeDeploy 에이전트 업데이트](codedeploy-agent-operations-update-windows.md)
# Amazon Linux 또는 RHEL용 CodeDeploy 에이전트 업데이트
를 사용하여 CodeDeploy 에이전트의 예약된 자동 업데이트를 구성하려면를 [사용하여 CodeDeploy 에이전트 설치의 AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html) 단계를 AWS Systems Manager따릅니다.
CodeDeploy 에이전트 업데이트를 강제로 실행하려면 인스턴스에 로그인하여 다음 명령을 실행합니다.
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Ubuntu Server에서 CodeDeploy 에이전트 업데이트
를 사용하여 CodeDeploy 에이전트의 예약된 자동 업데이트를 구성하려면를 [사용하여 CodeDeploy 에이전트 설치의 AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html) 단계를 AWS Systems Manager따릅니다.
CodeDeploy 에이전트 업데이트를 강제로 실행하려면 인스턴스에 로그인하여 다음 명령을 실행합니다.
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Windows Server에서 CodeDeploy 에이전트 업데이트
를 사용하여 CodeDeploy 에이전트의 자동 업데이트를 활성화할 수 있습니다 AWS Systems Manager. Systems Manager에서 Systems Manager 상태 관리자와의 연결을 생성하여 Amazon EC2 또는 온프레미스 인스턴스에 업데이트 일정을 구성할 수 있습니다. 또한 현재 버전을 제거하고 최신 버전을 설치하여 CodeDeploy 에이전트를 수동으로 업데이트할 수도 있습니다.
**Topics**
+ [를 사용하여 자동 CodeDeploy 에이전트 업데이트 설정 AWS Systems Manager](#codedeploy-agent-operations-update-windows-ssm)
+ [CodeDeploy 에이전트 수동 업데이트](#codedeploy-agent-operations-update-windows-manual)
+ [(사용 중단됨) Windows Server 업데이트 프로그램으로 CodeDeploy 에이전트를 업데이트합니다.](#codedeploy-agent-operations-update-windows-updater)
## 를 사용하여 자동 CodeDeploy 에이전트 업데이트 설정 AWS Systems Manager
Systems Manager를 구성하고 CodeDeploy 에이전트의 자동 업데이트를 활성화하려면를 [ 사용하여 CodeDeploy 에이전트 설치의 AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html) 지침을 따릅니다.
## CodeDeploy 에이전트 수동 업데이트
CodeDeploy 에이전트를 수동으로 업데이트하려는 경우 CLI 또는 Systems Manager를 사용하여 최신 버전을 설치할 수 있습니다. [CodeDeploy 에이전트 설치](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html)의 지침을 따릅니다. [CodeDeploy 에이전트 설치 제거](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html) 지침에 따라 이전 버전의 CodeDeploy 에이전트를 제거하는 것이 좋습니다.
## (사용 중단됨) Windows Server 업데이트 프로그램으로 CodeDeploy 에이전트를 업데이트합니다.
**참고**
Windows Server용 CodeDeploy 에이전트 업데이트 프로그램은 더 이상 사용되지 않으며 1.0.1.1597 이후 버전으로 업데이트하지 않습니다.
CodeDeploy 에이전트가 자동으로 업데이트되도록 하려면 새 인스턴스 또는 기존 인스턴스에 Windows Server용 CodeDeploy 에이전트 업데이트 프로그램을 설치합니다. 업데이트 프로그램은 새 버전이 있는지 정기적으로 검사합니다. 이미 설치되어 있는 경우 새 버전이 감지되면 최신 버전을 설치하기 전에 업데이트 프로그램이 에이전트의 현재 버전을 제거합니다.
업데이트 프로그램이 새 버전을 감지할 때 배포가 이미 진행 중인 경우 배포가 계속해서 완료됩니다. 업데이트 프로세스 중에 배포를 시작하려고 하면 배포가 실패합니다.
CodeDeploy 에이전트 업데이트를 강제로 실행하려는 경우 [Windows Server용 CodeDeploy 에이전트 설치](codedeploy-agent-operations-install-windows.md) 섹션의 지침에 따릅니다.
Windows Server 인스턴스에서 Windows PowerShell 명령을 실행하거나, 직접 다운로드 링크를 사용하거나, Amazon S3 복사 명령을 실행하여 CodeDeploy 에이전트 업데이트 프로그램을 다운로드하고 설치할 수 있습니다.
**Topics**
+ [Windows PowerShell 사용](#codedeploy-agent-operations-update-windows-powershell)
+ [직접 링크 사용](#codedeploy-agent-operations-update-windows-direct-link)
+ [Amazon S3 복사 명령 사용](#codedeploy-agent-operations-update-windows-s3-copy)
### Windows PowerShell 사용
인스턴스에 로그인하여 Windows PowerShell에서 다음 명령을 한 번에 하나씩 실행합니다.
```
Set-ExecutionPolicy RemoteSigned
```
실행 정책을 변경하라는 메시지가 나타나면 **Y**를 선택합니다. 이렇게 하려면 Windows PowerShell에는 인터넷에서 다운로드한 모든 스크립트와 구성 파일에 신뢰할 수 있는 게시자의 서명이 있어야 합니다.
```
Import-Module AWSPowerShell
```
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
```
```
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
```
```
powershell.exe -Command Get-Service -Name codedeployagent
```
*bucket-name*은 해당 리전의 CodeDeploy 리소스 키트 파일이 포함되어 있는 Amazon S3 버킷의 이름입니다. 예를 들어 미국 동부(오하이오) 리전의 경우 *bucket-name*을 `aws-codedeploy-us-east-2`로 바꿉니다. 버킷 이름 목록은 [리전별 리소스 키트 버킷 이름](resource-kit.md#resource-kit-bucket-names) 단원을 참조하세요.
업데이트 프로세스 오류 문제를 해결해야 하는 경우 다음 명령을 입력하여 CodeDeploy 에이전트 업데이트 프로그램 로그 파일을 엽니다.
```
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log
```
### 직접 링크 사용
Windows Server 인스턴스의 브라우저 보안 설정이 ` http://s3.*.amazonaws.com ` 등에 필요한 권한을 제공하는 경우, 직접 링크를 사용하여 CodeDeploy 에이전트 업데이트 프로그램을 다운로드할 수 있습니다.
링크는 다음과 같습니다.
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi
```
여기서 *리전*은 애플리케이션을 업데이트하는 AWS 리전입니다.
예제:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi
```
### Amazon S3 복사 명령 사용
AWS CLI 가 인스턴스에 설치된 경우 Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) 명령을 사용하여 CodeDeploy 에이전트 업데이트 프로그램을 다운로드한 다음 설치 관리자를 수동으로 실행할 수 있습니다. 자세한 내용은 [Microsoft Windows AWS Command Line Interface 에 설치를](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html) 참조하세요.
Amazon S3 명령은 다음과 같습니다.
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region
```
여기서 *리전*은 애플리케이션을 업데이트하는 AWS 리전입니다.
예제:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1
```
# CodeDeploy 에이전트 설치 제거
더 이상 필요가 없거나 새로 설치하려는 경우 인스턴스에서 CodeDeploy 에이전트를 제거할 수 있습니다.
## Amazon Linux 또는 RHEL용 CodeDeploy 에이전트 설치 제거
CodeDeploy 에이전트를 제거하려면 인스턴스에 로그인하여 다음 명령을 실행합니다.
```
sudo yum erase codedeploy-agent
```
## Ubuntu Server에 CodeDeploy 에이전트를 설치 제거하려면
CodeDeploy 에이전트를 제거하려면 인스턴스에 로그인하여 다음 명령을 실행합니다.
```
sudo dpkg --purge codedeploy-agent
```
## Windows Server에서 CodeDeploy 에이전트를 설치 제거합니다.
CodeDeploy 에이전트를 제거하려면 인스턴스에 로그인하여 다음 3가지 명령을 한 번에 하나씩 실행합니다.
```
wmic
```
```
product where name="CodeDeploy Host Agent" call uninstall /nointeractive
```
```
exit
```
또한 인스턴스에 로그인하여 **제어판**에서 **프로그램 및 기능**을 열고 **CodeDeploy 호스트 에이전트**를 선택한 후 **제거**를 선택할 수도 있습니다.
# CloudWatch로 CodeDeploy 에이전트 로그 전송
[통합 CloudWatch 에이전트](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html), 줄여서 CloudWatch 에이전트를 사용하여 CodeDeploy 에이전트 지표 및 로그 데이터를 CloudWatch로 전송할 수 있습니다.
CodeDeploy 에이전트와 함께 사용할 CloudWatch 에이전트를 설치하고 구성하려면 다음 지침을 따르세요.
## 사전 조건
시작하기 전에 다음 작업을 완료하세요.
+ CodeDeploy 에이전트를 설치하고 실행 중인지 확인합니다. 자세한 내용은 [CodeDeploy 에이전트 설치](codedeploy-agent-operations-install.md) 및 [CodeDeploy 에이전트가 실행 중인지 확인](codedeploy-agent-operations-verify.md) 섹션을 참조하세요.
+ CloudWatch 에이전트를 설치합니다. 자세한 내용은 [CloudWatch 에이전트 설치](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html)를 참조하세요.
+ CodeDeploy IAM 인스턴스 프로파일에 다음 권한을 추가합니다.
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
CodeDeploy 인스턴스 프로파일에 대한 자세한 정보는 [CodeDeploy 시작하기](getting-started-codedeploy.md)의 [4단계: Amazon EC2 인스턴스에 대한 IAM 인스턴스 프로파일 만들기](getting-started-create-iam-instance-profile.md) 섹션을 참조하세요.
## CodeDeploy 로그를 수집하도록 CloudWatch 에이전트 구성
마법사를 단계별로 진행하거나 구성 파일을 수동으로 생성 또는 편집하여 CloudWatch 에이전트를 구성할 수 있습니다.
**마법사를 사용하여 CloudWatch 에이전트 구성(Linux)**
1. [CloudWatch 에이전트 구성 마법사 실행](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)에 설명된 대로 마법사를 실행합니다.
1. 마법사에서 “`Do you want to monitor any log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 로그 파일을 지정합니다.
1. `Log file path`에 CodeDeploy 로그 파일의 경로를 입력합니다(예: **/var/log/aws/codedeploy-agent/codedeploy-agent.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-log**).
1. “`Do you want to specify any additional log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 배포 로그를 지정합니다.
1. `Log file path`에 CodeDeploy 배포 로그 파일의 경로를 입력합니다(예: **/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-deployment-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**).
1. “`Do you want to specify any additional log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 업데이트 도구 로그를 지정합니다.
1. `Log file path`에 CodeDeploy 업데이트 도구 로그 파일의 경로를 입력합니다(예: **/tmp/codedeploy-agent.update.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-updater-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-updater-log**).
**마법사를 사용하여 CloudWatch 에이전트 구성(Windows)**
1. [CloudWatch 에이전트 구성 마법사 실행](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard)에 설명된 대로 마법사를 실행합니다.
1. 마법사에서 “`Do you want to monitor any customized log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 로그 파일을 지정합니다.
1. `Log file path`에 CodeDeploy 에이전트 로그 파일의 경로를 입력합니다(예: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-log**).
1. “`Do you want to specify any additional log files?`”라는 질문이 표시되면 **1**을 입력합니다.
1. 다음과 같이 CodeDeploy 에이전트 배포 로그를 지정합니다.
1. `Log file path`에 CodeDeploy 배포 로그 파일의 경로를 입력합니다(예: **C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**).
1. `Log group name`에 로그 그룹 이름을 입력합니다(예: **codedeploy-agent-deployment-log**).
1. `Log stream name`에 로그 스트림 이름을 입력합니다(예: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**).
**구성 파일을 수동으로 생성 또는 편집하여 CloudWatch 에이전트 구성(Linux)**
1. [수동으로 CloudWatch 에이전트 구성 파일 생성 또는 편집](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)에 설명된 대로 CloudWatch 에이전트 구성 파일을 생성 또는 편집합니다.
1. 파일 이름이 `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json`이고 다음 코드를 포함해야 합니다.
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-agent-log"
},
{
"file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
},
{
"file_path": "/tmp/codedeploy-agent.update.log",
"log_group_name": "codedeploy-agent-updater-log",
"log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
}
]
}
}
}
...
```
**구성 파일을 수동으로 생성 또는 편집하여 CloudWatch 에이전트 구성(Windows)**
1. [수동으로 CloudWatch 에이전트 구성 파일 생성 또는 편집](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html)에 설명된 대로 CloudWatch 에이전트 구성 파일을 생성 또는 편집합니다.
1. 파일 이름이 `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json`이고 다음 코드를 포함해야 합니다.
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-codedeploy-agent-log"
},
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
}
]
},
...
}
},
...
```
## CloudWatch 에이전트 재시작
변경한 후 [CloudWatch 에이전트 시작](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet)에 설명된 대로 CloudWatch 에이전트를 다시 시작합니다.