Aller au contenu

Utiliser une application Panel

Chaque application publiée apparaît sur l’écran Mes applications Panel avec son Exécution, son Statut, son Slug et ses horodatages. La colonne la plus à gauche ouvre l’application ; les autres icônes de la ligne vous permettent de la verrouiller contre les modifications accidentelles, de la modifier, de la supprimer et, pour les applications serveur, de la régénérer, d’afficher ses journaux et ses métriques d’utilisation. L’icône d’ouverture reflète l’exécution de l’application, ce qui permet de distinguer au premier coup d’œil les applications WASM des applications serveur.

La colonne Statut d’une application serveur suit sa génération, et la liste s’actualise automatiquement tant qu’une génération est en cours :

  • Génération en cours… — PlaidCloud génère un conteneur à partir de votre dépôt. L’application n’a pas encore d’URL.
  • Prêt — la génération a réussi. L’URL de l’application est active et l’icône Ouvrir apparaît sur sa ligne.
  • Échec — la génération ne s’est pas terminée. Vérifiez le point d’entrée et la branche, puis modifiez l’application pour la republier.

Les applications WASM n’ont pas d’étape de génération et sont disponibles dès leur publication.

Cliquez sur l’icône Régénérer de la ligne d’une application serveur pour la régénérer et la redéployer sans modifier ses paramètres. Le statut de l’application repasse à Génération en cours… pendant que PlaidCloud génère de nouveau la même branche et le même point d’entrée, puis revient à Prêt une fois la nouvelle génération active.

Utilisez Régénérer après des changements de dépendances, des mises à jour de l’image de base ou une génération en échec passagère. Modifier puis enregistrer une application serveur la régénère aussi, mais une régénération ne nécessite pas d’ouvrir le formulaire de modification.

Pour une application App Runner — le formulaire de saisie généré pour une application Alteryx convertie —, Régénérer et l’enregistrement d’une modification actualisent d’abord ses fichiers générés vers la version actuelle d’App Runner, puis lancent la génération. PlaidCloud fait de même pour toutes les applications App Runner non verrouillées lorsque PlaidCloud lui-même est mis à jour ; une application verrouillée nécessite une action Régénérer une fois déverrouillée.

Cliquez sur l’icône cadenas de la ligne d’une application pour la protéger contre les modifications accidentelles. Tant qu’une application est verrouillée :

  • Modifier, Supprimer et Régénérer refusent de s’exécuter et vous indiquent que l’application est verrouillée.
  • Un push sur la branche d’une application serveur ne la régénère pas — la régénération automatique est ignorée jusqu’à ce que vous déverrouilliez l’application. Aucune génération ne s’exécute pour un push ignoré, donc rien de nouveau n’apparaît dans les journaux de génération de l’application ; effectuez de nouveau un push (ou utilisez Régénérer) après le déverrouillage pour prendre en compte la modification.
  • L’ouverture de l’application, la consultation de ses journaux et celle de ses métriques d’utilisation continuent de fonctionner — le verrou n’empêche que les modifications, jamais les lecteurs.

Cliquez de nouveau sur l’icône pour déverrouiller. L’icône indique l’état actuel de l’application : fermée lorsqu’elle est verrouillée, ouverte dans le cas contraire.

Le verrou protège contre les accidents — une modification par erreur, une suppression involontaire ou un push git qui arrive sur une application que vous présentez en démonstration —, comme le verrou des workflows et des étapes de workflow. Ce n’est pas un contrôle de sécurité : toute personne qui peut modifier des applications Panel peut aussi les déverrouiller.

Le verrou ne couvre pas deux cas : une génération déjà en cours au moment du verrouillage se termine et est mise en ligne, et les fichiers d’une application WASM se trouvent dans son compte de documents, de sorte que leur remplacement modifie l’application en cours d’exécution sans toucher à l’enregistrement verrouillé.

Cliquez sur l’icône Ouvrir au début de la ligne d’une application prête pour la lancer dans un nouvel onglet.

  • Une application serveur est servie à l’adresse https://<your-tenant-host>/serve/<slug>/.
  • L’icône Ouvrir n’apparaît que lorsqu’une application serveur est Prête.

Une application serveur revient à zéro instance lorsqu’elle est inactive afin d’économiser des ressources ; la première ouverture après une période d’inactivité doit donc la redémarrer. Pendant ce temps, vous voyez un écran de chargement PlaidCloud — le nom de votre application, un indicateur de progression et les détails de votre espace de travail — au lieu d’un onglet vide. L’application s’affiche d’elle-même dès qu’elle est prête (en général en quelques secondes, jusqu’à environ une minute lors d’un démarrage à froid), puis répond normalement jusqu’à sa prochaine période d’inactivité.

Si une application ne peut pas démarrer, l’écran de chargement se transforme en message « This app didn’t start » accompagné d’un bouton Réessayer, au lieu de tourner indéfiniment. Si cela se reproduit, modifiez l’application pour vérifier son point d’entrée et sa branche, puis republiez-la, ou contactez votre administrateur PlaidCloud.

