콘텐츠로 이동

Panel 앱 사용

게시된 모든 앱은 앱 화면에 런타임, 상태, 슬러그, 타임스탬프와 함께 표시됩니다. 가장 왼쪽 열에서는 앱을 열 수 있고, 나머지 행 아이콘으로는 실수로 인한 변경을 막기 위해 앱을 잠그거나, 편집하거나, 제거할 수 있으며, 서버 앱의 경우 다시 빌드하고, 로그를 보고, 사용 지표를 볼 수 있습니다. 열기 아이콘에는 앱의 런타임이 반영되므로 WASM 앱과 서버 앱을 한눈에 구분할 수 있습니다.

서버 앱의 상태 열은 빌드 상태를 추적하며, 빌드가 진행되는 동안 목록이 자동으로 새로 고쳐집니다.

  • 빌드 중… — PlaidCloud가 리포지토리를 컨테이너로 빌드하고 있습니다. 앱에는 아직 URL이 없습니다.
  • 준비됨 — 빌드가 성공했습니다. 앱의 URL이 활성화되고 행에 열기 아이콘이 나타납니다.
  • 실패 — 빌드가 완료되지 않았습니다. 진입점과 브랜치를 확인한 다음 앱을 편집하여 다시 게시하십시오.

WASM 앱은 빌드 단계가 없으며 게시되는 즉시 사용할 수 있습니다.

서버 앱 행의 다시 빌드 아이콘을 클릭하면 설정을 변경하지 않고 앱을 다시 빌드하고 재배포합니다. PlaidCloud가 같은 브랜치와 진입점을 다시 빌드하는 동안 앱의 상태는 빌드 중… 상태로 돌아갔다가, 새 빌드가 활성화되면 다시 준비됨으로 바뀝니다.

종속성 변경, 기본 이미지 업데이트 또는 일시적인 빌드 실패 후에 다시 빌드를 사용하십시오. 서버 앱을 편집하고 저장해도 다시 빌드되지만, 다시 빌드하는 데 편집 양식을 열 필요는 없습니다.

변환된 Alteryx 앱을 위해 생성된 입력 양식인 App Runner 앱의 경우 다시 빌드와 편집 내용 저장 시 먼저 생성된 파일을 현재 App Runner 버전으로 새로 고친 다음 빌드합니다. PlaidCloud 자체가 업데이트될 때도 잠기지 않은 모든 App Runner 앱에 대해 같은 작업이 수행되며, 잠긴 앱은 잠금을 해제한 후 다시 빌드해야 합니다.

앱 행의 잠금 아이콘을 클릭하면 실수로 인한 변경으로부터 앱을 보호합니다. 앱이 잠겨 있는 동안에는 다음과 같이 동작합니다.

  • 편집, 제거, 다시 빌드는 실행되지 않으며 앱이 잠겨 있다고 알려 줍니다.
  • 서버 앱의 브랜치에 푸시해도 다시 빌드되지 않습니다. 앱의 잠금을 해제할 때까지 자동 다시 빌드를 건너뜁니다. 건너뛴 푸시에서는 빌드가 실행되지 않으므로 앱의 빌드 로그에 새 항목이 나타나지 않습니다. 잠금을 해제한 후 다시 푸시하거나 다시 빌드를 사용하여 변경 사항을 반영하십시오.
  • 앱 열기, 로그 보기, 사용 지표 보기는 모두 계속 작동합니다. 잠금은 변경만 막을 뿐 앱을 보는 사용자를 막지 않습니다.

아이콘을 다시 클릭하면 잠금이 해제됩니다. 아이콘에는 앱의 현재 상태가 표시되며, 잠겨 있으면 닫힌 모양이고 그렇지 않으면 열린 모양입니다.

잠금은 워크플로와 워크플로 단계의 잠금과 마찬가지로 잘못된 편집, 의도하지 않은 삭제, 시연 중인 앱에 대한 git 푸시와 같은 실수를 방지하는 장치입니다. 보안 제어가 아닙니다. Panel 앱을 편집할 수 있는 사용자는 누구나 잠금을 해제할 수도 있습니다.

