Pilot 코드 브랜치와 변경 제안

Pilot 코드 브랜치는 저장소 파일을 분리하여 개발하고 비교 및 제안 병합을 수행하는 단위입니다. 온톨로지 정의를 배포하는 Foundry 브랜치와 별개입니다. 코드 브랜치 전환은 미리보기의 데이터소스를 바꾸지 않습니다.

브랜치 생성과 전환

머리글에서 버전 선택기 왼쪽의 코드 브랜치 선택기를 엽니다. 작업 중인 프롬프트가 있으면 완료를 기다리거나 입력 옆 Stop을 누릅니다. 유지할 변경을 저장하고 미저장 변경을 해결한 뒤 저장소 기본 코드 브랜치를 선택합니다. Create new code branch에서 이름을 입력하고 Create code branch를 누르면 새 브랜치로 전환됩니다.

기존 브랜치는 같은 선택기로 돌아갈 수 있습니다. 삭제된 브랜치에서는 기존 유효한 브랜치로 전환해야 편집을 계속할 수 있습니다.

저장 버전과 되돌리기

코드 브랜치 오른쪽, Preview 왼쪽의 v4 같은 버전 표시를 누릅니다. v5*의 별표는 현재 상태가 Pilot 버전으로 저장되지 않았음을 뜻합니다. 저장 버전과 현재 커밋 상태가 항상 같은 것은 아닙니다.

작업 진행 중이나 브랜치 제한에 따라 버튼이 비활성화될 수 있습니다. 버리기와 되돌리기는 미저장 작업을 없앨 수 있으므로 필요한 내용을 먼저 저장합니다. Pilot 저장 버전은 게시 릴리스가 아니며 배포 절차와 릴리스 태그가 따로 필요합니다.

코드 제안 만들기

브랜치의 변경을 저장하고 Changes에서 기준 브랜치와 차이를 확인합니다. 원본 및 대상 브랜치, 생성 코드와 지원 설정을 검토한 다음 Create proposal에서 제목과 설명을 입력하고 Create를 선택합니다. 비활성화되어 있으면 미저장 변경, 필요한 브랜치 동기화 또는 기준 대비 변경이 없는 상태 등을 안내문에서 확인합니다.

검토와 병합

탭 옆 Proposals의 Open/Closed 목록과 필터에서 제안을 찾습니다. 현재 코드 브랜치의 제안을 표시하므로 View proposal on a different branch가 나오면 필요한 작업을 저장한 뒤 원본 브랜치로 전환합니다.

제목, 설명, 브랜치와 파일 차이를 읽고 Comments에 전체 제안, 파일 또는 특정 행의 의견을 남깁니다. 지원되는 경우 Address all comments with Pilot이나 선택 댓글 처리로 수정을 요청하고 결과를 다시 검토합니다.

브랜치가 뒤처졌으면 Update branch with Pilot로 갱신과 충돌 해결을 요청한 뒤 결과 및 재실행된 검사를 확인합니다. Approve 또는 Reject로 검토를 남기고 검사 및 승인 정책을 충족하면 Merge를 선택합니다. 확인창에서 원본과 대상 브랜치를 확인하고 병합한 뒤 Merged를 기다립니다. 정책은 승인 필수, 거부 검토가 있을 때 병합 금지, 새 커밋 후 승인 무효화를 요구할 수 있습니다.

표시할 수 없는 제안은 View in Code Workspaces를 사용합니다. 병합 후 기본 코드 브랜치로 돌아가 배포 절차를 진행합니다.

보호 브랜치와 배포

보호 브랜치는 직접 코드 수정과 Ontology permissions 변경을 제한합니다. 계획은 세울 수 있으며 Implement on a branch로 편집 브랜치에서 실행합니다. 오류 수정이나 배포 파일 생성도 브랜치 제안이 필요할 수 있습니다. 정책 변경 권한이 있더라도 팀의 검토 요건을 따라야 합니다.

배포 전 코드는 저장소 기본 브랜치에, 필요한 온톨로지 변경은 별도의 Global Branching 제안으로 기본 온톨로지에 병합합니다. 코드 제안 병합만으로 앱 게시, 온톨로지 배포나 데이터소스 전환이 이루어지지는 않습니다.