Eine Panel-App erstellen

Öffnen Sie Meine Panel-Apps. Die Symbolleiste bietet zwei Wege zum Veröffentlichen, je einen pro Laufzeit:

Neue Server-App – erstellen und betreiben Sie eine App aus einem Git-Repository.
WASM-App hinzufügen – veröffentlichen Sie eine statische App, die im Browser läuft, aus einer Datei.

Wenn Sie die App stattdessen in PlaidCloud schreiben möchten, ohne ein Repository einzurichten, verwenden Sie Panel Studio.

Eine Server-App erstellen

Eine Server-App wird aus einem Git-Repository erstellt und unter https://<your-tenant-host>/serve/<slug>/ bereitgestellt. Sie verweisen PlaidCloud auf einen Branch eines Repositorys; PlaidCloud baut den Code in einen Container, führt darin panel serve aus und baut automatisch neu, sobald Sie in diesen Branch pushen.

Das App-Repository vorbereiten

Ihr Repository benötigt zwei Dinge: einen Einstiegspunkt – eine Python-Datei, die eine Panel-App erstellt und mit .servable() markiert – und optional eine requirements.txt, die zusätzliche Pakete auflistet, entweder im Stammverzeichnis des Repositorys oder neben Ihrem Einstiegspunkt.

my-panel-app/
├── app.py            # entry point — calls .servable()
└── requirements.txt  # optional; extra dependencies (repo root or next to app.py)

Hello World

Erstellen Sie app.py:

import panel as pn

pn.extension()

pn.pane.Markdown("# Hello, PlaidCloud 👋\n\nYour first server-side Panel app is running.").servable()

Das ist eine vollständige App. PlaidCloud stellt den Aufruf .servable() bereit – alles, was dargestellt werden soll, muss als servable markiert sein (direkt oder indem es sich in einem servable Layout befindet).

Ein etwas umfangreicheres Beispiel

Panel-Apps sind interaktiv. Diese fügt einen Schieberegler hinzu, der eine Tabelle live aktualisiert:

import pandas as pd
import panel as pn

pn.extension()

multiplier = pn.widgets.IntSlider(name="Multiplier", start=1, end=10, value=3)

@pn.depends(multiplier)
def times_table(m):
    df = pd.DataFrame({"n": range(1, 6)})
    df["result"] = df["n"] * m
    return pn.pane.DataFrame(df, index=False)

pn.Column(
    "# Times Table",
    multiplier,
    times_table,
).servable()

Abhängigkeiten hinzufügen

Dieses zweite Beispiel importiert pandas, das nicht zum Basis-Image gehört. Fügen Sie also eine requirements.txt hinzu (im Stammverzeichnis des Repositorys oder neben Ihrem Einstiegspunkt):

pandas

PlaidCloud installiert diese beim Erstellen des Images mit pip. Gängige Visualisierungsbibliotheken – plotly, holoviews, hvplot – sind ebenfalls nicht im Basis-Image enthalten. Führen Sie deshalb hier alle auf, die Ihre App importiert.

Was die Plattform bereitstellt – und erwartet. Beachten Sie beim Schreiben Ihrer App diese Annahmen:

panel und bokeh sind vorinstalliert im Basis-Image der Plattform. Führen Sie sie nicht in requirements.txt auf und vermeiden Sie es, eine ältere Panel-Version festzulegen – der Wiederverbindungsmechanismus für Live-Aktualisierungen setzt eine aktuelle voraus.

Die PlaidCloud-Clientbibliotheken (plaidcloud-rpc, plaidcloud-utilities) sind vorinstalliert. Importieren Sie plaidcloud.rpc oder plaidcloud.utilities direkt – führen Sie sie nicht in requirements.txt auf.

requirements.txt kann im Stammverzeichnis des Repositorys oder neben Ihrem Einstiegspunkt liegen. Halten Sie in einem gemeinsam genutzten Repository (Monorepo) die Abhängigkeiten jeder App im eigenen Ordner. Eine Datei auf Stammebene wird, falls vorhanden, ebenfalls installiert – legen Sie gemeinsame Abhängigkeiten dort ab und app-spezifische neben der App.

Die App läuft als Nicht-Root-Benutzer in einem schreibgeschützten Dateisystem. Nur /tmp ist beschreibbar, schreiben Sie temporäre Dateien also dorthin (die meisten Bibliotheken beachten $TMPDIR bereits).