잠금이 적용되지 않는 두 가지 경우가 있습니다. 잠글 때 이미 진행 중이던 빌드는 그대로 완료되어 활성화되며, WASM 앱의 파일은 문서 계정에 있으므로 해당 파일을 교체하면 잠긴 레코드를 건드리지 않고도 실행 중인 앱이 변경됩니다.

준비된 앱 행 시작 부분의 열기 아이콘을 클릭하면 새 탭에서 앱이 실행됩니다. 열기는 행의 ⋯ 메뉴에서도 첫 번째 항목입니다. 행 작업 메뉴를 참조하십시오.

  • 서버 앱은 https://<your-tenant-host>/serve/<slug>/에서 제공됩니다.
  • 열기 아이콘은 서버 앱이 준비됨 상태가 된 후에만 나타납니다.

서버 앱은 리소스를 절약하기 위해 유휴 상태에서 0으로 축소되므로, 유휴 기간 후 처음 열 때는 앱을 다시 시작해야 합니다. 이때 빈 탭 대신 PlaidCloud 로딩 화면이 표시되며, 앱 이름, 시작 중, 준비 중, 앱 로드 중 단계의 진행 상황, 워크스페이스 ID가 라이트 또는 다크 테마로 나타납니다. 앱이 준비되면(보통 몇 초, 콜드 스타트 시 최대 1분 정도) 자동으로 나타나며, 이후 다시 유휴 상태가 될 때까지 정상적으로 응답합니다.

앱을 주소 표시줄에서 복사한 링크나 알림 또는 다이제스트 메시지에 있는 링크 등 앱으로 연결되는 다른 링크로 열 때 앱이 깨어나는 동안에도 로딩 화면이 표시됩니다. 로그아웃된 상태에서 브라우저 탭으로 열면 먼저 로그인합니다.

앱을 시작할 수 없으면 로딩 화면이 계속 회전하는 대신 앱이 시작되지 않았다는 메시지와 중단된 단계를 알려 주는 내용으로 바뀌고 다시 시도 버튼이 표시됩니다. 이런 일이 계속되면 앱을 편집하여 진입점과 브랜치를 확인한 후 다시 게시하거나 PlaidCloud 관리자에게 문의하십시오.

서버 Panel 앱은 기본적으로 PlaidCloud의 최신 FAST 디자인을 사용하지만, 기존 CSS가 이에 의존하는 경우 앱의 디자인 설정에서 Panel의 기본값 스타일로 되돌릴 수 있습니다. 라이트, 다크 또는 보는 사용자가 전환할 수 있는 라이트/다크 스위치 중 어느 테마를 사용할지는 앱 템플릿에서 설정합니다. 패턴은 만들기 가이드의 테마 설정을 참조하십시오. 앱의 테이블이나 사용자 지정 스타일이 밝은 배경에 맞게 만들어졌다면 라이트로 고정하십시오.

서버 앱 행의 로그 보기 아이콘을 클릭하면 로그 뷰어가 열립니다. (WASM 앱은 브라우저에서만 실행되며 서버 로그가 없으므로 이 아이콘은 서버 앱 행에만 나타납니다.)

뷰어에는 두 개의 탭이 있습니다.

  • 런타임(처음에 표시) — 실행 중인 앱 자체의 출력으로, 앱이 기록하거나 출력하는 모든 내용과 처리되지 않은 오류가 포함됩니다. 앱이 0으로 축소된 후에도 유지되므로 이전 세션에서 수행된 작업을 검토할 수 있습니다.
  • 빌드 — 앱의 컨테이너를 빌드한 출력입니다. 빌드가 실패로 표시되는 이유(예: 설치되지 않는 종속성)를 확인할 때 사용하십시오.