Les applications Panel serveur utilisent par défaut le design moderne FAST de PlaidCloud, mais le paramètre Conception de l’application permet de revenir au style Par défaut de Panel lorsque du CSS existant en dépend. Le thème — clair, sombre, ou un commutateur clair/sombre que les lecteurs peuvent basculer — se définit dans le modèle de votre application. Consultez Définir le thème dans le guide de création pour connaître les schémas à utiliser. Si les tables ou le style personnalisé de votre application sont conçus pour un fond clair, maintenez-la sur le thème clair.

Cliquez sur l’icône Afficher les journaux de la ligne d’une application serveur pour ouvrir son visualiseur de journaux. (Les applications WASM s’exécutent entièrement dans le navigateur et n’ont pas de journaux serveur ; l’icône n’apparaît donc que sur les lignes des applications serveur.)

Le visualiseur comporte deux onglets :

  • Exécution (affiché en premier) — la sortie propre de l’application en cours d’exécution : tout ce qu’elle journalise, tout ce qu’elle affiche et toute erreur non interceptée. Ces données sont conservées même après le retour de l’application à zéro instance, ce qui vous permet de revoir ce qu’une session précédente a fait.
  • Génération — la sortie de la génération du conteneur de l’application. Utilisez-le pour voir pourquoi une génération affiche Échec — par exemple, une dépendance qui ne s’installait pas.

Chaque onglet propose des filtres Info / Avert. / Erreur, une plage de temps Journaux depuis (de la dernière heure jusqu’à 30 jours, ou tout), un bouton Actualiser et Actualisation auto pour interroger les nouvelles entrées — pratique lorsque vous surveillez une application active ou une génération en cours. Les entrées les plus récentes sont listées en premier.

Si la sortie de génération n’a pas pu être capturée, l’onglet Génération affiche une courte note expliquant pourquoi au lieu d’apparaître vide.

La table des journaux tronque les lignes longues pour que la liste reste lisible. Sélectionnez une ligne de journal pour ouvrir un volet de détail à côté de la table, qui affiche le Message du journal complet de l’entrée. C’est le moyen le plus simple de lire un contenu trop long pour la table — un long message d’erreur ou une trace de pile complète — sans qu’il soit coupé.

Vous pouvez sélectionner plusieurs lignes de journal à la fois et cliquer sur Copier pour les placer dans votre presse-papiers. C’est pratique pour coller des journaux dans une conversation avec un assistant IA lorsque vous déboguez votre application, ou dans un message destiné à votre équipe ou au support PlaidCloud.

Lorsque votre application authentifie les lecteurs, chaque ligne de journal est étiquetée avec l’utilisateur dont la session l’a produite, ce qui vous permet de savoir quel lecteur a rencontré une erreur ou un avertissement donné. L’étiquetage est fourni au mieux — certaines lignes du framework et du démarrage s’exécutent avant l’intervention de tout lecteur et peuvent ne pas afficher d’utilisateur.

Cliquez sur l’icône Métriques d’utilisation de la ligne d’une application serveur — à côté de Afficher les journaux — pour voir comment l’application est utilisée. La vue résume :

  • Utilisateurs uniques — le nombre de personnes distinctes qui ont ouvert l’application.
  • Sessions — le nombre de fois où elle a été ouverte.
  • Durée moyenne et médiane des sessions — la durée approximative d’une visite.
  • Dernière utilisation — le moment de la dernière ouverture de l’application.

Sous le résumé, vous obtenez une répartition par utilisateur et par jour, pour voir qui utilise l’application et comment l’utilisation évolue dans le temps.

Les durées sont approximatives. Les applications serveur passent en inactivité et réduisent leurs ressources lorsque personne ne les utilise ; la fin exacte d’une session n’est donc pas toujours observée — considérez les durées comme une indication, pas comme une mesure exacte.

Cliquez sur l’icône crayon de la ligne d’une application pour la modifier. Le formulaire de modification correspond à l’exécution de l’application.

Pour une application serveur, vous pouvez modifier le nom, le slug, la branche, le point d’entrée, le processeur, la mémoire, la conception, le délai d’inactivité, l’indicateur public, les domaines de diffusion intégrée et le mémo. La Connexion Git est fixée à la création de l’application et s’affiche en lecture seule. L’enregistrement régénère l’application — son statut repasse à Génération en cours… jusqu’à ce que la nouvelle génération soit prête.

Cliquez sur l’icône moins de la ligne d’une application et confirmez ; la suppression ou la dépublication d’une application demande toujours une confirmation préalable. Supprimer une application serveur démantèle sa génération et son déploiement ; supprimer une application WASM dépublie le fichier statique. L’URL de l’application cesse de fonctionner immédiatement.

L’outil MCP panel_deployment_manage ne propose plus la dépublication. Supprimez plutôt une application depuis cette liste.