Codieren Sie Port, URL-Präfix oder Host nicht fest. PlaidCloud weist sie zu und fügt sie bei der Bereitstellung ein – rufen Sie einfach .servable() auf.

Für den PlaidCloud-Look und fertige Filter, Raster und Diagramme erstellen Sie Ihre App mit dem Panel App Kit.

Das Design festlegen: Hell, Dunkel oder umschaltbar

Server-Apps werden standardmäßig im modernen Fast-Design von PlaidCloud dargestellt – einem klaren Look im Fluent-Stil, der plattformweit angewendet wird. Im Veröffentlichungsdialog steuert Design diese Plattformebene:

FAST – der PlaidCloud-Standard. Verwenden Sie ihn für neue Apps und für Apps, die mit Fast-Vorlagen erstellt wurden.
Standard – das Standard-Styling von Panel. Verwenden Sie es, wenn das CSS oder die Darstellung einer bestehenden App unter FAST fehlerhaft wird.

In Ihrem App-Code steuern Sie das Theme: hell, dunkel oder ein Schalter, den der Betrachter umlegen kann.

Das Theme ist eine Eigenschaft der Vorlage, die Sie bereitstellen. Die Fast-Vorlagen – FastListTemplate (eine Spalte) und FastGridTemplate (ein responsives Raster) – nehmen dafür zwei Einstellungen entgegen:

theme – "default" für hell oder "dark". Wenn Sie es setzen, bleibt die App auf dieses Theme festgelegt, auch wenn ein Betrachter ?theme=dark an die URL anhängt.
theme_toggle – True zeigt in der Kopfzeile einen Schalter zwischen Hell und Dunkel; False blendet ihn aus. Standardwert ist True. Das Ausblenden des Schalters legt das Theme nicht von selbst fest – legen Sie es mit theme fest (siehe oben); setzen Sie dann theme_toggle=False, damit Betrachter keinen Schalter sehen, der nichts mehr ändert.

Wählen Sie das Muster, das zu Ihrer App passt.

Nur hell – am besten für dichte Berichte und Finanztabellen, die meist von Hand für einen hellen Hintergrund gestaltet sind:

import panel as pn

pn.extension("tabulator")

pn.template.FastListTemplate(
    title="Sales Dashboard",
    theme="default",      # light
    theme_toggle=False,   # hide the switch
    main=[...],
).servable()

Nur dunkel:

pn.template.FastListTemplate(
    title="Ops Monitor",
    theme="dark",
    theme_toggle=False,
    main=[...],
).servable()

Den Betrachter wählen lassen – standardmäßig hell, mit einem Schalter in der Kopfzeile. Lassen Sie theme weg, damit es dem Schalter folgt:

pn.template.FastListTemplate(
    title="Explorer",
    theme_toggle=True,
    main=[...],
).servable()

Wenn Sie Dunkel zulassen, machen Sie Ihre Tabellen dunkelmodusfähig. Ein Tabulator, der auf ein helles Tabellen-Theme (theme="bootstrap") festgelegt ist, oder benutzerdefiniertes CSS mit fest codierten hellen Farben wie background: #fff erscheint auf einer dunklen Seite als unlesbarer weißer Block. Verwenden Sie ein Tabellen-Theme, das der App folgt – pn.widgets.Tabulator(..., theme="fast") – und vermeiden Sie fest codierte helle Farben. Wenn ein Bericht stark von Hand für Hell gestaltet ist, legen Sie ihn stattdessen auf Hell fest (das erste Muster oben).

Eine einfache App ohne Vorlage – pn.Column(...).servable() – folgt dem Standard von Panel und wird von diesen Einstellungen nicht beeinflusst; greifen Sie zu einer Vorlage, wenn Sie explizite Kontrolle wünschen.

Ihr Repository muss über eine Git-Verbindung in PlaidCloud erreichbar sein. Wenn Ihr Code in PlaidCloud Git liegt, erstellen Sie unter Tools > Connections eine verwaltete PlaidCloud Git-Verbindung – sie benötigt weder Server-URL noch Zugangsdaten. Den gesamten Weg von einem leeren Repository bis zu einer bereitgestellten App finden Sie unter Eine Panel-App aus PlaidCloud Git bereitstellen.

Die App veröffentlichen

