콘텐츠로 이동
PlaidCloud

PlaidCloud Git에서 Panel 앱 배포하기

이 문서는 워크스페이스에 내장된 관리형 Git 서비스인 PlaidCloud Git 을 소스로 사용하여 컴퓨터에 있는 Panel 앱 코드에서 라이브 URL까지 이르는 전체 경로를 설명합니다. PlaidCloud Git은 관리형이므로 앱이 배포되는 연결에는 서버 URL, 사용자 이름 또는 토큰이 필요하지 않습니다. PlaidCloud가 대신 인증합니다.

다섯 단계가 있습니다.

  1. 최소한의 Panel 앱을 작성합니다.
  2. PlaidCloud Git 리포지토리에 넣습니다.
  3. 관리형 PlaidCloud Git 연결을 만듭니다.
  4. 리포지토리를 가리키는 서버 앱을 게시합니다.
  5. 제공되는 앱을 열고, 시작되지 않으면 빌드 로그를 읽습니다.

각 단계는 해당 부분의 자세한 가이드로 연결되며, 이 문서는 이를 하나의 경로로 엮은 것입니다.

시작하기 전에

섹션 제목: “시작하기 전에”
  • 워크스페이스에서 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 리포지토리를 사용하거나 새 리포지토리를 만드십시오. 그런 다음 코드를 넣습니다.

PlaidCloud를 통해 로그인하므로 Git 계정에는 별도의 비밀번호가 없습니다. 리포지토리 읽기 및 쓰기 범위로 개인 액세스 토큰을 생성(your avatar → Settings → Applications)하고, Git이 묻는 비밀번호로 사용하십시오. 리포지토리의 코드 버튼에서 HTTPS 복제 URL을 복사한 다음 다음을 실행합니다.

터미널 창
git clone https://<your-git-host>/<org>/apps.git
cd apps
# add app.py (and requirements.txt), then:
git add app.py requirements.txt
git commit -m "Add hello panel app"
git push

리포지토리 경로 <org>/apps를 기록해 두십시오. <org>는 워크스페이스의 조직 이름입니다. 다음 단계에서 이 경로를 입력합니다. 복제, 커밋, 푸시에 관한 자세한 내용은 리포지토리에 있습니다.

여기의 토큰은 본인이 코드를 푸시하는 용도일 뿐입니다. 다음에 만들 연결은 관리형이며 토큰이 필요하지 않습니다. 둘을 혼동하지 마십시오.

3. 관리형 PlaidCloud Git 연결 만들기

섹션 제목: “3. 관리형 PlaidCloud Git 연결 만들기”

연결은 Panel 배포에 코드가 있는 위치를 알려 줍니다. PlaidCloud Git의 경우 연결이 관리형이므로 PlaidCloud가 호스트와 자격 증명을 제공하며, 리포지토리 대상만 입력하면 됩니다.

  1. Tools > Connections를 열고 새 연결을 클릭한 다음 PlaidCloud Git을 선택합니다.
  2. 연결에 계정 이름을 지정합니다(예: Apps Repo).
  3. Repository Path를 <org>/apps(2단계에서 기록한 경로)로, 기본 브랜치를 main으로 설정합니다. 앱이 하위 디렉터리에 있지 않다면 시작 경로는 비워 두십시오.
  4. 만들기를 클릭합니다.

서버 URL, 사용자, 비밀번호 또는 SSL/SSH 필드가 없습니다. PlaidCloud Git은 관리형이므로 플랫폼이 호스트와 인증을 처리합니다. 연결의 사용법과 보안 모델(워크스페이스에서 누가 사용할 수 있는지)을 포함한 전체 양식은 PlaidCloud Git 연결을 참조하십시오.

이전 워크스페이스 빌드를 사용 중이신가요? 양식에 여전히 서버 URL 또는 자격 증명 필드가 표시되면 그대로 비워 두십시오. 어느 쪽이든 플랫폼이 대신 인증합니다.

4. 서버 앱 게시하기

섹션 제목: “4. 서버 앱 게시하기”

이제 서버 배포가 그 연결을 가리키도록 합니다.

  1. 내 Panel 앱을 열고 새 서버 앱을 클릭합니다.
  2. 디렉터리 설정 아래에서 앱 이름과 URL 슬러그를 설정합니다. 슬러그는 앱의 URL이자 내부 이름이므로 소문자, 숫자, 하이픈을 사용하고 문자로 시작하며 40자 이하여야 합니다(예: hello-panel).
  3. Git 연결 및 게시 감시기 아래에서 다음을 설정합니다.
    • Git 연결 — 3단계에서 만든 PlaidCloud Git 연결입니다.
    • 브랜치 — main입니다. 이 브랜치에 푸시하면 앱이 자동으로 다시 빌드되어 재배포됩니다.
    • 진입점 — app.py입니다.
  4. 런타임 아래에서 CPU, 메모리, 디자인(PlaidCloud의 현대적인 모양을 쓰려면 FAST), 유휴 시간(분) 을 선택합니다. 로그인 없이 앱에 접근할 수 있어야 하는 경우에만 공개 액세스 허용을 선택합니다.
  5. 게시를 클릭합니다.

이 대화 상자의 모든 필드는 Panel 앱 만들기에 설명되어 있습니다.

5. 앱 열기, 시작되지 않으면 로그 읽기

섹션 제목: “5. 앱 열기, 시작되지 않으면 로그 읽기”

게시하면 앱이 빌드됩니다. PlaidCloud가 브랜치를 복제하고, requirements.txt(있는 경우 리포지토리 루트와 앱 폴더의 것)를 설치하고, 컨테이너 이미지를 빌드합니다. 상태가 내 Panel 앱 목록에 표시되며 자동으로 업데이트됩니다.

  • 상태가 준비됨이면 https://<your-tenant-host>/serve/<slug>/에서 앱을 엽니다. 유휴 상태 이후의 첫 요청은 앱을 시작시킵니다(약 15초).
  • 빌드가 실패하면 앱을 열고 빌드 로그를 확인하십시오. 누락된 종속성이나 가져오기 오류가 여기에 표시됩니다. 각 상태의 의미, 로그를 읽는 방법, 다시 빌드하는 방법은 Panel 앱 사용하기를 참조하십시오.

이후에는 연결된 브랜치에 푸시할 때마다 앱이 자동으로 다시 빌드되어 재배포됩니다. app.py를 편집하고 git push하면 변경 사항이 라이브로 반영됩니다. (앱이 잠겨 있지 않은 경우에 한합니다. 앱 잠그기를 참조하십시오. 잠겨 있으면 잠금을 해제할 때까지 푸시가 건너뛰어집니다.)

다음 단계

섹션 제목: “다음 단계”