워크플로 사용 준비

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

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

주의

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

워크플로 정의 파일

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

.sourceband/workflows/*.yaml

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

워크플로 구성 요소

액션(Action)

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

자세한 액션 내용은 워크플로 포맷-YAML 문서를 참고해주십시오.

액션 그룹(Action Group)

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

자세한 액션 그룹 내용은 워크플로 포맷-YAML 문서를 참고해주십시오.

트리거(Triggers)

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

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

자세한 트리거 내용은 워크플로 포맷-YAML 문서를 참고해주십시오.

워크플로 상태

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

워크플로 사용 준비

리포지토리 연동

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

주의

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

워크플로 관리 방식

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

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