---
title: "배포 실행 및 관리"
slug: "sourcedeploy-use-deploy"
tags: ["sourcedeploy"]
updated: 2026-08-20T09:03:33Z
published: 2026-08-20T09:03:33Z
canonical: "guide-gov.ncloud-docs.com/sourcedeploy-use-deploy"
---

> ## 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.

# 배포 실행 및 관리

<p class="platform-info type-classic-vpc">Classic/VPC 환경에서 이용 가능합니다.</p>

배포 실행 및 관리에서 생성한 배포 시나리오를 배포 타깃에 배포하는 방법을 설명합니다. 권한에 따라 배포를 직접 실행하거나 승인 요청 및 승인을 통해 배포할 수 있습니다.

## 배포 실행<a name="배포실행"></a>

:::(Info) (참고)
배포를 실행하려면 고객 계정 또는 doDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 [Sub Account 사용 가이드](/docs/subaccount-overview)를 참고해 주십시오.
:::

:::(Warning) (주의)
배포 타깃이 Ncloud Kubernetes Service이며 배포 전략이 Rolling 또는 블루/그린인 경우, 배포 중에 배포를 취소할 수 없습니다. 배포가 필요한 경우에만 배포를 실행해 주십시오.
:::

배포를 실행하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포할 시나리오가 포함된 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.
3. 배포할 시나리오를 클릭해 주십시오.
4. 배포 시나리오의 정보와 설정을 확인해 주십시오.
   * 배포 타깃을 상세 확인하려면 **[확인]** 버튼을 클릭해 주십시오.
   * 배포 파일의 설정을 변경하려면 **배포 파일**의 **[설정 변경]** 버튼을 클릭해 주십시오.
   * 배포 명령어를 변경하려면 **배포 명령어**의 **[설정 변경]** 버튼을 클릭해 주십시오.
   * 배포 경로를 변경하려면 **배포 경로**의 **[설정 변경]** 버튼을 클릭해 주십시오.
   * 매니페스트 파일을 확인하려면 **[Show File]** 버튼을 클릭해 주십시오.
   * 배포 실패 시 롤백 여부를 변경할 수 있습니다.
   
   :::(Info) (참고)
   * 확인 및 변경 가능한 시나리오 설정은 배포 타깃에 따라 차이가 있습니다.
   * 해당 페이지에서 변경된 설정은 저장되지 않으며, 해당 배포에서 한 번만 적용됩니다.
   :::

5. **[배포 시작하기]** 버튼을 클릭해 주십시오.
   * 배포가 시작되며, 배포 작업 결과 화면으로 이동합니다.
   * 배포를 취소하려면 **[취소]** 버튼을 클릭해 주십시오.

