Pilot 문제 해결

데이터와 권한

Editor는 기본으로 로컬 seed data를 사용하지만 운영 데이터 미리보기도 제공할 수 있습니다. Deploy는 기본 또는 배포 브랜치의 실제 데이터를 사용합니다. Main의 Production data에서 한 액션은 Editor에서도 실제 객체를 바꿉니다. 시험하려면 적절한 배포 브랜치를 선택하되 객체 편집은 Main으로 병합되지 않고 외부 부수 효과는 별도 규칙을 따른다는 점을 확인합니다.

배포 권한 오류에서는 프로젝트 Editor 권한, 앱 폴더의 Developer Console 생성 권한, 조직의 연결 OAuth 클라이언트 생성 권한, 도메인 승인 완료를 확인합니다. OAuth 권한은 보통 Third-party application administrator가 관련됩니다. 프로젝트 보안 표지가 데이터셋 생성을 막는지도 확인합니다. 조건을 충족해도 실패하면 브라우저 콘솔의 상세 오류를 관리자에게 전달합니다.

로그와 빌드

탭 옆 점 세 개 메뉴에서 Pilot diagnostics > Pilot logs를 엽니다. 최근 500행을 표시하며 Copy logs로 복사하거나 Code 링크에서 전체 로그를 봅니다.

Preview 빌드 오류는 메시지에서 누락 import, 자료형 불일치나 문법 오류를 확인하고 Fix with Pilot로 수정을 요청합니다. 해결되지 않으면 대화에서 실제 오류를 설명하고 개발 서버 로그를 함께 조사합니다.

컨테이너 시작은 자원 준비와 의존성 설치에 따라 시간이 걸립니다. 상태 표시의 Pilot status가 Disconnected이면 새로고침합니다. 의존성 및 서버 오류를 진단하고 지속되면 관련 로그와 함께 Palantir Support에 문의합니다.

npm 설치 실패는 상태 표시의 Fix with Pilot, 로그 확인, 대화의 Reinstall npm dependencies 순으로 조사할 수 있습니다.

배포가 되지 않을 때

Deployability는 배포 시험 오류 또는 로컬 온톨로지 정의 로드 실패를 보여 줍니다. 해당 Fix with Pilot을 사용하고 Ontology 탭의 자료형 및 편집 권한 오류도 따로 확인합니다. Deployable이어도 의존성, 서버와 릴리스 CI가 성공했다는 뜻은 아닙니다. 수정 후 배포를 다시 진행하며 보호 코드 브랜치는 편집 브랜치 제안으로 수정합니다.

배포 브랜치와 Main의 액션 RID가 다를 수 있습니다. 병합 후 Main으로 전환하고 참조 오류가 남으면 Pilot에 Main 식별자로 액션 참조를 갱신하도록 요청합니다.

위젯 표시와 구성

빈 프레임이나 Unable to load widget preview는 시간 초과나 브라우저 차단일 수 있습니다. 먼저 실제 오류를 확인합니다. Content Security Policy 위반이면 관리자가 필요한 컨테이너 origin을 검토하도록 요청합니다. 빌드, 의존성과 선택 위젯도 확인합니다.

Workshop에서 위젯이 보이지 않으면 Display > Row height를 확인합니다. 컨테이너 전체 높이를 쓰는 위젯은 Auto (max)에서 0 높이가 될 수 있으므로 Flex 또는 적절한 Absolute 높이를 사용하거나 내용 기반 크기로 수정합니다. 레이아웃을 저장하고 View에서 실제 조작을 확인합니다. divider 높이 오류도 영향받는 컴포넌트가 보이고 사용 가능한지 먼저 조사합니다.

매개변수나 이벤트 변경은 Reload widget dev mode 후 적용됩니다. Reset으로 구성 입력은 비워졌는데 화면 값이 남아 있어도 이 재로딩을 수행하고 확인합니다.

제어가 없거나 비활성화된 경우

안내문을 확인합니다. Pilot이나 저장소 작업 진행 중, 보호 또는 삭제된 코드 브랜치, 미지원 저장소 기능, 현재 인스턴스 또는 Pilot 버전에서 제공되지 않는 기능, 적합한 모델 부재 등이 원인일 수 있습니다.

운영 데이터 미리보기 제공이 별도 production-data analysis 제공을 의미하지는 않습니다. 분석은 지원 환경과 기능 설정이 필요합니다. 검토창에서 분석을 찾지 못하면 새로 생성하도록 요청하고 객체 읽기 실패는 권한 및 데이터 오류를 확인한 뒤 다시 시도합니다.