Déployer une application Dash depuis PlaidCloud Git
Voici le parcours complet, du code de votre application Dash sur votre machine jusqu’à une URL en ligne, en utilisant PlaidCloud Git (le service Git géré intégré à votre espace de travail) comme source. PlaidCloud Git étant géré, la connexion depuis laquelle votre application est déployée n’a besoin ni d’URL de serveur, ni de nom d’utilisateur, ni de jeton : PlaidCloud s’authentifie en votre nom.
Il y a cinq étapes :
- Écrire une application Dash minimale.
- La placer dans un dépôt PlaidCloud Git.
- Créer une connexion PlaidCloud Git gérée.
- Publier une application Dash qui pointe vers le dépôt.
- Ouvrir l’application diffusée, et lire les journaux de build si elle ne démarre pas.
Cette procédure est presque identique à Déployer une application Panel depuis PlaidCloud Git : ce sont deux applications Python côté serveur, construites depuis Git et diffusées de la même manière. La différence tient au code de l’application elle-même et à un champ de la boîte de dialogue de publication.
Avant de commencer
Section intitulée « Avant de commencer »- Ouvrez Git depuis votre espace de travail pour vérifier que vous pouvez accéder à PlaidCloud Git. Par défaut, l’organisation de votre espace de travail inclut un dépôt
apps, qui convient aussi naturellement aux applications Dash. - Installez
giten local si vous souhaitez pousser du code depuis votre machine (vous pouvez aussi ajouter des fichiers dans l’interface web de Git).
1. Écrire une application Dash minimale
Section intitulée « 1. Écrire une application Dash minimale »Votre application a besoin d’un point d’entrée (un fichier Python qui construit une application Dash et expose son serveur Flask) et, éventuellement, d’un fichier requirements.txt pour les paquets supplémentaires, à la racine du dépôt ou à côté de votre point d’entrée.
apps/├── app.py # entry point — exposes `server`└── requirements.txt # optional; extra dependencies (repo root or next to app.py)Créez 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)C’est une application complète. dash, plotly, dash-mantine-components, dash-ag-grid et les bibliothèques clientes PlaidCloud (plaidcloud-rpc, plaidcloud-utilities) sont préinstallés : ne listez donc dans requirements.txt que les paquets supplémentaires. Ne passez pas requests_pathname_prefix ni url_base_pathname à Dash(__name__) : la plateforme définit automatiquement le préfixe d’URL via DASH_URL_BASE_PATHNAME, et définir les deux provoque une erreur de configuration au démarrage. Pour le contrat complet d’une application et les fonctions d’accès aux données, consultez le contrat d’application et Lire les données et l’utilisateur connecté dans une application Dash.
2. Placer votre application dans un dépôt PlaidCloud Git
Section intitulée « 2. Placer votre application dans un dépôt PlaidCloud Git »Utilisez le dépôt apps existant de votre espace de travail, ou créez-en un nouveau. Ensuite, ajoutez-y votre code.
Comme vous vous connectez via PlaidCloud, votre compte Git n’a pas de mot de passe distinct : générez un jeton d’accès personnel (votre avatar → Paramètres → Applications) avec l’autorisation write:repository, puis utilisez-le comme mot de passe lorsque Git vous le demande. Pousser vers apps nécessite l’accès Contributeur : demandez à un administrateur de l’espace de travail de vous ajouter à Git Contributors si l’onglet Git vous indique que vous êtes Lecteur. Utilisez le bouton de copie à côté de l’adresse de clonage du dépôt dans l’onglet Git, puis :
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 pushNotez le chemin du dépôt, <org>/apps, où <org> est le nom de l’organisation de votre espace de travail. Vous le saisirez à l’étape suivante. Le détail du clonage, des commits et des push figure dans Dépôts.
Le jeton ci-dessus sert uniquement à vous permettre de pousser du code. La connexion que vous créez ensuite est gérée et n’a besoin d’aucun jeton : ne confondez pas les deux.
3. Créer une connexion PlaidCloud Git gérée
Section intitulée « 3. Créer une connexion PlaidCloud Git gérée »Une connexion indique à un déploiement Dash où se trouve son code. Pour PlaidCloud Git, la connexion est gérée : PlaidCloud fournit l’hôte et les identifiants, vous n’avez donc à saisir que la cible du dépôt. C’est le même type de connexion que celui utilisé par une application Panel serveur.
- Ouvrez Tools > Connections, cliquez sur Nouvelle connexion, puis choisissez PlaidCloud Git.
- Donnez à la connexion un Nom du compte (par exemple,
Apps Repo). - Définissez Repository Path sur
<org>/apps(le chemin que vous avez noté à l’étape 2) et Branche par défaut surmain. Laissez Chemin de départ vide, sauf si vos applications se trouvent dans un sous-répertoire. - Cliquez sur Créer.
Il n’y a aucun champ URL du serveur, utilisateur, mot de passe ni SSL/SSH : PlaidCloud Git étant géré, la plateforme prend en charge l’hôte et l’authentification. Pour le formulaire complet, y compris l’Utilisation et le Modèle de sécurité de la connexion (qui, dans l’espace de travail, peut l’utiliser), consultez Connexion PlaidCloud Git.
4. Publier l’application Dash
Section intitulée « 4. Publier l’application Dash »Faites maintenant pointer un déploiement Dash vers cette connexion.
- Ouvrez Applications et choisissez Nouvelle application > Appli Dash.
- Sous Paramètres du répertoire, définissez un Nom de l’application et un Slug d’URL : le slug constitue l’URL et le nom interne de l’application ; utilisez donc des lettres minuscules, des chiffres et des tirets, en commençant par une lettre, avec 40 caractères au maximum (par exemple,
hello-dash). Un Mémo facultatif décrit l’application. - Sous Connexion Git et observateur de publication :
- Connexion Git : la connexion PlaidCloud Git que vous avez créée à l’étape 3.
- Branche :
main. Les push vers cette branche reconstruisent et redéploient automatiquement l’application. - Point d’entrée :
app.py.
- Sous Exécution, choisissez le CPU, la Mémoire et la fenêtre d’Inactivité (minutes). Cochez Autoriser l’accès public uniquement si l’application doit être accessible sans connexion. Il n’y a pas de paramètre Conception : c’est une option propre à Panel.
- Sous Avancé (diffusion intégrée), facultatif : laissez ce champ vide, sauf si vous intégrez l’application dans un autre site.
- Cliquez sur Publier.
5. Ouvrir l’application, et lire les journaux si elle ne démarre pas
Section intitulée « 5. Ouvrir l’application, et lire les journaux si elle ne démarre pas »Après la publication, l’application est construite : PlaidCloud clone la branche, installe votre requirements.txt et construit une image de conteneur à partir de l’image platform-dash-base. Son Statut s’affiche dans la liste Applications et se met à jour automatiquement.
- Lorsque le statut est Prêt, ouvrez l’application à l’adresse
https://<your-tenant-host>/serve/<slug>/. La première requête après une période d’inactivité la relance, en affichant brièvement un écran de chargement PlaidCloud. - Si la construction échoue, ouvrez l’application et consultez ses journaux de build : une dépendance manquante ou une erreur d’importation y apparaît. Consultez Utiliser une application Dash pour la signification de chaque statut, la lecture des journaux et le déclenchement d’une nouvelle construction.
Désormais, chaque push vers la branche de la connexion reconstruit et redéploie automatiquement l’application : modifiez app.py, faites un git push, et votre changement est en ligne. (Sauf si l’application est verrouillée : les push sont alors ignorés jusqu’à son déverrouillage ; consultez Utiliser une application Dash.)
Étapes suivantes
Section intitulée « Étapes suivantes »- Lire les données et l’utilisateur connecté dans une application Dash : interrogez les données PlaidCloud en tant que personne qui consulte l’application.
- Utiliser une application Dash : statut de construction, journaux, verrouillage et suppression de l’application.
- Connexion PlaidCloud Git : le formulaire complet de la connexion, son utilisation et son modèle de sécurité.
- Dépôts : branches, jetons et collaboration dans PlaidCloud Git.