Przejdź do głównej zawartości

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:

  1. Napisz minimalną aplikację Panel.
  2. Umieść ją w repozytorium PlaidCloud Git.
  3. Utwórz zarządzane połączenie PlaidCloud Git.
  4. Opublikuj aplikację serwerową wskazującą na repozytorium.
  5. 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ę.

  • 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 (oraz udfs) — naturalny dom dla aplikacji Panel.
  • Zainstaluj lokalnie git, jeśli chcesz wypychać kod z komputera (pliki możesz też dodawać w interfejsie internetowym Git).

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.

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:

Okno terminala
git clone <clone URL>
cd apps
# add app.py (and requirements.txt), then:
git add app.py requirements.txt
git commit -m "Add hello panel app"
git push

Zapamię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.

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.

  1. Otwórz Tools > Connections, kliknij Nowe połączenie i wybierz PlaidCloud Git.
  2. Nadaj połączeniu Nazwa konta (na przykład Apps Repo).
  3. Ustaw Repository Path na <org>/apps — ścieżkę zanotowaną w kroku 2 — oraz Domyślna gałąź na main. Pozostaw Ścieżka początkowa puste, chyba że Twoje aplikacje znajdują się w podkatalogu.
  4. 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.

Teraz skieruj wdrożenie serwerowe na to połączenie.

  1. Otwórz Aplikacje i wybierz Nowa aplikacja > Oparta na serwerze.
  2. 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).
  3. 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.
  4. 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.
  5. 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.)