Klicken Sie auf Neue Server-App, um den Dialog Server-Panel-App veröffentlichen zu öffnen. Seine Einstellungen sind in Abschnitte gegliedert.
Unter Verzeichniseinstellungen:
- App-Name – der Anzeigename in der Liste.
- URL-Slug – sowohl die URL der App als auch ihr interner Name, daher muss er ein gültiges DNS-Label sein: Kleinbuchstaben, Ziffern und Bindestriche, beginnend mit einem Buchstaben, höchstens 40 Zeichen (zum Beispiel sales-dashboard). Der Dialog prüft dies vor dem Veröffentlichen.
- Notiz – eine optionale Beschreibung.
- Projekt – das Projekt, dem die App gehört. Es liefert das Branding der App und ist das Standardprojekt für ihre Tabellen. Nach dem Veröffentlichen können Sie es hier nicht mehr ändern; verwenden Sie Zuweisen.
Unter Git-Verbindung und Veröffentlichungsüberwachung:
- Git-Verbindung – die Verbindung, die das Repository Ihrer App enthält.
- Branch – der Branch, aus dem erstellt wird. Pushes in diesen Branch bauen die App automatisch neu und stellen sie erneut bereit.
- Einstiegspunkt – die .py-Datei, die Panel bereitstellen soll (Ihre app.py).
Unter Laufzeit:
- CPU und Arbeitsspeicher, die der Container der App anfordern soll.
  
  Weniger Ressourcen (weniger CPU / Arbeitsspeicher) lassen die App schneller einplanen und kalt starten.
- Design – wählen Sie FAST für das moderne Design von PlaidCloud oder Standard, wenn das CSS der App das Standard-Styling von Panel erwartet.
- Leerlauf (Minuten) – wie lange die App ohne Datenverkehr betriebsbereit bleibt, bevor sie auf null herunterskaliert wird. Der Standardwert beträgt 5 Minuten.
- Öffentlichen Zugriff zulassen – aktivieren Sie dies, um unauthentifizierten Zugriff zu erlauben; andernfalls müssen sich Betrachter an Ihrem Tenant anmelden.
Unter Erweitert (eingebettete Bereitstellung) – optional. Standardmäßig wird die App nur von Ihrem PlaidCloud-Tenant bereitgestellt. Um sie in eine andere Website einzubetten, klicken Sie auf Domäne hinzufügen und geben Sie jede Domäne ein, die sie laden darf, eine pro Zeile – nur einen Host, ohne Schema oder Pfad (zum Beispiel example.com oder app.example.com:8443). Lassen Sie die Liste leer, sofern Sie die App nicht anderswo einbetten.
Klicken Sie auf Veröffentlichen.

Nach dem Veröffentlichen wird die App erstellt – ihr Status erscheint in der Liste und aktualisiert sich automatisch. Unter Eine Panel-App verwenden erfahren Sie, was die Status bedeuten, wie Sie die App öffnen, sobald sie bereit ist, und wie Sie einen Neuaufbau auslösen, ohne die Veröffentlichung aufzuheben.

Die URL der App funktioniert erst, wenn ihr Build-Status Bereit lautet, und die erste Anfrage, nachdem sie im Leerlauf war, fährt sie hoch (ca. 15 Sekunden).

Fortgeschritten: PlaidCloud lokal nachbilden

Technisch versierte Benutzer können die App mit denselben Eingaben erstellen und testen, die PlaidCloud verwendet. Das ist die nächstliegende lokale Prüfung vor dem Veröffentlichen oder dem Klicken auf Neu erstellen.

PlaidCloud baut aus dem ausgewählten Git-Branch mit diesem generierten Dockerfile. Verwenden Sie lokal denselben Inhalt als Dockerfile.plaidcloud-panel:

FROM us-docker.pkg.dev/plaidcloud-build/panel-base/platform-panel-base:0.5.1
USER root
COPY . /app
RUN if [ -f /app/requirements.txt ]; then pip install --no-cache-dir -r /app/requirements.txt; fi
# If your entry point is in a subfolder, PlaidCloud also installs that folder's requirements.txt,
# after the root one (so a per-app pin wins). Replace <app-folder> with your entry point's folder,
# or drop this line if your app is at the repository root.
RUN if [ -f "/app/<app-folder>/requirements.txt" ]; then pip install --no-cache-dir -r "/app/<app-folder>/requirements.txt"; fi
USER 10001

So bilden Sie den Server-Build nach:

Checken Sie denselben Branch aus, den Sie unter Branch auswählen.
Führen Sie den Build im Stammverzeichnis des Repositorys aus, damit COPY . /app mit PlaidCloud übereinstimmt.
Legen Sie optionale Abhängigkeiten in einer requirements.txt ab – im Stammverzeichnis des Repositorys oder neben Ihrem Einstiegspunkt. Beide werden installiert, die des App-Ordners zuletzt (damit eine app-spezifische Festlegung gewinnt).
Verwenden Sie denselben Pfad zum Einstiegspunkt, den Sie unter Einstiegspunkt auswählen.

docker build \
  -f Dockerfile.plaidcloud-panel \
  -t local-panel-app:plaidcloud \
  .

Das bereitgestellte Image überschreibt den Einstiegspunkt des Basis-Images nicht. Es führt panel serve anhand von Umgebungsvariablen aus, die PlaidCloud einfügt. Testen Sie das erstellte Image mit demselben Laufzeitvertrag:

docker run --rm \
  --cpus 0.5 \
  --memory 512m \
  -p 5006:5006 \
  -e APP_PATH=/app/app.py \
  -e PANEL_PREFIX=/serve/local \
  -e PANEL_PORT=5006 \
  -e PANEL_ORIGIN=localhost:5006 \
  -e PANEL_KEEP_ALIVE_MS=25000 \
  -e PLAID_PANEL_DESIGN=fast \
  local-panel-app:plaidcloud

Öffnen Sie http://localhost:5006/serve/local/.

Gleichen Sie beim Testen die Einstellungen des Veröffentlichungsdialogs ab:

Einstiegspunkt entspricht APP_PATH=/app/<entry-point>.
CPU und Arbeitsspeicher entsprechen den Docker-Limits --cpus und --memory.
Design: FAST entspricht PLAID_PANEL_DESIGN=fast.
Design: Standard bedeutet, PLAID_PANEL_DESIGN wegzulassen.
Leerlauf (Minuten) entspricht dem Zeitfenster für das Herunterskalieren in der Bereitstellung. Lokales Docker erzwingt es nicht, aber die App verwendet weiterhin dieselben Panel-Websocket-Keepalive- und Sitzungsbereinigungseinstellungen.
Die Domänen unter Embedded Serving entsprechen PANEL_ORIGIN; verwenden Sie eine durch Leerzeichen getrennte Liste, wenn Sie mehr als einen Host testen möchten.

Wenn Sie keinen Container benötigen, können Sie die Serve-Schicht dennoch in einer lokalen Python-Umgebung testen. Installieren Sie dieselbe requirements.txt, setzen Sie die Umgebungsvariablen der Plattform und führen Sie dann panel serve mit denselben Flags aus, die das bereitgestellte Image verwendet.

export APP_PATH=app.py
export PANEL_PREFIX=/serve/local
export PANEL_PORT=5006
export PANEL_ORIGIN=localhost:5006
export PANEL_KEEP_ALIVE_MS=25000
export PLAID_PANEL_DESIGN=fast

panel serve "$APP_PATH" \
  --address 0.0.0.0 \
  --port "$PANEL_PORT" \
  --prefix "$PANEL_PREFIX" \
  --allow-websocket-origin "$PANEL_ORIGIN" \
  --num-procs 1 \
  --keep-alive "$PANEL_KEEP_ALIVE_MS" \
  --unused-session-lifetime 15000 \
  --index "$(basename "$APP_PATH" .py)"

Öffnen Sie http://localhost:5006/serve/local/.

Verwenden Sie PLAID_PANEL_DESIGN=fast, um den standardmäßig bereitgestellten Look nachzubilden. Um die Design-Option Standard des Veröffentlichungsdialogs zu testen, lassen Sie PLAID_PANEL_DESIGN ungesetzt und führen Sie denselben Befehl aus. Behalten Sie PANEL_PREFIX, PANEL_ORIGIN, --keep-alive und --unused-session-lifetime bei; sie sind Teil des Laufzeitvertrags der Bereitstellung.

Eine WASM-App erstellen

Eine WASM-App läuft im Browser aus einer vorab erstellten HTML-Datei.

Klicken Sie auf WASM-App hinzufügen, um den Dialog Serverlose Panel-App veröffentlichen zu öffnen.
Geben Sie einen App-Name und eine Version ein.
Wählen Sie den HTML-Speicherort der App – die HTML-Datei in einem Dokumentenkonto.
Geben Sie einen URL-Slug der App und optional eine Notiz ein.
Klicken Sie auf Veröffentlichen. Eine WASM-App hat keinen Build-Schritt und wird sofort bereitgestellt.