PlaidCloud Git에서 Dash 앱 배포하기
이 문서는 내 컴퓨터에 있는 Dash 앱 코드를 실시간 URL로 서비스하기까지의 전체 과정을 설명하며, 워크스페이스에 내장된 관리형 Git 서비스인 PlaidCloud Git 을 소스로 사용합니다. PlaidCloud Git은 관리형이므로 앱을 배포할 때 사용하는 연결에는 서버 URL, 사용자 이름, 토큰이 필요 없습니다. PlaidCloud가 사용자를 대신하여 인증합니다.
과정은 다섯 단계로 이루어집니다.
- 최소한의 Dash 앱을 작성합니다.
- 앱을 PlaidCloud Git 리포지토리에 올립니다.
- 관리형 PlaidCloud Git 연결을 만듭니다.
- 리포지토리를 가리키는 Dash 앱을 게시합니다.
- 서비스 중인 앱을 열고, 시작되지 않으면 빌드 로그를 확인합니다.
이 안내는 PlaidCloud Git에서 Panel 앱 배포하기와 거의 같습니다. 두 앱 모두 Git에서 빌드되어 같은 방식으로 서비스되는 서버 측 Python 앱이기 때문입니다. 차이는 앱 코드 자체와 게시 대화 상자의 필드 하나뿐입니다.
시작하기 전에
섹션 제목: “시작하기 전에”- 워크스페이스에서 Git을 열어 PlaidCloud Git에 접근할 수 있는지 확인합니다. 기본적으로 워크스페이스의 조직에는
apps리포지토리가 있으며, Dash 앱에도 이 리포지토리를 사용하면 됩니다. - 내 컴퓨터에서 코드를 푸시하려면 로컬에
git이 설치되어 있어야 합니다. Git 웹 UI에서 파일을 추가할 수도 있습니다.
1. 최소한의 Dash 앱 작성하기
섹션 제목: “1. 최소한의 Dash 앱 작성하기”앱에는 Dash 앱을 만들고 Flask 서버를 노출하는 Python 파일인 진입점이 필요합니다. 추가 패키지가 필요하면 리포지토리 루트 또는 진입점 옆에 requirements.txt 를 둘 수도 있습니다.
apps/├── app.py # entry point — exposes `server`└── requirements.txt # optional; extra dependencies (repo root or next to app.py)app.py를 만듭니다.
import plaidcloud_dash as pcdfrom dash import Dash, Input, Output, html
app = Dash(__name__) # picks up DASH_URL_BASE_PATHNAME from the platform automaticallyserver = app.server # the platform imports this and wires per-user sign-in for you
app.layout = html.Div( [ html.H1("Hello from PlaidCloud Git"), html.P(id="whoami"), html.Button("Who am I?", id="whoami-btn", n_clicks=0), ])
@app.callback(Output("whoami", "children"), Input("whoami-btn", "n_clicks"))def _whoami(n_clicks): if not n_clicks: return "" return f"Signed in as {pcd.current_user()!r}"
if __name__ == "__main__": app.run(debug=True)이것으로 완전한 앱이 됩니다. dash, plotly, dash-mantine-components, dash-ag-grid와 PlaidCloud 클라이언트 라이브러리(plaidcloud-rpc, plaidcloud-utilities)는 미리 설치되어 있으므로 requirements.txt에는 추가 패키지만 나열하십시오. Dash(__name__)에 requests_pathname_prefix 또는 url_base_pathname을 전달하지 마십시오. 플랫폼이 DASH_URL_BASE_PATHNAME을 통해 URL 접두사를 자동으로 설정하므로, 둘 다 설정하면 시작할 때 구성 오류가 발생합니다. 전체 앱 규약과 데이터 액세스 도우미는 앱 규약과 Dash 앱에서 데이터와 로그인한 사용자 읽기를 참조하십시오.
2. PlaidCloud Git 리포지토리에 앱 올리기
섹션 제목: “2. PlaidCloud Git 리포지토리에 앱 올리기”워크스페이스에 이미 있는 apps 리포지토리를 사용하거나 새 리포지토리를 만드십시오. 그런 다음 코드를 리포지토리에 올립니다.
PlaidCloud를 통해 로그인하기 때문에 Git 계정에는 별도의 비밀번호가 없습니다. write:repository 권한이 있는 개인 액세스 토큰을 생성(아바타 → 설정 → 애플리케이션)하고, 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 dash app"git push리포지토리 경로인 <org>/apps를 기록해 두십시오. <org>는 워크스페이스의 조직 이름입니다. 이 경로는 다음 단계에서 입력합니다. 클론, 커밋, 푸시에 관한 자세한 내용은 리포지토리에 있습니다.
여기서 사용하는 토큰은 사용자가 코드를 푸시하기 위한 용도일 뿐입니다. 다음에 만들 연결은 관리형이므로 토큰이 필요 없습니다. 두 가지를 혼동하지 마십시오.
3. 관리형 PlaidCloud Git 연결 만들기
섹션 제목: “3. 관리형 PlaidCloud Git 연결 만들기”연결은 Dash 배포에 코드가 어디에 있는지 알려 줍니다. PlaidCloud Git의 연결은 관리형이므로 PlaidCloud가 호스트와 자격 증명을 제공하며, 사용자는 리포지토리 대상만 입력하면 됩니다. 서버 Panel 앱이 사용하는 연결 유형과 같습니다.
- Tools > Connections를 열고 새 연결을 클릭한 다음 PlaidCloud Git을 선택합니다.
- 연결에 계정 이름을 지정합니다(예:
Apps Repo). - Repository Path를
<org>/apps(2단계에서 기록해 둔 경로)로 설정하고 기본 브랜치를main으로 설정합니다. 앱이 하위 디렉터리에 있지 않다면 시작 경로는 비워 둡니다. - 만들기를 클릭합니다.
서버 URL, 사용자, 비밀번호, SSL/SSH 필드는 없습니다. PlaidCloud Git은 관리형이므로 플랫폼이 호스트와 인증을 처리합니다. 연결의 사용법과 보안 모델(워크스페이스에서 누가 사용할 수 있는지)을 포함한 전체 양식은 PlaidCloud Git 연결을 참조하십시오.
4. Dash 앱 게시하기
섹션 제목: “4. Dash 앱 게시하기”이제 Dash 배포가 해당 연결을 가리키도록 설정합니다.
- 앱을 열고 새 앱 > Dash 앱을 선택합니다.
- 디렉터리 설정에서 앱 이름과 URL 슬러그를 설정합니다. 슬러그는 앱의 URL이자 내부 이름이므로 소문자, 숫자, 하이픈만 사용하고 문자로 시작하며 40자 이하로 지정하십시오(예:
hello-dash). 선택 사항인 메모에는 앱에 대한 설명을 적습니다. - Git 연결 및 게시 감시기에서 다음을 설정합니다.
- Git 연결 — 3단계에서 만든 PlaidCloud Git 연결입니다.
- 브랜치 —
main입니다. 이 브랜치에 푸시하면 앱이 자동으로 다시 빌드되고 재배포됩니다. - 진입점 —
app.py입니다.
- 런타임에서 CPU, 메모리, 유휴 시간(분) 설정을 선택합니다. 로그인하지 않고도 앱에 접근할 수 있어야 하는 경우에만 공개 액세스 허용을 선택하십시오. 디자인 설정은 없습니다. 이는 Panel 전용 옵션입니다.
- 고급 (임베디드 서비스) — 선택 사항입니다. 앱을 다른 사이트에 임베드하는 경우가 아니면 비워 둡니다.
- 게시를 클릭합니다.
5. 앱 열기 및 시작되지 않을 때 로그 확인하기
섹션 제목: “5. 앱 열기 및 시작되지 않을 때 로그 확인하기”게시하면 앱이 빌드됩니다. PlaidCloud가 브랜치를 클론하고, requirements.txt를 설치하고, platform-dash-base 이미지에서 컨테이너 이미지를 빌드합니다. 상태는 앱 목록에 표시되며 자동으로 업데이트됩니다.
- 상태가 준비됨이 되면
https://<your-tenant-host>/serve/<slug>/에서 앱을 엽니다. 유휴 상태였던 앱에 처음 요청하면 앱이 시작되며, 그동안 PlaidCloud 로딩 화면이 잠시 표시됩니다. - 빌드가 실패하면 앱을 열고 Build 로그를 확인하십시오. 누락된 종속성이나 가져오기 오류가 여기에 표시됩니다. 각 상태의 의미, 로그를 읽는 방법, 다시 빌드하는 방법은 Dash 앱 사용하기를 참조하십시오.
이후에는 연결된 브랜치에 푸시할 때마다 앱이 자동으로 다시 빌드되고 재배포됩니다. app.py를 수정하고 git push하면 변경 사항이 바로 적용됩니다. (앱이 잠겨 있으면 잠금을 해제할 때까지 푸시가 건너뛰어집니다. Dash 앱 사용하기를 참조하십시오.)
다음 단계
섹션 제목: “다음 단계”- Dash 앱에서 데이터와 로그인한 사용자 읽기 — 앱을 보는 사람의 권한으로 PlaidCloud 데이터를 쿼리합니다.
- Dash 앱 사용하기 — 빌드 상태, 로그, 잠금, 앱 제거를 다룹니다.
- PlaidCloud Git 연결 — 연결 양식 전체, 사용법, 보안 모델을 설명합니다.
- 리포지토리 — PlaidCloud Git의 브랜치, 토큰, 협업을 다룹니다.