VS Code에서 전역 브랜치 사용

전역 브랜치(Global branch)는 여러 Palantir 앱의 변경을 함께 개발하고 시험하는 단위입니다. Code Repositories 브랜치는 저장소의 Git 브랜치입니다. 전역 브랜치는 해당 저장소의 기본 브랜치를 기반으로 만들어야 합니다.

지원 저장소는 Python transforms, TypeScript v1/v2 및 Python functions, 그리고 전역 브랜치 구성을 마친 OSDK React 앱입니다. 공통 브랜치 생성과 체크아웃은 플랫폼 작업공간 및 로컬 Palantir 확장에서 사용할 수 있습니다. 실행/미리보기 통합 기능은 각 저장소와 환경의 지원 범위를 따릅니다.

브랜치 선택기

Palantir 패널의 선택기는 Code와 Global 탭에서 두 종류의 브랜치를 관리합니다.

플랫폼의 지원 저장소를 열면 Code 페이지 아래에 파란 branch taskbar가 나타납니다. taskbar와 터미널, Command Palette 및 편집기의 활성 브랜치를 동기화합니다.

branch taskbar는 플랫폼 VS Code 작업공간에만 있습니다. 로컬 VS Code에서는 Palantir 확장의 선택기를 사용합니다.

생성

다음 진입점에서 생성 대화상자를 열 수 있습니다.

• 작업공간의 branch taskbar에서 새 브랜치 생성
• Palantir 패널의 Global 탭에서 생성
• Command Palette의 Palantir: Create Global Branch
• 작업공간 저장소의 Branches 페이지

Command Palette 단축키는 macOS Cmd+Shift+P, Windows/Linux Ctrl+Shift+P입니다. taskbar를 제외한 확장 및 Command Palette 경로는 로컬 환경에서도 사용할 수 있습니다.

체크아웃

작업공간 taskbar, Palantir 패널 Global 탭 또는 Palantir: Checkout Global Branch 명령을 사용합니다. taskbar 외의 진입점은 같은 선택기를 열며 브랜치를 다음 구역으로 묶습니다.

• main
• 이 저장소를 포함한 내 브랜치
• 내 브랜치
• 다른 모든 브랜치

선택한 브랜치에 저장소가 아직 없으면 저장소 추가를 확인한 뒤 체크아웃합니다. 미커밋 변경이 있으면 먼저 해결하도록 안내하며 변경을 정리하기 전에는 체크아웃이나 브랜치 추가를 진행하지 않습니다.

Python transform

Preview와 Build 패널은 현재 체크아웃한 브랜치를 대상으로 실행합니다. 브랜치 이름뿐 아니라 입력과 출력이 어떤 브랜치 상태를 사용하는지도 확인합니다.

함수

지원 TypeScript v1/v2 및 Python 함수 저장소의 Live preview, Published preview와 Resource imports 패널은 활성 전역 브랜치의 문맥을 사용합니다. 각 패널로 브랜치의 자원을 읽고 게시한 함수 버전을 미리보거나 온톨로지 자원을 가져옵니다.

TypeScript v2와 Python 함수에서 브랜치의 스키마에 맞춰 함수 코드를 수정하려면 저장소에 로컬 Ontology SDK가 있어야 합니다. 로컬 SDK가 없는 저장소에서도 브랜치의 특정 함수 버전을 참조할 수 있지만, 브랜치 스키마를 사용한 코드 수정은 지원하지 않습니다.

작업공간 Tags 페이지 또는 확장의 Tag Version을 사용하면 현재 전역 브랜치에 함수 버전 태그를 만듭니다. 함수의 소비, 리베이스와 병합은 함수 브랜치를 따릅니다.

OSDK React 앱

저장소를 전역 브랜치에 추가하기 전에 기본 브랜치에서 Developer Console의 브랜치 통합을 구성해야 합니다. 이후 브랜치의 온톨로지 자원과 함께 앱을 개발하고 개발 서버 또는 PR 미리보기로 시험합니다.

브랜치에서 SDK를 생성하고 의존성을 동기화하는 절차도 위 Developer Console 흐름을 사용합니다. 전역 브랜치를 선택하는 것과 앱의 필요한 브랜치 연동 설정을 마치는 것은 별도입니다.