브랜치에서 변경하고 운영에 병합하기

Pipeline Builder의 브랜치는 파이프라인 로직을 따로 편집할 수 있는 버전 작업 공간입니다. 새 파이프라인은 main으로 시작합니다. 별도 브랜치에서 변경을 작성하고 검토한 뒤 main에 병합하면 운영 로직과 작업 중인 변경을 분리할 수 있습니다.

브랜치 범위

Pipeline Builder 브랜치는 해당 파이프라인에 한정됩니다. Global branch는 여러 애플리케이션의 변경을 한 브랜치에서 함께 관리합니다. 생성할 때 필요한 유형을 선택합니다.

Builder에서 만든 객체 유형은 브랜치의 Ontology Manager에서 수정할 수 없습니다. 파이프라인이 소유한 온톨로지 출력은 Builder의 관리 경로를 따릅니다.

Code Repositories와 같은 브랜치 이름을 사용하면 Builder의 입력 데이터셋을 그 이름의 브랜치에서 읽을 수 있습니다. 두 도구의 변환을 함께 변경할 때 사용합니다. 현재 브랜치에 빌드된 입력이 없으면 fallback 브랜치의 순서로 찾습니다.

새 브랜치 생성

위쪽 브랜치 드롭다운에서 Create new branch를 선택합니다.

이름을 지정하고 자동 생성한 Global Branch 이름을 그대로 쓰거나 변경합니다. 기본 구성에서 입력은 이 브랜치의 데이터를 사용하고 해당 브랜치가 없으면 main으로 fallback합니다. 별도 fallback 설정이 있으면 그 설정을 따릅니다.

Create로 main의 현재 상태를 복사하여 새 브랜치에서 작업합니다. 이후 같은 드롭다운으로 다른 브랜치에 이동할 수 있습니다.

브랜치 관리와 보관

Settings > Manage branches를 엽니다.

Active branches에는 현재 활성 브랜치가 표시됩니다. Archive한 브랜치는 그래프의 선택 목록에서 사라지고 복원 전까지 편집하거나 사용할 수 없습니다. 복원하려면 View archived branches를 열고 해당 항목의 Restore branch 아이콘을 선택합니다.

검토를 거치는 변경

Branch protection에서 Require proposals to update protected branches를 켜면 지정 브랜치를 직접 수정할 수 없고 별도 브랜치의 proposal로 병합해야 합니다.

Require at least one approval before merging into protected branches를 켜면 다른 사용자의 승인도 필요합니다. 유효한 승인자는 파이프라인 Edit 권한이 있으면서 해당 변경에 기여하지 않은 사용자입니다. 보호 정책에서 프로젝트 승인 정책과 보안 표지 변경의 추가 조건을 함께 확인합니다.

Proposal template에는 새 proposal의 본문에 넣을 Markdown 템플릿을 작성할 수 있습니다. Preview에서 내용을 확인하며 설정 후 생성하는 모든 proposal에 포함됩니다.

변경 이후의 작업

제안, 검토와 충돌 해결에서 변경을 비교하고 병합합니다. 단위 테스트는 정해진 입력으로 변환 결과를 확인하며, 데이터 기대 조건은 실제 출력의 요구를 빌드 때 검사합니다.

운영 갱신은 스케줄로 구성하고, 다른 환경에 설치 가능한 형태로 배포할 때는 Marketplace 패키징의 지원 범위와 입력 계약을 적용합니다.