각 탭에는 정보 / 경고 / 오류 필터, 다음 시점 이후 로그 시간 범위(최근 1시간부터 최대 30일 또는 전체), 새로 고침 버튼, 새 항목을 폴링하는 자동 새로 고침이 있습니다. 실행 중인 앱이나 진행 중인 빌드를 지켜볼 때 유용합니다. 가장 최근 항목이 먼저 나열됩니다.

빌드 출력을 캡처할 수 없었다면 빌드 탭이 비어 있는 대신 그 이유를 설명하는 짧은 메모를 표시합니다.

로그 테이블은 목록을 읽기 쉽게 유지하기 위해 긴 줄을 잘라서 표시합니다. 로그 행을 선택하면 테이블 옆에 세부 정보 창이 열려 해당 항목의 전체 메시지가 표시됩니다. 긴 오류 메시지나 전체 스택 트레이스처럼 테이블에 다 담기지 않는 내용을 잘리지 않고 읽는 가장 쉬운 방법입니다.

여러 로그 행을 한 번에 선택하고 복사를 클릭하면 클립보드에 복사됩니다. 앱을 디버깅하면서 AI 어시스턴트와의 대화에 로그를 붙여 넣거나, 팀 또는 PlaidCloud 지원팀에 보내는 메시지에 붙여 넣을 때 유용합니다.

앱이 보는 사용자를 로그인시키는 경우 각 로그 줄에는 해당 세션에서 발생시킨 사용자가 태그로 표시되므로 어떤 사용자가 특정 오류나 경고를 발생시켰는지 알 수 있습니다. 태그 지정은 최선의 노력으로 수행됩니다. 일부 프레임워크 및 시작 줄은 보는 사용자가 관여하기 전에 실행되므로 사용자가 표시되지 않을 수 있습니다.

서버 앱 행에서 로그 보기 옆에 있는 사용 지표 아이콘을 클릭하면 앱이 어떻게 사용되고 있는지 볼 수 있습니다. 이 보기에는 다음 내용이 요약됩니다.

  • 고유 사용자 — 앱을 연 서로 다른 사용자의 수입니다.
  • 세션 — 앱이 열린 횟수입니다.
  • 평균 및 중앙값 세션 기간 — 한 번 방문하는 데 대략 얼마나 걸리는지를 나타냅니다.
  • 마지막 사용 — 앱이 가장 최근에 열린 시점입니다.

요약 아래에는 사용자별 및 일별 분석이 표시되므로 누가 앱을 사용하는지, 시간에 따라 사용량이 어떻게 변하는지 확인할 수 있습니다.

기간은 근사치입니다. 서버 앱은 아무도 사용하지 않을 때 유휴 상태가 되어 축소되므로 세션의 정확한 종료 시점이 항상 관찰되지는 않습니다. 기간 수치는 정확한 측정값이 아니라 참고 자료로 활용하십시오.

앱 행의 연필 아이콘을 클릭하면 앱을 편집할 수 있습니다. 편집 양식은 앱의 런타임에 맞게 표시됩니다.

서버 앱에서는 이름, 슬러그, 브랜치, 진입점, CPU, 메모리, 디자인, 유휴 시간, 공개 플래그, 임베디드 서비스 도메인, 메모를 변경할 수 있습니다. Git 연결은 앱을 만든 후에는 고정되며 읽기 전용으로 표시됩니다. 저장하면 앱이 다시 빌드되며, 새 빌드가 준비될 때까지 상태는 빌드 중… 상태로 돌아갑니다.

앱 행의 빼기 아이콘을 클릭하고 확인하십시오. 앱을 삭제하거나 게시를 취소할 때는 항상 먼저 확인을 요청합니다. 서버 앱을 제거하면 빌드와 배포가 해체되고, WASM 앱을 제거하면 정적 파일의 게시가 취소됩니다. 앱의 URL은 즉시 작동하지 않게 됩니다.

MCP 도구 panel_deployment_manage는 더 이상 게시 취소를 제공하지 않습니다. 대신 이 목록에서 앱을 제거하십시오.