Dash-App aus PlaidCloud Git bereitstellen

Dies ist der vollständige Weg vom Dash-App-Code auf Ihrem Rechner bis zu einer Live-URL, mit PlaidCloud Git – dem in Ihren Workspace integrierten verwalteten Git-Dienst – als Quelle. Da PlaidCloud Git verwaltet wird, benötigt die Verbindung, aus der Ihre App bereitgestellt wird, keine Server-URL, keinen Benutzernamen und kein Token: PlaidCloud authentifiziert sich in Ihrem Namen.

Es sind fünf Schritte:

Eine minimale Dash-App schreiben.
Sie in einem PlaidCloud-Git-Repository ablegen.
Eine verwaltete PlaidCloud-Git-Verbindung erstellen.
Eine Dash-App veröffentlichen, die auf das Repository verweist.
Die bereitgestellte App öffnen – und die Build-Protokolle lesen, falls sie nicht startet.

Diese Anleitung ist nahezu identisch mit Panel-App aus PlaidCloud Git bereitstellen – beides sind serverseitige Python-Apps, die aus Git erstellt und auf die gleiche Weise bereitgestellt werden. Der Unterschied liegt im App-Code selbst und in einem Feld im Veröffentlichungsdialog.

Bevor Sie beginnen

Öffnen Sie Git in Ihrem Workspace, um zu prüfen, dass Sie PlaidCloud Git erreichen können. Die Organisation Ihres Workspace enthält standardmäßig ein Repository namens apps – der natürliche Ort auch für Dash-Apps.
Installieren Sie git lokal, wenn Sie Code von Ihrem Rechner pushen möchten (Dateien können Sie auch in der Git-Weboberfläche hinzufügen).

1. Eine minimale Dash-App schreiben

Ihre App benötigt einen Einstiegspunkt – eine Python-Datei, die eine Dash-App aufbaut und ihren Flask-Server bereitstellt – und optional eine requirements.txt für zusätzliche Pakete, entweder im Stammverzeichnis des Repositorys oder neben Ihrem Einstiegspunkt.

apps/
├── app.py            # entry point — exposes `server`
└── requirements.txt  # optional; extra dependencies (repo root or next to app.py)

Erstellen Sie app.py:

import plaidcloud_dash as pcd
from dash import Dash, Input, Output, html

app = Dash(__name__)  # picks up DASH_URL_BASE_PATHNAME from the platform automatically
server = 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)

Das ist eine vollständige App. dash, plotly, dash-mantine-components, dash-ag-grid und die PlaidCloud-Clientbibliotheken (plaidcloud-rpc, plaidcloud-utilities) sind vorinstalliert, führen Sie in requirements.txt also nur zusätzliche Pakete auf. Übergeben Sie requests_pathname_prefix oder url_base_pathname nicht an Dash(__name__) – die Plattform setzt das URL-Präfix automatisch über DASH_URL_BASE_PATHNAME, und wenn beides gesetzt ist, führt das beim Start zu einem Konfigurationsfehler. Den vollständigen App-Vertrag und die Hilfsfunktionen für den Datenzugriff finden Sie unter App-Vertrag und Daten und angemeldeten Benutzer in einer Dash-App lesen.

2. Ihre App in einem PlaidCloud-Git-Repository ablegen

Verwenden Sie das vorhandene Repository apps Ihres Workspace oder erstellen Sie ein neues. Bringen Sie dann Ihren Code hinein.

Da Sie sich über PlaidCloud anmelden, hat Ihr Git-Konto kein eigenes Passwort – erzeugen Sie ein persönliches Zugriffstoken (Ihr Avatar → Settings → Applications) mit den Repository-Bereichen Lesen und Schreiben und verwenden Sie es als Passwort, wenn Git danach fragt. Kopieren Sie die HTTPS-Klon-URL des Repositorys über die Schaltfläche Code und führen Sie dann Folgendes aus:

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 dash app"
git push

Notieren Sie sich den Repository-Pfad – <org>/apps –, wobei <org> der Organisationsname Ihres Workspace ist. Diesen Pfad geben Sie im nächsten Schritt ein. Alle Einzelheiten zu Klonen, Commit und Push finden Sie unter Repositories.

Das Token hier dient nur dazu, dass Sie Code pushen. Die Verbindung, die Sie als Nächstes erstellen, wird verwaltet und benötigt kein Token – verwechseln Sie beides nicht.

3. Eine verwaltete PlaidCloud-Git-Verbindung erstellen

