---
title: "배포 실행 및 관리"
slug: "sourcedeploy-use-deploy"
tags: ["SourceDeploy 사용", "SourceDeploy"]
updated: 2026-07-23T09:02:41Z
published: 2026-07-23T09:02:41Z
canonical: "guide-fin.ncloud-docs.com/sourcedeploy-use-deploy"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 배포 실행 및 관리
배포 실행 및 관리에서 생성한 배포 시나리오를 배포 타깃에 배포하는 방법을 설명합니다. 권한에 따라 배포를 직접 실행하거나 승인 요청 및 승인을 통해 배포할 수 있습니다.
## 배포 실행
주의
배포 타깃이 Ncloud Kubernetes Service이며 배포 전략이 Rolling 또는 블루/그린인 경우, 배포 중에 배포를 취소할 수 없습니다. 배포가 필요한 경우에만 배포를 실행해 주십시오.
참고
배포를 실행하려면 고객 계정 또는 doDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 [Sub Account 사용 가이드](/docs/subaccount-overview)를 참고해 주십시오.
배포를 실행하는 방법은 다음과 같습니다.
1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포할 시나리오가 포함된 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.
3. 배포할 시나리오를 클릭해 주십시오.
4. 배포 시나리오의 정보와 설정을 확인해 주십시오.
참고
- 확인 및 변경 가능한 시나리오 설정은 배포 타깃에 따라 차이가 있습니다.
- 해당 페이지에서 변경된 설정은 저장되지 않으며, 해당 배포에서 한 번만 적용됩니다.
- 배포 타깃을 상세 확인하려면 **[확인]** 버튼을 클릭해 주십시오.
- 배포 파일의 설정을 변경하려면 **배포 파일**의 **[설정 변경]** 버튼을 클릭해 주십시오.
- 배포 명령어를 변경하려면 **배포 명령어**의 **[설정 변경]** 버튼을 클릭해 주십시오.
- 배포 경로를 변경하려면 **배포 경로**의 **[설정 변경]** 버튼을 클릭해 주십시오.
- 매니페스트 파일을 확인하려면 **[Show File]** 버튼을 클릭해 주십시오.
- 배포 실패 시 롤백 여부를 변경할 수 있습니다.
5. **[배포 시작하기]** 버튼을 클릭해 주십시오.
- 배포가 시작되며, 배포 작업 결과 화면으로 이동합니다.
- 배포를 취소하려면 **[취소]** 버튼을 클릭해 주십시오.
참고
Ncloud Kubernetes Service 클러스터에 오브젝트 배포 시
- 오브젝트 업데이트 시 동일한 네임스페이스(namespace)로만 업데이트할 수 있습니다.
- 매니페스트의 kind에 상관없이 SourceDeploy는 배포 전략 메커니즘에 따라 배포를 수행합니다.
- Pod, Deployment, ReplicaSet, ReplicationController, DaemonSet, StatefulSet 은 정상적으로 배포 되었는지 검증을 수행 합니다.
- 매니페스트가 여러 개일 경우 하나라도 실패하면 모든 오브젝트가 롤백됩니다.
- Replica Set, Replication Controller와 같은 종류의 오브젝트는 업데이트가 되더라도 Kubernetes spec에 따라 이미지가 업데이트되지 않습니다. 다음 Kubernetes 권장 사항을 확인하여 배포해 주십시오.
- [Replica Set](https://kubernetes.io/docs/concepts/workloads/controllers/replicaset/)
- [Replication Controller](https://kubernetes.io/ko/docs/concepts/workloads/controllers/replicationcontroller/)
## 배포 승인 요청
참고
배포 승인을 요청하려면 doDeploy 권한을 가지지 않으며, requestDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 [Sub Account 사용 가이드](/docs/subaccount-overview)를 참고해 주십시오.
주의
배포 승인 요청은 취소할 수 없습니다. 배포가 필요한 경우에만 승인 요청해 주십시오.
배포 승인을 요청하는 방법은 다음과 같습니다.
1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포할 시나리오가 포함된 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.
3. 배포할 시나리오를 클릭해 주십시오.
4. 배포 시나리오의 정보와 설정을 확인한 후 **[배포 승인 요청]** 버튼을 클릭해 주십시오.
참고
- 확인 및 변경 가능한 시나리오 설정은 배포 타깃에 따라 차이가 있습니다.
- 해당 페이지에서 변경된 설정은 저장되지 않으며, 해당 배포에서 한 번만 적용됩니다.
- 배포 타깃을 상세 확인하려면 **[확인]** 버튼을 클릭해 주십시오.
- 배포 파일의 설정을 변경하려면 **배포 파일**의 **[설정 변경]** 버튼을 클릭해 주십시오.
- 배포 명령어를 변경하려면 **배포 명령어**의 **[설정 변경]** 버튼을 클릭해 주십시오.
- 배포 경로를 변경하려면 **배포 경로**의 **[설정 변경]** 버튼을 클릭해 주십시오.
- 매니페스트 파일을 확인하려면 **[Show File]** 버튼을 클릭해 주십시오.
- 배포 실패 시 롤백 여부를 변경할 수 있습니다.
5. 배포 승인 요청 팝업 창의 **[확인]** 버튼을 클릭해 주십시오.
- 배포 승인 권한(approveDeploy)을 가진 사용자에게 배포 승인을 요청합니다.
주의
배포 승인 요청에 대해 이메일 또는 SMS 알림 기능이 제공되지 않습니다.
## 배포 승인/거절
참고
배포 승인 요청에 대해 승인 또는 거절하려면 고객 계정 또는 approveDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 [Sub Account 사용 가이드](/docs/subaccount-overview)를 참고해 주십시오.
배포 승인 요청에 대해 승인 또는 거절하는 방법은 다음과 같습니다.
1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포를 승인/거절할 시나리오가 포함된 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.
3. **[작업 결과]** 탭을 클릭해 주십시오.
4. 상태가 **배포 승인 대기 중**인 시나리오의 **[승인]** 버튼을 클릭해 주십시오.
5. 시나리오 배포 승인 여부에 따라 배포 승인 팝업 창에서 **[승인]** 또는 **[승인 안함]** 버튼을 클릭해 주십시오.
- 배포가 시작됩니다.
- 배포를 취소하려면 **[취소]** 버튼을 클릭해 주십시오.
## 배포 작업 결과 확인
배포 작업 결과를 확인하는 방법은 다음과 같습니다.
1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포 작업 결과를 확인할 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트의 이름을 클릭해 주십시오.
3. **[작업 결과]** 탭을 클릭해 주십시오.
4. 작업 결과를 확인할 내역을 클릭해 주십시오.
주의
**배포 로그**는 `/var/sourcedeploy/log` 경로에 저장되며, 해당 경로를 삭제할 경우 배포 로그를 확인할 수 없습니다.
- **배포 요약** 및 **배포 로그** 정보를 확인할 수 있습니다.
- 로그는 최대 30일까지 저장합니다.
### 배포 작업 결과 화면
배포 작업 결과 화면은 다음과 같이 구성되어 있습니다.
| 영역 | 설명 |
| --- | --- |
| ① 프로젝트명 | 배포 프로젝트 이름 표시 |
| ② 작업 결과 목록 정보 | 작업 결과 목록에 표시되는 정보(배포 시나리오 이름, 배포 Stage, 배포 요청자, 배포 요청 시간, 배포 상태)배포 상태에 따라 버튼 표시 |
| ③ **배포 요약** | 배포 타깃에 따라 배포 요약 정보(배포 상태, 배포 요청 시간, 배포 종료 시간, 배포 파일, Canary 분석 리포트, 백업 파일) 표시배포 상태 |
| ④ **배포 로그** | 배포 단계별로 수집된 로그 표시 |
참고
- 배포를 취소하면 현재 실행 중인 단계까지 진행되고 이후 단계는 진행되지 않습니다.
- 배포 취소 또는 배포 실패 시 블루/그린 배포로 생성된 Auto Scaling Group이나 서버는 자동으로 반납되지 않습니다. Auto Scaling Group 또는 서버가 더 이상 필요하지 않은 경우, 직접 해당 서비스에서 반납/삭제해 주십시오.
- Canary 수동 배포를 취소하는 경우, Canary 버전이 배포되지 않으며 Baseline, Canary 버전의 애플리케이션이 종료됩니다.
### 배포 단계 상세 확인
배포 타깃별 배포 단계는 다음과 같습니다.
| 배포 타깃 | 배포 단계 | 설명 |
| --- | --- | --- |
| Server 또는 Auto Scaling(기본) | 서버명 | 배포 에이전트 상태 확인 |
| **배포 전 실행** | 배포 전 명령어 수행 |
| **파일 배포** | 설정한 경로에 파일 배포 |
| **배포 후 실행** | 배포 후 명령어 수행 |
| Auto Scaling(블루/그린) | **배포 준비** | 블루/그린 배포를 위한 사전 준비 수행 새 Auto Scaling Group 생성새 Auto Scaling Group 내 서버 생성 완료 대기 |
| **새 그룹에 배포** | 새 Auto Scaling Group 내 서버에 대해 배포 에이전트 상태 확인 |
| **새 그룹 검증** | 새 Auto Scaling Group 검증새 Auto Scaling Group 내 생성된 서버를 로드밸런서에 연결로드밸런서 헬스 체크가 정상인지 확인(모든 헬스 체크를 성공해야 다음 단계로 진행, 타임 아웃(1시간) 내 헬스 체크를 실패할 경우 배포는 실패로 종료) |
| **배포 마무리** | 블루/그린 배포 마무리 수행기존 그룹 내 서버에 설정된 값에 때라 기존 Auto Scaling Group 내 서버 처리기존 Auto Scaling Group에 연결된 Cloud Insight 이벤트 존재 시 이벤트 복사 |
| Ncloud Kubernetes Service | **배포 준비** | 배포 준비kubectl 로드클러스터 접근매니페스트 파일 다운로드매니페스트 파일 로드 |
| **배포** | 배포 진행 |
| Object Storage | **배포 준비** | 배포 준비백업 파일 다운로드백업 파일 압축백업 파일 업로드 |
| **배포** | 배포 진행배포 파일 다운로드배포 파일 압축 해제배포 파일 업로드 |
참고
- SourceDeploy는 배포 명령어 기능을 제공하며 이를 활용하여 배포 과정에서 검증 절차를 추가할 수 있습니다.
- 배포 명령어에서 검증 명령어를 실행하고 실패 시 exit 1 등의 종료 코드를 반환하면 배포가 실패 상태로 처리됩니다.
- 검증 과정에서 출력되는 오류 로그를 확인하면 실패 원인을 파악할 수 있습니다.
### Canary 분석 리포트 확인
배포 전략이 **Canary**이면서 분석 방법이 **자동**인 경우, Canary 분석 리포트를 확인할 수 있습니다.
배포 작업 결과 화면에서 **Canary 분석 리포트**의 **리포트**를 클릭해 주십시오. Canary 분석 화면이 나타납니다.
Canary 분석 화면은 다음과 같이 구성되어 있습니다.
| 영역 | 설명 |
| --- | --- |
| ① 분석 단계 | [Canary 자동 분석 설정](/docs/sourcedeploy-use-scenario#Canary%EC%9E%90%EB%8F%99%EB%B6%84%EC%84%9D%EC%84%A4%EC%A0%95) 시 설정한 분석 시간, 분석 주기로 분석 단계 결정분석 데이터는 누적되어 분석 <예시> 분석 시간이 10분이고 분석 주기가 3분인 경우, 10분 동안 3분마다 총 4번의 분석 단계 점수가 나오며 마지막 분석 단계 시간은 1분 |
| ② 분석 점수 | 분석 단계 점수 표시해당 점수가 분석 성공 점수 이상이 되어야 성공이며, 분석에 실패할 경우 다음 분석 미진행 |
| ③ 분석 정보 | 분석 시간 및 분석 성공 점수(**Pass**), Metric 수집 주기(**Step**) 표시 |
| ④ Metric 정보 | [Canary 자동 분석 설정](/docs/sourcedeploy-use-scenario#Canary%EC%9E%90%EB%8F%99%EB%B6%84%EC%84%9D%EC%84%A4%EC%A0%95) 시 설정한 Metric과 Weight(가중치) 표시Metric 클릭 시 Canary 분석 결과 표시 |
| ⑤ 분석 결과 목록 | Canary 분석 결과 표시**종류**: **Baseline**(Baseline 버전 쿼리의 질의 결과), **Canary**(Canary 버전 쿼리의 질의 결과)**시작 시간**/**종료 시간**: 분석이 시작된 시간/완료된 시간**Count**: 분석 시간 동안 나온 실제 데이터 개수**Avg**: 데이터 평균 값**Max**: 데이터 최댓값**Min**: 데이터 최솟값 |
| ⑥ **Element 결과** | Prometheus 질의 결과에서 나온 데이터의 Element 값 표시Baseline과 Canary 질의 결과의 Element가 같아야 정상적으로 분석 진행클릭하여 Element 확인 |
| ⑦ **편차** | Baseline 값 대비 Canary 값의 증가/감소율 표시 |
| ⑧ **결과** | Baseline 기준 Canary의 편차로 계산된 결과 표시[Metric 생성](/docs/sourcedeploy-use-scenario#Metric%EC%83%9D%EC%84%B1) 시 설정한 성공 기준에 따라 결과(성공/실패) 결정 |
참고
- Canary 분석 리포트는 설정된 Prometheus의 보관 주기 동안만 확인할 수 있습니다.
- 분석 단계 점수 계산 방법
- Metric 점수: (성공한 질의 결과/전체 질의 결과)*(메트릭 가중치)
<예시>
- Metric Name: success_rate1
성공 질의 결과: 2개(#1, #3)
전체 질의 결과: 3개(#1, #2, #3)
Weight: 30
Metric 점수: (2/3)*30=20
- Metric Name: success_rate2
성공 질의 결과: 1개(#1)
전체 질의 결과: 1개(#1)
Weight: 70
Metric 점수: (1/1)*70=70
- 분석 단계 점수: 20+70=90