Déployer une application Panel depuis PlaidCloud Git

Voici le parcours complet, du code d’une application Panel 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 se déploie ne nécessite ni URL de serveur, ni nom d’utilisateur, ni jeton : PlaidCloud s’authentifie en votre nom.

Il y a cinq étapes :

Écrire une application Panel minimale.
La placer dans un dépôt PlaidCloud Git.
Créer une connexion PlaidCloud Git gérée.
Publier une application serveur qui pointe vers le dépôt.
Ouvrir l’application servie, et lire les journaux de build si elle ne démarre pas.

Chaque étape renvoie vers le guide détaillé correspondant ; cette page les assemble en un seul parcours.

Avant de commencer

Ouvrez Git depuis votre espace de travail pour confirmer que vous pouvez accéder à PlaidCloud Git. Par défaut, l’organisation de votre espace de travail inclut un dépôt apps (et un dépôt udfs), l’emplacement naturel des applications Panel.
Installez git en 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 Panel minimale

Votre application a besoin d’un point d’entrée (un fichier Python qui construit une application Panel et la marque .servable()) et, éventuellement, d’un fichier requirements.txt pour les paquets supplémentaires, placé à la racine du dépôt ou à côté de votre point d’entrée.

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

Créez app.py :

import panel as pn

pn.extension()

pn.pane.Markdown("# Hello from PlaidCloud Git 👋\n\nServed straight from your workspace repository.").servable()

C’est une application complète : l’appel à .servable() est ce que PlaidCloud sert. panel, bokeh 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. Pour des exemples plus riches, les dépendances et la gestion des thèmes clair/sombre, consultez Créer une application Panel.

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, placez-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 → Settings → Applications) avec les portées lecture et écriture sur le dépôt, et utilisez-le comme mot de passe lorsque Git vous le demande. Copiez l’URL de clonage HTTPS du dépôt depuis son bouton Code, puis :

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

Notez le chemin du dépôt, <org>/apps, où <org> est le nom de l’organisation de votre espace de travail. Vous saisirez ce chemin à l’étape suivante. Les détails complets du clonage, de la validation et de l’envoi figurent dans Dépôts.

Le jeton ne sert ici qu’à vous permettre de pousser du code. La connexion que vous créez ensuite est gérée et ne nécessite aucun jeton : ne confondez pas les deux.

3. Créer une connexion PlaidCloud Git gérée

Une connexion indique à un déploiement Panel où se trouve son code. Pour PlaidCloud Git, la connexion est gérée : PlaidCloud fournit l’hôte et les identifiants, et vous ne saisissez donc que la cible du dépôt.

Ouvrez Tools > Connections, cliquez sur Nouvelle connexion et choisissez PlaidCloud Git.
Donnez à la connexion un Nom du compte (par exemple, Apps Repo).
Définissez Repository Path sur <org>/apps (le chemin noté à l’étape 2) et Branche par défaut sur main. 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 ou SSL/SSH : PlaidCloud Git étant géré, la plateforme gère l’hôte et l’authentification. Pour le formulaire complet, y compris l’Utilisation de la connexion et son Modèle de sécurité (qui, dans l’espace de travail, peut l’utiliser), consultez Connexion PlaidCloud Git.

Sur une ancienne version de l’espace de travail ? Si le formulaire affiche encore une URL du serveur ou des champs d’identifiants, laissez-les simplement vides : la plateforme s’authentifie de toute façon en votre nom.

4. Publier l’application serveur

Faites maintenant pointer un déploiement serveur vers cette connexion.

Ouvrez Mes applications Panel et cliquez sur Nouvelle application serveur.
Sous Paramètres du répertoire, définissez un Nom de l’application et un Slug d’URL : le slug est 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, 40 caractères au maximum (par exemple, hello-panel).
Sous Connexion Git et observateur de publication :
- Connexion Git : la connexion PlaidCloud Git que vous avez créée à l’étape 3.
- Branche : main. Les envois 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, la Conception (FAST pour l’apparence moderne de PlaidCloud) et la fenêtre d’Inactivité. Cochez Autoriser l’accès public uniquement si l’application doit être accessible sans connexion.
Cliquez sur Publier.

Chaque champ de cette boîte de dialogue est décrit dans Créer une application Panel.

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 (celui de la racine du dépôt et celui du dossier de votre application, s’ils existent) et construit une image de conteneur. Son Statut s’affiche dans la liste Mes applications Panel 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 redémarre (environ 15 secondes).
Si le build é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 Panel pour connaître la signification de chaque statut, la façon de lire les journaux et celle de déclencher une reconstruction.

À partir de là, chaque envoi vers la branche de la connexion reconstruit et redéploie automatiquement l’application : modifiez app.py, exécutez git push, et votre modification est mise en ligne. (Sauf si l’application est verrouillée, voir Verrouiller une application, auquel cas les envois sont ignorés jusqu’à son déverrouillage.)

Étapes suivantes

Créer une application Panel : exemples plus riches, dépendances et thèmes clair/sombre
Connexion PlaidCloud Git : le formulaire de connexion complet, l’utilisation et le modèle de sécurité
Lecture des données et utilisateur connecté : interrogez les données PlaidCloud en tant que personne qui consulte l’application
Dépôts : branches, jetons et collaboration dans PlaidCloud Git