Eine Verbindung teilt einer Dash-Bereitstellung mit, wo ihr Code liegt. Für PlaidCloud Git wird die Verbindung verwaltet – PlaidCloud stellt Host und Zugangsdaten bereit, Sie geben also nur das Repository-Ziel an. Dies ist derselbe Verbindungstyp, den auch eine serverseitige Panel-App verwendet.

Öffnen Sie Tools > Connections, klicken Sie auf Neue Verbindung und wählen Sie PlaidCloud Git.
Geben Sie der Verbindung einen Kontoname (zum Beispiel Apps Repo).
Setzen Sie Repository Path auf <org>/apps – den Pfad, den Sie in Schritt 2 notiert haben – und Standardbranch auf main. Lassen Sie Startpfad leer, es sei denn, Ihre Apps liegen in einem Unterverzeichnis.
Klicken Sie auf Erstellen.

Es gibt kein Feld für Server-URL, Benutzer, Passwort oder SSL/SSH – PlaidCloud Git wird verwaltet, die Plattform übernimmt also Host und Authentifizierung. Das vollständige Formular, einschließlich Verwendung und Sicherheitsmodell der Verbindung (wer im Workspace sie nutzen darf), beschreibt PlaidCloud-Git-Verbindung.

4. Die Dash-App veröffentlichen

Lassen Sie nun eine Dash-Bereitstellung auf diese Verbindung verweisen.

Öffnen Sie Meine Panel-Apps und klicken Sie auf Neue Dash-App.
Legen Sie unter Verzeichniseinstellungen einen App-Name und einen URL-Slug fest – der Slug ist die URL und der interne Name der App, verwenden Sie also Kleinbuchstaben, Ziffern und Bindestriche, beginnend mit einem Buchstaben und mit höchstens 40 Zeichen (zum Beispiel hello-dash). Eine optionale Notiz beschreibt die App.
Unter Git-Verbindung und Veröffentlichungsüberwachung:
- Git-Verbindung – die PlaidCloud-Git-Verbindung, die Sie in Schritt 3 erstellt haben.
- Branch – main. Pushes auf diesen Branch erstellen die App automatisch neu und stellen sie erneut bereit.
- Einstiegspunkt – app.py.
Wählen Sie unter Laufzeit die Werte für CPU, Arbeitsspeicher und Leerlauf (Minuten). Aktivieren Sie Öffentlichen Zugriff zulassen nur, wenn die App ohne Anmeldung erreichbar sein soll. Eine Einstellung Design gibt es nicht – das ist eine Panel-spezifische Option.
Unter Erweitert (eingebettete Bereitstellung) – optional. Lassen Sie das Feld leer, es sei denn, Sie betten die App in eine andere Website ein.
Klicken Sie auf Veröffentlichen.

5. Die App öffnen – und Protokolle lesen, falls sie nicht startet

Nach dem Veröffentlichen wird die App erstellt: PlaidCloud klont den Branch, installiert Ihre requirements.txt und erstellt aus dem Image platform-dash-base ein Container-Image. Der Status wird in der Liste Meine Panel-Apps angezeigt und aktualisiert sich automatisch.

Wenn der Status Bereit lautet, öffnen Sie die App unter https://<your-tenant-host>/serve/<slug>/. Die erste Anfrage nach einer Leerlaufphase startet sie und zeigt dabei kurz einen PlaidCloud-Ladebildschirm.
Schlägt der Build fehl, öffnen Sie die App und prüfen Sie ihre Erstellen-Protokolle – eine fehlende Abhängigkeit oder ein Importfehler wird dort angezeigt. Unter Eine Dash-App verwenden erfahren Sie, was die einzelnen Status bedeuten, wie Sie Protokolle lesen und wie Sie eine Neuerstellung auslösen.

Ab jetzt erstellt jeder Push auf den Branch der Verbindung die App automatisch neu und stellt sie erneut bereit – bearbeiten Sie app.py, führen Sie git push aus, und Ihre Änderung geht live. (Es sei denn, die App ist gesperrt; dann werden Pushes übersprungen, bis Sie sie entsperren – siehe Eine Dash-App verwenden.)

Nächste Schritte

Daten und angemeldeten Benutzer in einer Dash-App lesen – Abfragen von PlaidCloud-Daten als die Person, die die App ansieht.
Eine Dash-App verwenden – Build-Status, Protokolle, Sperren und Entfernen der App.
PlaidCloud-Git-Verbindung – das vollständige Verbindungsformular, Verwendung und Sicherheitsmodell.
Repositories – Branches, Tokens und Zusammenarbeit in PlaidCloud Git.