---
title: "워크플로 사용 준비"
slug: "sourceband-workflow-use-spec"
updated: 2026-09-17T09:07:44Z
published: 2026-09-17T09:07:44Z
canonical: "guide.ncloud-docs.com/sourceband-workflow-use-spec"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 워크플로 사용 준비

VPC 환경에서 이용 가능합니다.

워크플로 기능을 통해 CI/CD 자동화와 파이프라인 구축이 가능합니다. 워크플로 정의는 시각적 편집기(Visual Editor) 또는 YAML을 사용해 구성할 수 있으며, SourceCommit 리포지토리와 연동하여 워크플로 정의 파일을 관리함으로써 누가 언제 어떤 작업을 했는지 이력을 추적할 수 있습니다. 변경 사항에 대한 리뷰나 롤백도 용이하게 수행할 수 있어 팀원 간 협업을 원활하게 하고, 빌드 및 배포 프로세스의 신뢰성도 높일 수 있습니다.

주의

- 워크플로 요금은 한시적으로 무료로 제공되며, 유료 전환 시 사전에 별도 공지로 안내될 예정입니다.

## 워크플로 정의 파일

워크플로는 `.yaml` 포맷으로 정의되며, SourceCommit 리포지토리의 다음 경로에 위치합니다.

```
.sourceband/workflows/*.yaml
```

워크플로마다 개별 YAML 파일로 관리되며, 파일명은 자유롭게 설정할 수 있습니다. 워크플로 정의 파일에 대한 자세한 내용은 [워크플로 포맷 - YAML](/docs/sourceband-workflow-use-format) 정의 문서를 참고 해주십시오.

## 워크플로 구성 요소

### 액션(Action)

액션은 워크플로 내에서 실행되는 작업 단위입니다. 워크플로는 여러 개의 액션을 포함하며, 각 액션은 순차적으로 또는 병렬로 구성 할 수 있습니다.

자세한 액션 내용은 [워크플로 포맷-YAML](/docs/sourceband-workflow-use-format#%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C-%EC%95%A1%EC%85%98-%EA%B8%B0%EB%B3%B8%EA%B5%AC%EC%A1%B0) 문서를 참고해주십시오.

### 액션 그룹(Action Group)

액션 그룹은 하나 이상의 액션을 묶은 단위로, 워크플로를 보다 구조적으로 구성하고 관리할 수 있게 도와줍니다. 액션 그룹 간의 의존성 설정도 가능하여, 특정 그룹이 완료된 후 다음 그룹이 실행되도록 조정할 수 있습니다.

자세한 액션 그룹 내용은 [워크플로 포맷-YAML](/docs/sourceband-workflow-use-format#%EC%95%A1%EC%85%98-%EA%B7%B8%EB%A3%B9-%EA%B8%B0%EB%8A%A5) 문서를 참고해주십시오.

### 트리거(Triggers)

워크플로 트리거는 특정 이벤트가 발생했을 때 워크플로 실행을 자동으로 시작할 수 있도록 해줍니다. 트리거는 다음 유형을 제공하고 있습니다.

- Push : 워크플로 정의 파일이 속한 리포지토리 특정 브랜치에 코드가 커밋(push)될 때 워크플로를 자동으로 실행하는 조건입니다.

자세한 트리거 내용은 [워크플로 포맷-YAML](/docs/sourceband-workflow-use-format#%EC%9B%8C%ED%81%AC%ED%94%8C%EB%A1%9C-%ED%8A%B8%EB%A6%AC%EA%B1%B0-%EC%84%A4%EC%A0%95) 문서를 참고해주십시오.

## 워크플로 상태

| 상태 | 설명 |
| --- | --- |
| **Active** | - 워크플로 정의 파일이 올바르고 실행 가능한 상태입니다. - 트리거가 없거나, 푸시 트리거에 현재 브랜치가 포함되어 있습니다. |
| **Inactive** | - 워크플로 정의 파일은 올바르지만 실행할 수 없는 상태입니다. - 푸시 트리거에 현재 브랜치가 포함되어 있지 않아, 해당 브랜치에서는 실행할 수 없는 상태입니다. - 예: 워크플로 파일이 main, develop 브랜치에 모두 존재하고, 트리거가 develop 브랜치만 설정되어 있으면, main 브랜치의 워크플로는 Inactive 상태가 됩니다. - 이를 통해 동일한 워크플로 정의가 여러 브랜치에 중복되더라도, 트리거 조건에 부합하는 브랜치에서만 실행되도록 보장합니다. |
| **Invalid** | - 워크플로 정의에 오류가 있어 실행할 수 없는 상태입니다. |

## 워크플로 사용 준비

### 리포지토리 연동

워크플로 정의 파일은 SourceCommit 소스 리포지토리에 저장되며, 워크플로를 생성하려면 SourceBand 프로젝트에 SourceCommit 리포지토리를 반드시 연동해주십시오. 연동 방법은 [SourceCommit 상품 연동](/docs/sourceband-use-sourcecommit)을 참고해주십시오.

주의

- 리포지토리 연동 시 유의사항
  - 리포지토리에 워크플로 정의 파일이 이미 존재하더라도 프로젝트에 연동한 직후에는 워크플로가 생성되지 않습니다.  

워크플로 정의 파일이 포함된 브랜치에서 커밋이 발생해야 생성됩니다.
- 리포지토리 연동 해제 시 유의사항
  - 리포지토리 연동을 해제하면, 리포지토리의 모든 워크플로가 삭제됩니다.
  - 단, 리포지토리 내의 YAML 파일은 삭제되지 않습니다.

## 워크플로 관리 방식

워크플로는 콘솔 UI 또는 Git CLI 방식 중 선택하여 관리할 수 있습니다:

| 방식 | 설명 |
| --- | --- |
| 콘솔 UI | - 콘솔에서 시각적으로 워크플로를 생성/수정/삭제하여 관리할 수 있습니다. - Visual 편집기와 YAML 편집기를 모두 지원합니다. |
| Git CLI | - Git CLI 를 이용하여 `.sourceband/workflows/` 폴더에 직접 YAML 파일을 생성/수정/삭제하여 관리할 수 있습니다. |