:::(Info) (참고)
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/){target="_blank"}
  * [Replication Controller](https://kubernetes.io/ko/docs/concepts/workloads/controllers/replicationcontroller/){target="_blank"}
:::

## 배포 승인 요청<a name="배포승인요청"></a>

:::(Info) (참고)
배포 승인을 요청하려면 doDeploy 권한을 가지지 않으며, requestDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 [Sub Account 사용 가이드](/docs/subaccount-overview)를 참고해 주십시오.
:::

:::(Warning) (주의)
배포 승인 요청은 취소할 수 없습니다. 배포가 필요한 경우에만 승인 요청해 주십시오.
:::

배포 승인을 요청하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포할 시나리오가 포함된 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.
3. 배포할 시나리오를 클릭해 주십시오.
4. 배포 시나리오의 정보와 설정을 확인한 후 **[배포 승인 요청]** 버튼을 클릭해 주십시오.
   * 배포 타깃을 상세 확인하려면 **[확인]** 버튼을 클릭해 주십시오.
   * 배포 파일의 설정을 변경하려면 **배포 파일**의 **[설정 변경]** 버튼을 클릭해 주십시오.
   * 배포 명령어를 변경하려면 **배포 명령어**의 **[설정 변경]** 버튼을 클릭해 주십시오.
   * 배포 경로를 변경하려면 **배포 경로**의 **[설정 변경]** 버튼을 클릭해 주십시오.
   * 매니페스트 파일을 확인하려면 **[Show File]** 버튼을 클릭해 주십시오.
   * 배포 실패 시 롤백 여부를 변경할 수 있습니다.
   
   :::(Info) (참고)
   * 확인 및 변경 가능한 시나리오 설정은 배포 타깃에 따라 차이가 있습니다.
   * 해당 페이지에서 변경된 설정은 저장되지 않으며, 해당 배포에서 한 번만 적용됩니다.
   :::

5. 배포 승인 요청 팝업 창의 **[확인]** 버튼을 클릭해 주십시오.
   * 배포 승인 권한(approveDeploy)을 가진 사용자에게 배포 승인을 요청합니다.

:::(Warning) (주의)
배포 승인 요청에 대해 이메일 또는 SMS 알림 기능이 제공되지 않습니다.
:::

## 배포 승인/거절<a name="배포승인거절"></a>

:::(Info) (참고)
배포 승인 요청에 대해 승인 또는 거절하려면 고객 계정 또는 approveDeploy 권한을 가진 서브 계정이 필요합니다. 권한 설정 방법은 [Sub Account 사용 가이드](/docs/subaccount-overview)를 참고해 주십시오.
:::

배포 승인 요청에 대해 승인 또는 거절하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포를 승인/거절할 시나리오가 포함된 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트명을 클릭해 주십시오.
3. **[작업 결과]** 탭을 클릭해 주십시오.
4. 상태가 **배포 승인 대기 중**인 시나리오의 **[승인]** 버튼을 클릭해 주십시오.
5. 시나리오 배포 승인 여부에 따라 배포 승인 팝업 창에서 **[승인]** 또는 **[승인 안함]** 버튼을 클릭해 주십시오.

   * 배포가 시작됩니다.
   * 배포를 취소하려면 **[취소]** 버튼을 클릭해 주십시오.

## 배포 작업 결과 확인<a name="배포작업결과확인"></a>

배포 작업 결과를 확인하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceDeploy** 메뉴를 차례대로 클릭해 주십시오.
2. 배포 작업 결과를 확인할 배포 프로젝트를 선택한 후 **[배포로 이동]** 버튼을 클릭하거나 해당 배포 프로젝트의 이름을 클릭해 주십시오.
3. **[작업 결과]** 탭을 클릭해 주십시오.
4. 작업 결과를 확인할 내역을 클릭해 주십시오.
   * **배포 요약** 및 **배포 로그** 정보를 확인할 수 있습니다.
     * 로그는 최대 30일까지 저장합니다.

   :::(Warning) (주의)
   **배포 로그**는 `/var/sourcedeploy/log` 경로에 저장되며, 해당 경로를 삭제할 경우 배포 로그를 확인할 수 없습니다.
   :::

### 배포 작업 결과 화면<a name="배포작업결과화면"></a>

배포 작업 결과 화면은 다음과 같이 구성되어 있습니다.

![sourcedepoy-deploy_result_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/sourcedeploy-deploy_result_ko.png)

| 영역 | 설명 |
| ---- | ---- |
| ① 프로젝트명 | 배포 프로젝트 이름 표시 |
| ② 작업 결과 목록 정보 | 작업 결과 목록에 표시되는 정보(배포 시나리오 이름, 배포 Stage, 배포 요청자, 배포 요청 시간, 배포 상태)<li>배포 상태에 따라 버튼 표시<ul><ul><li>**배포 중**인 경우 **[취소]** 버튼이 표시되며, 클릭하여 배포 취소 가능<li>**배포 승인 대기 중**인 경우 **[승인]** 버튼이 표시되며, 클릭하여 배포 승인 가능(단, 배포 승인 권한이 있는 경우에만 승인 가능)</ul></ul> |
| ③ **배포 요약** | 배포 타깃에 따라 배포 요약 정보(배포 상태, 배포 요청 시간, 배포 종료 시간, 배포 파일, Canary 분석 리포트, 백업 파일) 표시<li>배포 상태<ul><ul><li>**배포 승인 대기 중**: 배포 권한이 없는 사용자로부터 배포 승인 요청된 상태<li>**배포 승인 거절됨**: 배포 승인 요청이 거절된 상태<li>**배포 중**: 배포가 실행되고 있는 상태<li>**배포 취소**: 배포 실행 중 취소된 상태<li>**배포 완료**: 배포가 완료된 상태<li>**배포 실패**: 배포를 실패한 상태</ul></ul> |
| ④ **배포 로그** | 배포 단계별로 수집된 로그 표시 |

:::(Info) (참고)
* 배포를 취소하면 현재 실행 중인 단계까지 진행되고 이후 단계는 진행되지 않습니다.
* 배포 취소 또는 배포 실패 시 블루/그린 배포로 생성된 Auto Scaling Group이나 서버는 자동으로 반납되지 않습니다. Auto Scaling Group 또는 서버가 더 이상 필요하지 않은 경우, 직접 해당 서비스에서 반납/삭제해 주십시오.
* Canary 수동 배포를 취소하는 경우, Canary 버전이 배포되지 않으며 Baseline, Canary 버전의 애플리케이션이 종료됩니다.
:::

### 배포 단계 상세 확인<a name="배포단계상세확인"></a>

배포 타깃별 배포 단계는 다음과 같습니다.

<table>
<thead>
  <tr>
    <th><center>배포 타깃</center></th>
    <th><center>배포 단계</center></th>
    <th><center>설명</center></th>
  </tr>
</thead>
<tbody>
  <tr>
    <td rowspan="4">Server 또는<br>Auto Scaling(기본)</br></td>
    <td>서버명</td>
    <td>배포 에이전트 상태 확인</td>
  </tr>
  <tr>
    <td><b>배포 전 실행</b></td>
    <td>배포 전 명령어 수행</td>
  </tr>
  <tr>
    <td><b>파일 배포</b></td>
    <td>설정한 경로에 파일 배포</td>
  </tr>
  <tr>
    <td><b>배포 후 실행</b></td>
    <td>배포 후 명령어 수행</td>
  </tr>
  <tr>
    <td rowspan="4">Auto Scaling(블루/그린)</td>
    <td><b>배포 준비</b></td>
    <td>블루/그린 배포를 위한 사전 준비 수행<br><li>새 Auto Scaling Group 생성<li>새 Auto Scaling Group 내 서버 생성 완료 대기</td>
  </tr>
  <tr>
  <td><b>새 그룹에 배포</b></td>
  <td>새 Auto Scaling Group 내 서버에 대해 배포 에이전트 상태 확인</td>
  </tr>
  <tr>
  <td><b>새 그룹 검증</b></td>
  <td>새 Auto Scaling Group 검증<li>새 Auto Scaling Group 내 생성된 서버를 로드밸런서에 연결<li>로드밸런서 헬스 체크가 정상인지 확인(모든 헬스 체크를 성공해야 다음 단계로 진행, 타임 아웃(1시간) 내 헬스 체크를 실패할 경우 배포는 실패로 종료)</td>
  </tr>
  <tr>
  <td><b>배포 마무리</b></td>
  <td>블루/그린 배포 마무리 수행<li>기존 그룹 내 서버에 설정된 값에 때라 기존 Auto Scaling Group 내 서버 처리<li>기존 Auto Scaling Group에 연결된 Cloud Insight 이벤트 존재 시 이벤트 복사</td>
  </tr>
  <tr>
    <td rowspan="2">Ncloud Kubernetes Service</td>
    <td><b>배포 준비</b></td>
    <td>배포 준비<li>kubectl 로드<li>클러스터 접근<li>매니페스트 파일 다운로드<li>매니페스트 파일 로드</td>
  </tr>
  <tr>
    <td><b>배포</b></td>
    <td>배포 진행</td>
  </tr>
  <tr>
    <td rowspan="2">Object Storage</td>
    <td><b>배포 준비</b></td>
    <td>배포 준비<li>백업 파일 다운로드<li>백업 파일 압축<li>백업 파일 업로드</td>
  </tr>
  <tr>
  <td><b>배포</b></td>
  <td>배포 진행<li>배포 파일 다운로드<li>배포 파일 압축 해제<li>배포 파일 업로드</td>
  </tr>
</tbody>
</table>

### Canary 분석 리포트 확인<a name="Canary분석리포트확인"></a>

배포 전략이 **Canary**이면서 분석 방법이 **자동**인 경우, Canary 분석 리포트를 확인할 수 있습니다.

배포 작업 결과 화면에서 **Canary 분석 리포트**의 **리포트**를 클릭해 주십시오. Canary 분석 화면이 나타납니다.

Canary 분석 화면은 다음과 같이 구성되어 있습니다.

![sourcedeploy-use-deploy_canary_ko](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/sourcedeploy-use-deploy_canary_ko.png)

| 영역 | 설명 |
| ---- | ---- |
| ① 분석 단계 | <li>[Canary 자동 분석 설정](/docs/sourcedeploy-use-scenario#Canary자동분석설정) 시 설정한 분석 시간, 분석 주기로 분석 단계 결정<li>분석 데이터는 누적되어 분석<br> <예시> 분석 시간이 10분이고 분석 주기가 3분인 경우, 10분 동안 3분마다 총 4번의 분석 단계 점수가 나오며 마지막 분석 단계 시간은 1분 |
| ② 분석 점수| 분석 단계 점수 표시<li>해당 점수가 분석 성공 점수 이상이 되어야 성공이며, 분석에 실패할 경우 다음 분석 미진행 |
| ③ 분석 정보| 분석 시간 및 분석 성공 점수(**Pass**), Metric 수집 주기(**Step**) 표시 |
| ④ Metric 정보| [Canary 자동 분석 설정](/docs/sourcedeploy-use-scenario#Canary자동분석설정) 시 설정한 Metric과 Weight(가중치) 표시<li>Metric 클릭 시 Canary 분석 결과 표시 |
| ⑤ 분석 결과 목록 | Canary 분석 결과 표시<li>**종류**: **Baseline**(Baseline 버전 쿼리의 질의 결과), **Canary**(Canary 버전 쿼리의 질의 결과)<li>**시작 시간**/**종료 시간**: 분석이 시작된 시간/완료된 시간<li>**Count**: 분석 시간 동안 나온 실제 데이터 개수<li>**Avg**: 데이터 평균 값<li>**Max**: 데이터 최댓값<li>**Min**: 데이터 최솟값 |
| ⑥ **Element 결과** | Prometheus 질의 결과에서 나온 데이터의 Element 값 표시<li>Baseline과 Canary 질의 결과의 Element가 같아야 정상적으로 분석 진행<li>클릭하여 Element 확인 |
| ⑦ **편차** | Baseline 값 대비 Canary 값의 증가/감소율 표시 |
| ⑧ **결과** | Baseline 기준 Canary의 편차로 계산된 결과 표시<li>[Metric 생성](/docs/sourcedeploy-use-scenario#Metric생성) 시 설정한 성공 기준에 따라 결과(성공/실패) 결정<ul><ul><li>Baseline 버전의 결과와 Canary 버전의 결과가 같을 경우 성공(오차 범위 5%)<br><예시> -5≤편차≤+5 일 경우, 성공으로 결정</ul></ul> |

:::(Info) (참고)
* Canary 분석 리포트는 설정된 Prometheus의 보관 주기 동안만 확인할 수 있습니다.
* 분석 단계 점수 계산 방법
  * Metric 점수: (성공한 질의 결과/전체 질의 결과)*(메트릭 가중치)<br><예시>
    * 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
:::