Skip to content
SaaS ERP SaaS ERP Docs

English {#english}

Control Plane — provisioning progress (operator)

Use the prego-control-plane React operator shell (/cp/*) to inspect tenant provisioning. Authentication: set cp_internal_key in sessionStorage to your INTERNAL_API_KEY (Bearer), same as other CP internal tools. See prego-control-plane-dashboard.

Important distinction

  • admin-web Launch shows a 10-line checklist (“Check resource”, …) driven by provision_ui_current_label and trace stages prego_ui_step_01 … prego_ui_step_10 (same axis as prego-control-plane provision-ui-steps).
  • GET /internal/onboarding-status exposes a coarser 5-step model (tenant record → … → callback). It is useful for a quick pipeline read, not a 1:1 copy of the 10 UI lines.

Which /cp page to open

RouteAPIUse when
/cp/tenantDirectory search + parallel provision-jobs, onboarding-status, allocation-decisions, provision-trace-detail, funnel-events (by trace_id)You want one screen for a single tenant_id: merged timeline and deep links to other /cp tools. See Tenant command center.
/cp/provision-traceGET /internal/provision-trace-detail?job_id= or ?trace_id=You need timeline + prego_ui_step_* (same axis as admin-web Launch). Optional URL search: ?job_id=…&trace_id=… prefills inputs and loads.
/cp/onboardingGET /internal/onboarding-status?job_id= and/or ?tenant_id=You want the 5-step summary (pending/done/failed per internal step keys).
/cp/infraGET /internal/provision-jobs, GET /internal/trace/:trace_id, etc.You need recent jobs, nodes, or raw trace events; use Provision jobs table → Open in Provision trace to jump to /cp/provision-trace with job_id prefilled.

Procedure (support)

  1. Collect trace_id (admin-web Launch “Support reference”), job_id, or tenant_id from the customer or CP email/logs.
  2. For parity with admin-web’s single-line step label: open /cp/provision-trace, enter job_id or trace_id, Load — confirm ordered stage values include prego_ui_step_XX in trace_events.
  3. For a quick coarse status: open /cp/onboarding, enter job_id and/or tenant_id, Load status.
  4. To find stuck/failed jobs: /cp/infra → Provision jobs tab → use Open in Provision trace on a row, or copy trace_id into the trace tab on the same page.

한국어 {#korean}

Control Plane — 프로비저닝 진행 확인 (운영자)

prego-control-plane React 운영자 셸(/cp/*)으로 테넌트 프로비저닝을 조회한다. 인증: 다른 CP internal 도구와 같이 sessionStorage의 **cp_internal_key**에 INTERNAL_API_KEY(Bearer)를 넣는다. 배포 URL·키 설명은 prego-control-plane-dashboard 참고.

구분 (중요)

  • admin-web Launch의 10줄 체크리스트는 provision_ui_current_label 및 트레이스 prego_ui_step_01 … prego_ui_step_10 축과 같다 (prego-control-plane provision-ui-steps와 동일 축).
  • **GET /internal/onboarding-status**는 더 거친 5단계 모델(테넌트 레코드 → … → 콜백)이다. 빠른 파이프라인 요약에는 적합하지만 10줄 UI와 1:1 대응은 아니다.

어떤 /cp 화면을 쓸지

경로API언제
/cp/tenant디렉터리 검색 + provision-jobs, onboarding-status, allocation-decisions, provision-trace-detail, trace_id 기준 funnel-events**한 tenant_id**에 대해 한 화면에서 타임라인·딥링크가 필요할 때. Tenant command center 참고.
/cp/provision-traceGET /internal/provision-trace-detail?job_id= 또는 ?trace_id=admin-web Launch와 같은 prego_ui_step_* 타임라인이 필요할 때. URL에 ?job_id=…&trace_id=…로 들어오면 입력칸 프리필 후 자동 Load.
/cp/onboardingGET /internal/onboarding-status5단계 요약(pending/done/failed)만 보면 될 때.
/cp/infraGET /internal/provision-jobs 등최근 job 목록·노드·trace 이벤트; Provision jobs 표에서 Open in Provision trace로 job_id가 채워진 **/cp/provision-trace**로 이동.

절차 (지원)

  1. 고객 또는 CP 로그·메일에서 trace_id, job_id, **tenant_id**를 확보한다.
  2. admin-web 한 줄 단계 라벨과 같은 축으로 보려면 **/cp/provision-trace**에서 job_id 또는 trace_id 입력 후 Load — trace_events의 **stage**에 **prego_ui_step_XX**가 순서대로 쌓이는지 확인한다.
  3. 거친 단계만 빠르게 보려면 **/cp/onboarding**에 job_id 및/또는 tenant_id 입력 후 Load status한다.
  4. 지연·실패 job 탐색은 /cp/infra → Provision jobs 탭에서 행의 Open in Provision trace를 쓰거나, **trace_id**를 같은 화면의 trace 탭에 붙여 넣는다.

관련

Help