---
title: "에이전트 설치 및 관리"
slug: "devtools-sourcedeploy-deploysetting"
tags: ["sourcedeploy"]
updated: 2026-08-20T09:03:33Z
published: 2026-08-20T09:03:33Z
canonical: "guide-gov.ncloud-docs.com/devtools-sourcedeploy-deploysetting"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 에이전트 설치 및 관리
Classic/VPC 환경에서 이용 가능합니다.
에이전트 설치 및 관리에서 에이전트 지원 사양 및 설치 방법에 대해 설명합니다. 또한, 에이전트에 사용하는 명령어와 에이전트와 관련하여 발생할 수 있는 문제의 해결 방안을 설명합니다.
## 에이전트 지원 사양
에이전트 지원 사양은 다음과 같습니다.
| 항목 | 지원 사양 |
| --- | --- |
| 타깃 서버 | 네이버 클라우드 플랫폼에서 생성한 Server 또는 Auto Scaling Group |
| OS | Ubuntu 22 이하, Rocky 8 이하, RHEL(Red Hat Enterprise Linux) 8 버전 이하 |
| Python 버전 | 2.6, 2.7 버전 |
## 에이전트 설치
SourceDeploy를 이용하여 서버에 배포하려면 해당 서버에 SourceDeploy용 에이전트가 설치되어 있어야 합니다.
에이전트를 설치하려면 다음 단계를 차례대로 진행해 주십시오.
- [1. API 인증키 생성](/docs/devtools-sourcedeploy-deploysetting#1API%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)
- [2. 설치 명령어 작성](/docs/devtools-sourcedeploy-deploysetting#2%EC%84%A4%EC%B9%98%EB%AA%85%EB%A0%B9%EC%96%B4%EC%9E%91%EC%84%B1)
### 1. API 인증키 생성
에이전트를 설치하고 사용하려면 API 인증키가 필요합니다.
API 인증키를 생성하는 방법은 다음과 같습니다.
1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** 메뉴를 차례대로 클릭해 주십시오.
3. **API 인증키** 항목에서 **[신규 API 인증키 생성]** 버튼을 클릭해 주십시오.
- 생성된 API가 목록에 표시됩니다.
### 2. 설치 명령어 작성
설치 명령어는 서버에 접속하여 작성하거나 Init Script에 작성할 수 있습니다.
작성 방법에 따라 다음을 참고해 주십시오.
- [서버 접속 후 작성](/docs/devtools-sourcedeploy-deploysetting#%EC%84%9C%EB%B2%84%EC%A0%91%EC%86%8D%ED%9B%84%EC%9E%91%EC%84%B1)
- [Init Script에 작성](/docs/devtools-sourcedeploy-deploysetting#InitScript%EC%97%90%EC%9E%91%EC%84%B1)
주의
콘솔에서 Init Script를 작성하여 에이전트를 설치하는 경우, 프로젝트를 생성하기 전에 Init Script에 설치 명령어를 작성하여 생성한 후 배포 타깃이 될 Server 또는 Auto Scaling 생성 시 등록해 주십시오.
#### 서버 접속 후 작성
설치 명령어를 서버에 접속하여 작성 및 실행하는 방법은 다음과 같습니다.
1. SourceDeploy 배포 프로젝트에 설정한 배포 타깃 서버에 접속해 주십시오.
2. 다음을 참고하여 명령어를 입력해 주십시오.
```
echo $'NCP_ACCESS_KEY=accesskey\nNCP_SECRET_KEY=secretkey' > /opt/NCP_AUTH_KEY
chmod 400 /opt/NCP_AUTH_KEY
wget Agent 다운로드 주소
chmod 755 install
./install
rm -rf install
```
- `accesskey`에 [1. API 인증키 생성](/docs/devtools-sourcedeploy-deploysetting#1API%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)에서 생성한 API 인증키의 **Access Key ID**를 입력해 주십시오.
- `secretkey`에 [1. API 인증키 생성](/docs/devtools-sourcedeploy-deploysetting#1API%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)에서 생성한 API 인증키의 **Secret Key**를 입력해 주십시오.
주의
API 인증키는 **사용 중**인 키를 사용해야 합니다. **사용 중지**인 키를 사용할 경우, 에이전트가 정상 동작하더라도 인증에 실패하여 SourceDeploy를 통한 배포가 정상적으로 수행되지 않습니다. **사용 중지**인 키를 사용하려면 **[사용]** 버튼을 클릭하여 상태를 **사용 중**으로 변경해 주십시오.
- **Secert Key**는 **[보기]** 버튼을 클릭하여 확인할 수 있습니다.
- `Agent 다운로드 주소`에 사용 리전 및 환경에 해당하는 에이전트 다운로드 주소를 입력해 주십시오.
| 환경 | 리전 | Agent 다운로드 주소 |
| --- | --- | --- |
| VPC | 수도권 | https://deploy-agent.apigw.gov-ntruss.com/agent/vpc/download/install |
| Classic | 수도권 | https://deploy-agent.apigw.gov-ntruss.com/agent/v1/download/install |
- `NCP_AUTH_KEY`는 서버 내 /opt 디렉터리 아래에 다음과 같이 생성되어야 합니다. 
#### Init Script에 작성
설치 명령어를 Init Script에 작성한 경우, Server 또는 Auto Scaling에 등록해야 합니다.
설치 명령어를 Init Script에 작성한 후 Server 또는 Auto Scaling에 등록하는 방법은 다음과 같습니다.
1. **Menu** > **All Services** > **Compute** > **Server** 메뉴를 차례대로 클릭해 주십시오.
2. **Init Script** 메뉴를 클릭해 주십시오.
3. **[Script 생성]** 버튼을 클릭해 주십시오.
4. **Script 이름**을 입력한 후 **OS 타입**을 선택해 주십시오.
5. 다음을 참고하여 **Script**를 작성해 주십시오.
```
#!/bin/bash
echo $'NCP_ACCESS_KEY=accesskey\nNCP_SECRET_KEY=secretkey' > /opt/NCP_AUTH_KEY
chmod 400 /opt/NCP_AUTH_KEY
wget Agent 다운로드 주소
chmod 755 install
./install
rm -rf install
```
| 환경 | 리전 | Agent 다운로드 주소 |
| --- | --- | --- |
| VPC | 수도권 | https://deploy-agent.apigw.gov-ntruss.com/agent/vpc/download/install |
| Classic | https://deploy-agent.apigw.gov-ntruss.com/agent/v1/download/install |
- `accesskey`에 [1. API 인증키 생성](/docs/devtools-sourcedeploy-deploysetting#1API%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)에서 생성한 API 인증키의 **Access Key ID**를 입력해 주십시오.
- `secretkey`에 [1. API 인증키 생성](/docs/devtools-sourcedeploy-deploysetting#1API%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)에서 생성한 API 인증키의 **Secret Key**를 입력해 주십시오.
주의
API 인증키는 **사용 중**인 키를 사용해야 합니다. **사용 중지**인 키를 사용할 경우, 에이전트가 정상 동작하더라도 인증에 실패하여 SourceDeploy를 통한 배포가 정상적으로 수행되지 않습니다. **사용 중지**인 키를 사용하려면 **[사용]** 버튼을 클릭하여 상태를 **사용 중**으로 변경해 주십시오.
- **Secert Key**는 **[보기]** 버튼을 클릭하여 확인할 수 있습니다.
- `Agent 다운로드 주소`에 사용 환경 및 리전에 해당하는 에이전트 다운로드 주소를 입력해 주십시오.
6. **[Script 생성]** 버튼을 클릭해 주십시오.
7. 생성한 Init Script를 Server 또는 Auto Scaling에 등록해 주십시오.
- Server에 등록하려면 **Server** 메뉴를 클릭해 주십시오.
- **[서버 생성]** 버튼을 클릭하여 Init Script를 등록할 수 있습니다. 자세한 Server 생성 방법은 [Server 생성 가이드](/docs/server-start-classic)를 참고해 주십시오.
- Auto Scaling에 등록하려면 **Menu** > **Service** > **Compute** > **Auto Scaling** > **Launch Configuration** 메뉴를 차례대로 클릭해 주십시오.
- **[Launch Configuration 생성]** 버튼을 클릭하여 Init Script를 등록할 수 있습니다. 자세한 Launch Configuration 생성 방법은 [Launch Configuration 생성 가이드(Classic)](/docs/autoscaling-lc-classic#LaunchConfiguration%EC%83%9D%EC%84%B1), [Launch Configuration 생성 가이드(VPC)](/docs/autoscaling-lc-vpc#LaunchConfiguration%EC%83%9D%EC%84%B1)를 참고해 주십시오.
## 에이전트 실행 명령어
에이전트 실행 명령어는 다음과 같습니다.
**에이전트 시작**
```
service sourcedeploy start
```
**에이전트 중지**
```
service sourcedeploy stop
```
**에이전트 상태 확인**
```
service sourcedeploy status
```
**에이전트 재시작**
```
service sourcedeploy restart
```
**에이전트 프로세스 확인**
에이전트 프로세스를 확인하여 에이전트가 정상적으로 실행되는지 확인할 수 있습니다.
에이전트 프로세스의 정상 실행 기준은 다음과 같습니다.
- Classic/VPC 환경에서 1개 실행
```
ps -ef | grep main.py
```
## 에이전트 삭제
에이전트를 삭제하는 방법은 다음과 같습니다.
1. 에이전트 설치 서버에 접속하여 에이전트를 중지해 주십시오.
- 에이전트 중지 명령어는 다음과 같습니다.
```
service sourcedeploy stop
```
2. 에이전트 프로세스 확인을 통해 살아있는 프로세스를 모두 제거해 주십시오.
- 에이전트 프로세스 확인 및 제거 명령어는 다음과 같습니다.
```
ps -ef | grep main.py
```
```
kill -9 PID(ex.3587)
```
3. 설치된 에이전트 파일을 제거해 주십시오.
- 에이전트 파일 제거 명령어는 다음과 같습니다.
```
rm -rf /opt/sdagent
```
## 에이전트 문제 해결
**에이전트 연결이 되지 않는 경우**
- 에이전트 상태 확인 명령어를 입력하여 에이전트가 정상적으로 설치되었는지 확인해 주십시오.
```
service sourcedeploy status
```
- 설치된 에이전트 버전을 확인해 주십시오.
```
cat /opt/sdagent/Agent.ver
```
<예시> 2021/05/27 기준
```
[VERSION]
ver=2021/05/18/01
```
- 설치된 에이전트 버전이 이전 버전일 경우, 에이전트를 삭제한 후 재설치해 주십시오.
- 에이전트 삭제는 [에이전트 삭제](/docs/devtools-sourcedeploy-deploysetting#%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EC%82%AD%EC%A0%9C)를 참고해 주십시오.
- Init Script에 에이전트 설치 URL이 다음과 같이 입력되었는지 확인해 주십시오.
- 사용 환경 및 리전에 따른 에이전트 다운로드 주소는 다음과 같습니다.
| 환경 | 리전 | Agent 다운로드 주소 |
| --- | --- | --- |
| VPC | 수도권 | https://deploy-agent.apigw.gov-ntruss.com/agent/vpc/download/install |
| Classic | https://deploy-agent.apigw.gov-ntruss.com/agent/v1/download/install |
```
wget Agent 다운로드 주소
```
- 서버 상태가 **운영중**인지 확인해 주십시오.
**에이전트 프로세스가 정상적으로 실행되지 않는 경우**
참고
에이전트 프로세스의 정상 실행 기준은 다음과 같습니다.
- 프로세스 1개 실행
- 재시작 명령어를 입력하여 에이전트를 재시작해 주십시오.
```
service sourcedeploy restart
```
- 재시작한 후에도 정상적으로 동작하지 않을 경우, 에이전트를 재설치해 주십시오.
**에이전트가 설치되지 않는 경우**
- 인증키 값이 정상적으로 입력되었는지 확인해 주십시오.
```
cat /opt/NCP_AUTH_KEY
```
- Init Script 첫 줄에 `#!/usr/bin/env python`, `#!/bin/perl`, `#!/bin/bash` 등과 같은 형태로 실행하고자 하는 스크립트 경로를 지정했는지 확인해 주십시오.