PlaidCloud Git에서 Panel 앱 배포
이 문서는 로컬 컴퓨터의 Panel 앱 코드에서 라이브 URL까지의 전체 과정을 설명하며, 워크스페이스에 내장된 관리형 Git 서비스인 PlaidCloud Git 을 소스로 사용합니다. PlaidCloud Git은 관리형이므로 앱을 배포할 때 사용하는 연결에는 서버 URL, 사용자 이름, 토큰이 필요하지 않습니다. PlaidCloud가 사용자 대신 인증합니다.
다음 다섯 단계로 진행합니다.
- 최소한의 Panel 앱을 작성합니다.
- PlaidCloud Git 리포지토리에 넣습니다.
- 관리형 PlaidCloud Git 연결을 만듭니다.
- 리포지토리를 가리키는 서버 앱을 게시합니다.
- 제공되는 앱을 열고, 시작되지 않으면 빌드 로그를 확인합니다.
각 단계에는 해당 부분을 더 자세히 다룬 가이드로의 링크가 있으며, 이 문서는 이를 하나의 과정으로 연결합니다.
시작하기 전에
섹션 제목: “시작하기 전에”- 워크스페이스에서 Git을 열어 PlaidCloud Git에 접근할 수 있는지 확인하십시오. 기본적으로 워크스페이스의 조직에는
apps리포지토리(와udfs리포지토리)가 있으며, Panel 앱을 두기에 적합한 위치입니다. - 로컬 컴퓨터에서 코드를 푸시하려면 로컬에
git이 설치되어 있어야 합니다(Git 웹 UI에서 파일을 추가할 수도 있습니다).
1. 최소한의 Panel 앱 작성
섹션 제목: “1. 최소한의 Panel 앱 작성”앱에는 Panel 앱을 빌드하고 .servable()로 표시하는 Python 파일인 진입점이 필요하며, 선택 사항으로 추가 패키지를 위한 requirements.txt 를 리포지토리 루트나 진입점 옆에 둘 수 있습니다.
apps/├── app.py # entry point — calls .servable()└── requirements.txt # optional; extra dependencies (repo root or next to app.py)app.py를 만듭니다.
import panel as pn
pn.extension()
pn.pane.Markdown("# Hello from PlaidCloud Git 👋\n\nServed straight from your workspace repository.").servable()이것으로 완전한 앱입니다. PlaidCloud가 제공하는 것은 .servable() 호출입니다. panel, bokeh, PlaidCloud 클라이언트 라이브러리(plaidcloud-rpc, plaidcloud-utilities)는 미리 설치되어 있으므로 requirements.txt에는 추가 패키지만 나열하십시오. 더 풍부한 예제, 종속성, 라이트/다크 테마는 Panel 앱 만들기를 참조하십시오.
2. 앱을 PlaidCloud Git 리포지토리에 넣기
섹션 제목: “2. 앱을 PlaidCloud Git 리포지토리에 넣기”워크스페이스의 기존 apps 리포지토리를 사용하거나 새로 만드십시오. 그런 다음 코드를 그 안에 넣습니다. Panel Studio에서 빌드한 앱은 이미 apps의 폴더이므로 직접 만든 앱 옆에서 찾을 수 있습니다.
PlaidCloud를 통해 로그인하므로 Git 계정에는 별도의 암호가 없습니다. write:repository 권한이 있는 개인용 액세스 토큰을 생성(your avatar → Settings → Applications)하고, Git이 요청할 때 이를 암호로 사용하십시오. apps에 푸시하려면 Contributor 액세스가 필요합니다. Git 탭에 뷰어로 표시되면 워크스페이스 관리자에게 Git Contributors에 추가해 달라고 요청하십시오. Git 탭에서 리포지토리의 복제 주소 옆에 있는 복사 버튼을 사용한 다음 다음을 실행합니다.
git clone <clone URL>cd apps# add app.py (and requirements.txt), then:git add app.py requirements.txtgit commit -m "Add hello panel app"git push리포지토리 경로 <org>/apps를 기록해 두십시오. 여기서 <org>는 워크스페이스의 조직 이름입니다. 이 경로는 다음 단계에서 입력합니다. 복제, 커밋, 푸시에 대한 자세한 내용은 리포지토리에 있습니다.
여기서 사용하는 토큰은 사용자가 코드를 푸시하기 위한 것일 뿐입니다. 다음에 만들 연결은 관리형이며 토큰이 필요하지 않으므로 둘을 혼동하지 마십시오.
3. 관리형 PlaidCloud Git 연결 만들기
섹션 제목: “3. 관리형 PlaidCloud Git 연결 만들기”연결은 Panel 배포에 코드가 있는 위치를 알려 줍니다. PlaidCloud Git의 경우 연결은 관리형이며 PlaidCloud가 호스트와 자격 증명을 제공하므로 리포지토리 대상만 입력하면 됩니다.
- Tools > Connections를 열고 새 연결을 클릭한 다음 PlaidCloud Git을 선택합니다.
- 연결에 계정 이름을 지정합니다(예:
Apps Repo). - Repository Path를
<org>/apps(2단계에서 기록한 경로)로 설정하고 기본 브랜치를main으로 설정합니다. 앱이 하위 디렉터리에 있는 경우가 아니면 시작 경로는 비워 두십시오. - 만들기를 클릭합니다.
서버 URL, 사용자, 암호, SSL/SSH 필드는 없습니다. PlaidCloud Git은 관리형이므로 플랫폼이 호스트와 인증을 처리합니다. 연결의 사용법과 보안 모델(워크스페이스에서 누가 사용할 수 있는지)을 포함한 전체 양식은 PlaidCloud Git 연결을 참조하십시오.
이전 워크스페이스 빌드를 사용 중인가요? 양식에 아직 서버 URL이나 자격 증명 필드가 표시되면 비워 두십시오. 어느 쪽이든 플랫폼이 사용자 대신 인증합니다.
4. 서버 앱 게시
섹션 제목: “4. 서버 앱 게시”이제 서버 배포가 해당 연결을 가리키도록 설정합니다.
- 앱을 열고 새 앱 > 서버 기반를 선택합니다.
- 디렉터리 설정에서 앱 이름과 URL 슬러그를 설정합니다. 슬러그는 앱의 URL이자 내부 이름이므로 소문자, 숫자, 하이픈을 사용하고 문자로 시작하며 40자 이하여야 합니다(예:
hello-panel). - Git 연결 및 게시 감시기에서:
- Git 연결 — 3단계에서 만든 PlaidCloud Git 연결입니다.
- 브랜치 —
main입니다. 이 브랜치에 푸시하면 앱이 자동으로 다시 빌드되고 다시 배포됩니다. - 진입점 —
app.py입니다.
- 런타임에서 CPU, 메모리, 디자인(PlaidCloud의 현대적인 모양은 FAST), 유휴 시간(분) 창을 선택합니다. 로그인하지 않고도 앱에 접근할 수 있어야 하는 경우에만 공개 액세스 허용을 선택하십시오.
- 게시를 클릭합니다.
이 대화 상자의 모든 필드는 Panel 앱 만들기에 설명되어 있습니다.
5. 앱 열기, 시작되지 않으면 로그 확인
섹션 제목: “5. 앱 열기, 시작되지 않으면 로그 확인”게시하면 앱이 빌드됩니다. PlaidCloud가 브랜치를 복제하고, requirements.txt(리포지토리 루트와 앱 폴더에 있는 경우 모두)를 설치하고, 컨테이너 이미지를 빌드합니다. 상태는 앱 목록에 표시되며 자동으로 업데이트됩니다.
- 상태가 준비됨이면
https://<your-tenant-host>/serve/<slug>/에서 앱을 엽니다. 유휴 상태였던 앱에 처음 요청하면 앱이 시작되며, 그동안 PlaidCloud 로딩 화면이 잠시 표시됩니다. - 빌드가 실패하면 앱을 열고 빌드 로그를 확인하십시오. 누락된 종속성이나 가져오기 오류가 여기에 표시됩니다. 각 상태의 의미, 로그를 읽는 방법, 다시 빌드를 트리거하는 방법은 Panel 앱 사용을 참조하십시오.
이후에는 연결된 브랜치에 푸시할 때마다 앱이 자동으로 다시 빌드되고 다시 배포됩니다. app.py를 편집하고 git push하면 변경 사항이 라이브로 적용됩니다. (앱이 잠겨 있으면 잠금을 해제할 때까지 푸시를 건너뜁니다. 앱 잠금을 참조하십시오.)
다음 단계
섹션 제목: “다음 단계”- Panel 앱 만들기 — 더 풍부한 예제, 종속성, 라이트/다크 테마
- PlaidCloud Git 연결 — 전체 연결 양식, 사용법, 보안 모델
- 데이터 및 로그인한 사용자 읽기 — 앱을 보는 사용자의 권한으로 PlaidCloud 데이터를 쿼리합니다
- 리포지토리 — PlaidCloud Git의 브랜치, 토큰, 협업