Wdrażanie aplikacji Panel z PlaidCloud Git
To kompletna ścieżka od kodu aplikacji Panel na Twoim komputerze do działającego adresu URL, z użyciem PlaidCloud Git — zarządzanej usługi Git wbudowanej w Twój obszar roboczy — jako źródła. Ponieważ PlaidCloud Git jest zarządzany, połączenie, z którego wdrażana jest aplikacja, nie wymaga adresu URL serwera, nazwy użytkownika ani tokenu: PlaidCloud uwierzytelnia się w Twoim imieniu.
Jest pięć kroków:
- Napisz minimalną aplikację Panel.
- Umieść ją w repozytorium PlaidCloud Git.
- Utwórz zarządzane połączenie PlaidCloud Git.
- Opublikuj aplikację serwerową wskazującą na repozytorium.
- Otwórz udostępnioną aplikację — i przeczytaj dzienniki kompilacji, jeśli się nie uruchomi.
Każdy krok odsyła do bardziej szczegółowego przewodnika na ten temat; ta strona łączy je w jedną ścieżkę.
Zanim zaczniesz
Dział zatytułowany „Zanim zaczniesz”- Otwórz Git w swoim obszarze roboczym, aby potwierdzić, że masz dostęp do PlaidCloud Git. Domyślnie organizacja Twojego obszaru roboczego zawiera repozytorium
apps(orazudfs) — naturalny dom dla aplikacji Panel. - Zainstaluj lokalnie
git, jeśli chcesz wypychać kod z komputera (pliki możesz też dodawać w interfejsie internetowym Git).
1. Napisz minimalną aplikację Panel
Dział zatytułowany „1. Napisz minimalną aplikację Panel”Twoja aplikacja potrzebuje punktu wejścia — pliku Python, który buduje aplikację Panel i oznacza ją .servable() — oraz opcjonalnie pliku requirements.txt z dodatkowymi pakietami, w katalogu głównym repozytorium lub obok punktu wejścia.
apps/├── app.py # entry point — calls .servable()└── requirements.txt # optional; extra dependencies (repo root or next to app.py)Utwórz app.py:
import panel as pn
pn.extension()
pn.pane.Markdown("# Hello from PlaidCloud Git 👋\n\nServed straight from your workspace repository.").servable()To kompletna aplikacja — wywołanie .servable() decyduje o tym, co PlaidCloud udostępnia. panel, bokeh i biblioteki klienckie PlaidCloud (plaidcloud-rpc, plaidcloud-utilities) są wstępnie zainstalowane, więc w requirements.txt wymieniaj tylko dodatkowe pakiety. Bogatsze przykłady, zależności oraz jasny/ciemny motyw znajdziesz w Tworzenie aplikacji Panel.
2. Umieść aplikację w repozytorium PlaidCloud Git
Dział zatytułowany „2. Umieść aplikację w repozytorium PlaidCloud Git”Użyj istniejącego repozytorium apps swojego obszaru roboczego lub utwórz nowe. Następnie umieść w nim swój kod. Aplikacje budowane w Panel Studio są już folderami w apps, więc znajdziesz je tam obok swoich.
Ponieważ logujesz się przez PlaidCloud, Twoje konto Git nie ma osobnego hasła — wygeneruj osobisty token dostępu (Twój awatar → Settings → Applications) z uprawnieniem write:repository i użyj go jako hasła, gdy Git o nie poprosi. Wypychanie do apps wymaga dostępu Contributor; poproś administratora obszaru roboczego o dodanie Cię do Git Contributors, jeśli karta Git pokazuje Cię jako Przeglądający. Użyj przycisku kopiowania obok adresu klonowania repozytorium na karcie Git, a następnie:
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 pushZapamiętaj ścieżkę repozytorium — <org>/apps — gdzie <org> to nazwa organizacji Twojego obszaru roboczego. Wprowadzisz ją w następnym kroku. Pełne informacje o klonowaniu, zatwierdzaniu i wypychaniu znajdują się w Repozytoria.
Token tutaj służy tylko Tobie do wypychania kodu. Połączenie, które utworzysz dalej, jest zarządzane i nie wymaga tokenu — nie myl tych dwóch rzeczy.
3. Utwórz zarządzane połączenie PlaidCloud Git
Dział zatytułowany „3. Utwórz zarządzane połączenie PlaidCloud Git”Połączenie informuje wdrożenie Panel, gdzie znajduje się jego kod. W przypadku PlaidCloud Git połączenie jest zarządzane — PlaidCloud dostarcza host i poświadczenia, więc wprowadzasz tylko cel repozytorium.
- Otwórz Tools > Connections, kliknij Nowe połączenie i wybierz PlaidCloud Git.
- Nadaj połączeniu Nazwa konta (na przykład
Apps Repo). - Ustaw Repository Path na
<org>/apps— ścieżkę zanotowaną w kroku 2 — oraz Domyślna gałąź namain. Pozostaw Ścieżka początkowa puste, chyba że Twoje aplikacje znajdują się w podkatalogu. - Kliknij Utwórz.
Nie ma pola Adres URL serwera, User, Password ani SSL/SSH — PlaidCloud Git jest zarządzany, więc platforma obsługuje host i uwierzytelnianie. Pełny formularz, w tym Użycie i Model zabezpieczeń połączenia (kto w obszarze roboczym może go używać), znajdziesz w Połączenie PlaidCloud Git.
Starsza wersja obszaru roboczego? Jeśli formularz nadal pokazuje Adres URL serwera lub pola poświadczeń, po prostu zostaw je puste — platforma i tak uwierzytelnia się w Twoim imieniu.
4. Opublikuj aplikację serwerową
Dział zatytułowany „4. Opublikuj aplikację serwerową”Teraz skieruj wdrożenie serwerowe na to połączenie.
- Otwórz Aplikacje i wybierz Nowa aplikacja > Oparta na serwerze.
- W sekcji Ustawienia katalogu ustaw Nazwa aplikacji i Slug URL — slug to adres URL aplikacji i jej nazwa wewnętrzna, więc użyj małych liter, cyfr i łączników, zaczynając od litery, do 40 znaków (na przykład
hello-panel). - W sekcji Połączenie Git i obserwator publikacji:
- Połączenie Git — połączenie PlaidCloud Git utworzone w kroku 3.
- Gałąź —
main. Wypchnięcia do tej gałęzi automatycznie przebudowują i ponownie wdrażają aplikację. - Punkt wejścia —
app.py.
- W sekcji Środowisko uruchomieniowe wybierz CPU, Pamięć, Projekt (FAST dla nowoczesnego wyglądu PlaidCloud) oraz okno Bezczynność. Zaznacz Zezwól na dostęp publiczny tylko wtedy, gdy aplikacja ma być dostępna bez logowania.
- Kliknij Opublikuj.
Każde pole w tym oknie jest opisane w Tworzenie aplikacji Panel.
5. Otwórz aplikację — i przeczytaj dzienniki, jeśli się nie uruchomi
Dział zatytułowany „5. Otwórz aplikację — i przeczytaj dzienniki, jeśli się nie uruchomi”Po opublikowaniu aplikacja jest budowana: PlaidCloud klonuje gałąź, instaluje Twój requirements.txt (z katalogu głównego repozytorium i z folderu aplikacji, jeśli istnieją) i buduje obraz kontenera. Jej Stan jest wyświetlany na liście Aplikacje i aktualizuje się automatycznie.
- Gdy Stan to Gotowe, otwórz aplikację pod adresem
https://<your-tenant-host>/serve/<slug>/. Pierwsze żądanie po okresie bezczynności uruchamia aplikację, wyświetlając przy tym krótki ekran ładowania PlaidCloud. - Jeśli kompilacja się nie powiedzie, otwórz aplikację i sprawdź jej dzienniki Zbuduj — brakująca zależność lub błąd importu pojawi się tam. Zobacz Korzystanie z aplikacji Panel, aby dowiedzieć się, co oznacza każdy stan, jak czytać dzienniki i jak wywołać przebudowę.
Od tej chwili każde wypchnięcie do gałęzi połączenia automatycznie przebudowuje i ponownie wdraża aplikację — edytuj app.py, wykonaj git push, a Twoja zmiana wchodzi na żywo. (Chyba że aplikacja jest zablokowana — zobacz Blokowanie aplikacji — w takim przypadku wypchnięcia są pomijane do czasu odblokowania.)
Następne kroki
Dział zatytułowany „Następne kroki”- Tworzenie aplikacji Panel — bogatsze przykłady, zależności i jasny/ciemny motyw
- Połączenie PlaidCloud Git — pełny formularz połączenia, użycie i model zabezpieczeń
- Odczyt danych i zalogowanego użytkownika — wykonuj zapytania do danych PlaidCloud jako osoba oglądająca aplikację
- Repozytoria — gałęzie, tokeny i współpraca w PlaidCloud Git