Gestion des versions de pack
Consultez l'état d'installation pour tous les types de contenu, analysez l'impact sur les workflows et mettez à jour les packs depuis la page du catalogue Packs.
L'onglet Paramètres → Plateforme → Packs → Catalogue est l'emplacement central pour suivre la version installée de chaque pack, consulter l'état d'installation par type de contenu et appliquer les mises à jour. Pour le modèle de versionnement complet du point de vue d'un auteur de pack — règles semver, liste de contrôle de publication et fonctionnement des pins/politiques — voir Versionnement des packs. La marketplace Ajouter une intégration affiche un badge et un lien lorsqu'une intégration de pack dispose d'une mise à jour — les mises à jour s'effectuent toujours depuis la page Packs.
Comportement des mises à jour par type de contenu
Tous les types de contenu d'un pack ne se mettent pas à jour de la même manière — la plateforme applique le minimum d'automatisation qui reste sûr pour chaque type. Ce tableau est le modèle mental ; les sections ci-dessous détaillent chacun.
| Type de contenu | Mode de mise à jour | Pourquoi |
|---|---|---|
| Sources de données de référence statiques (données en ligne, sans appel externe) | Automatique à la synchronisation — installées dès qu'une mise à jour de pack atteint votre catalogue, sauf si la politique du pack est Manuelle. | Additives, ne font aucun appel externe et ne peuvent pas écraser vos données — le type le plus sûr. |
| Sources de données externes (polling) | Installer depuis la Marketplace Analytics — Mettre à jour vers vX réconcilie l'ensemble complet des sources du pack. | Une nouvelle source commence à appeler un système externe ; son installation relève donc de votre décision. |
| Ontologie et domaines KB | Les nouveaux éléments de schéma s'appliquent automatiquement à la synchronisation (pour les packs déjà installés) ; les changements d'éléments existants, et les nouveaux domaines KB, s'appliquent lorsque vous cliquez sur Mettre à jour le pack. | Ajouter de nouveaux types d'objets/liens est sûr ; les modifier ou les supprimer peut affecter les tables liées, l'analytique et le graphe. |
| Flux de processus | Automatique — toujours la dernière version du catalogue. | Un modèle n'apparaît que dans la galerie ; il n'exécute rien tant qu'un espace de travail ne s'y abonne pas. |
| Intégrations | Par connexion : manual (par défaut), ou auto_patch / auto_minor en option ; les changements cassants sont toujours retenus. | Code fournisseur exécutable + identifiants + egress — le type le plus à risque. |
| Workflows | Déployés par environnement depuis la Marketplace ; redéployez pour mettre à jour. | Vous choisissez quel environnement exécute quelle version. |
| Notebooks | Stockés à l'installation ; matérialisés / mis à jour par espace de travail dans Analytics. | Rien ne s'exécute tant que vous ne l'avez pas matérialisé. |
Garanties de sécurité, toujours : une application automatique ne fait qu'ajouter — elle ne supprime jamais vos données, n'écrase jamais une source ou un type que vous avez déjà, ne démarre jamais un nouvel appel externe, et n'exécute jamais de nouveau code sans vous. Un changement cassant d'intégration n'est jamais appliqué automatiquement — il est signalé et attend votre revue.
Chaque pack possède une politique de mise à jour (par défaut Automatique). Le contenu additif et sans egress — les sources de données de référence statiques et les nouveaux éléments de schéma d'ontologie — s'installe automatiquement dès qu'une mise à jour de pack atteint votre catalogue. Réglez la politique d'un pack sur Manuelle pour revoir chaque mise à jour vous-même ; tout ce qui appelle un système externe, exécute du code ou modifie un élément existant conserve toujours son étape de revue, quelle que soit la politique. Pour que vous ne manquiez jamais une mise à jour retenue, la page Packs signale les sources de données déclarées mais non installées (« N disponibles, non installées ») et la carte affiche un état non provisionné lorsque la table sous-jacente d'une couche est manquante — au lieu d'un « (0) » silencieux.
Voir où un pack est utilisé
La colonne En cours d'utilisation du tableau du catalogue indique ce que chaque pack installé a réellement produit dans votre organisation :
- Workflows — workflows déployés depuis le pack, par environnement d'espace de travail. Cliquez sur un workflow pour l'ouvrir dans Agentic.
- Flux de processus — instances de flux de processus actives créées à partir des modèles du pack. Le compteur représente le total réel ; le popover liste les 25 plus récents. Cliquez sur une instance pour l'ouvrir dans Agentic.
- Sources de données — sources de données installées depuis le pack. Cliquez pour ouvrir la page des sources de données dans Analytics.
Un tiret (—) signifie que le pack est dans votre catalogue mais n'est actuellement utilisé nulle part — signal utile avant de retirer un pack.
En développant une ligne de pack, vous obtenez les mêmes informations en détail, ainsi que les Workflows utilisant les intégrations de ce pack : les workflows de votre organisation dont les blocs appellent une intégration installée par ce pack. Il s'agit de la même analyse d'impact que celle effectuée lors d'une mise à jour — affichée en permanence pour vous permettre d'évaluer le rayon d'action avant de retirer ou de mettre à jour un pack.
Si un panneau affiche État indisponible, un service sous-jacent n'a pas pu être atteint ; les autres panneaux restent exacts.
Colonne État d'installation
Chaque ligne de l'onglet Catalogue affiche un pack à sa version la plus récente disponible. La colonne État d'installation indique l'état le plus important parmi tous les types de contenu de ce pack :
| État | Signification |
|---|---|
| Mise à jour disponible | Au moins un type de contenu dispose d'une version plus récente dans le catalogue que celle actuellement installée. |
| Installé | Tous les types de contenu installés sont à jour (aucune mise à jour nécessaire). |
| Non installé | Aucun contenu de ce pack n'a été installé dans votre organisation. |
Lorsqu'une mise à jour est disponible, la colonne version affiche la version installée aux côtés de la plus récente : par exemple v1.1.0 → v1.1.1.
Ligne développée — État par type de contenu
Cliquez sur une ligne pour la développer et voir l'état d'installation ventilé par type de contenu :
Intégrations
Une ligne par vendeur inclus dans le pack. Affiche la version installée et indique si une mise à jour est en attente. La vérification de mise à jour est basée sur le hash de l'artefact : si l'artefact publié diffère de celui installé, une mise à jour est disponible.
Ontologie et domaines KB
Affiche la version du pack installée et la date de dernière application. Ces types de contenu s'appliquent à toute l'organisation au moment de l'installation.
Workflows
Affiche une ligne par environnement d'espace de travail dans lequel les workflows de ce pack ont été déployés. Chaque ligne inclut :
- Le nom de l'environnement d'espace de travail.
- La version du pack installée, ou version inconnue si le workflow a été déployé avant l'introduction du suivi de version. « Version inconnue » est sans gravité — le workflow fonctionne, mais sa version de pack ne peut pas être comparée.
Le déploiement d'un workflow dans un espace de travail est une action distincte effectuée dans la Marketplace. La page Packs affiche les workflows déjà déployés ; les environnements « non déployés » sont omis de la liste.
Sources de données
Affiche une ligne par environnement d'espace de travail dans lequel une source de données de ce pack est installée. L'installation et la mise à jour des sources de données se font dans Analytics → Marketplace : lorsqu'une version plus récente du pack est dans le catalogue, chaque source installée y affiche une action Mettre à jour vers vX qui réconcilie l'ensemble des sources de données du pack — les sources existantes sont actualisées, les sources ajoutées par la nouvelle version sont installées, et celles qu'elle a supprimées sont retirées. Voir Packs.
Flux de processus
Les flux de processus suivent toujours la version la plus récente du catalogue — ils n'ont pas de version installée fixe. La ligne développée affiche un badge le confirmant. Il n'y a pas d'action de mise à jour pour les flux de processus ; ils utilisent automatiquement le contenu de la dernière ligne de catalogue active pour ce pack.
Mise à jour d'un pack
Lorsqu'au moins un type de contenu dispose d'une mise à jour disponible, une barre de mise à jour apparaît en haut de la ligne développée.
Cliquez sur le pack dans l'onglet Catalogue pour ouvrir la vue développée. Si une mise à jour est disponible, la barre de mise à jour affiche la version cible (par exemple, Mettre à jour vers v1.1.1) et un résumé des intégrations qui seront affectées.
Pour les packs incluant du contenu d'intégration, la plateforme charge automatiquement une analyse d'impact sur les workflows — indiquant quels workflows référencent des outils des intégrations de ce pack. Le bouton Mettre à jour le pack reste désactivé jusqu'à la fin de cette analyse.
Si le chargement de l'analyse d'impact échoue, le bouton Mettre à jour le pack reste désactivé. Vérifiez votre connexion réseau ou contactez votre administrateur de plateforme.
La plateforme compare les manifestes d'intégration installé et cible, et liste les changements incompatibles détectés directement dans la barre de mise à jour : outils supprimés, nouvelles entrées obligatoires, types d'entrée/sortie modifiés ou changements de mode d'authentification — chacun annoté avec l'outil concerné.
Deux niveaux d'avertissement peuvent apparaître :
- Potentiellement incompatible (orange) — la mise à jour est une version majeure, ou le diff de manifeste a trouvé des changements incompatibles correctement déclarés par l'auteur.
- Changements incompatibles dans une mise à jour non majeure (rouge) — le diff de manifeste a trouvé des changements incompatibles mais la version n'est incrémentée qu'en mineur ou en patch. Traitez cela avec une vigilance accrue et contactez l'auteur du pack.
Examinez la liste des workflows affectés en lien avec ces constats avant de continuer.
La plateforme installe la dernière version du catalogue pour ce pack. Les types de contenu à l'échelle de l'organisation sont mis à jour ensemble — intégration, ontologie et domaines KB. Un toast de succès confirme la mise à jour.
Le contenu par environnement est mis à jour depuis sa propre interface : les sources de données depuis la Marketplace Analytics (où la mise à jour réconcilie l'ensemble des sources du pack — voir Sources de données ci-dessus), et les workflows en les redéployant depuis la Marketplace agentic.
Cliquer sur Mettre à jour le pack déplace également le pin de version de votre organisation pour les intégrations du pack : les exécutions de workflows en cours se terminent avec la version qu'elles ont démarrée, et les nouvelles exécutions utilisent la version mise à jour.
Épinglage de version et politiques de mise à jour
Les versions d'intégration installées sont épinglées par connexion. Une version plus récente arrivant dans votre catalogue (par exemple via une synchronisation de source pack Git) est mise en attente mais inactive — rien ne change dans ce qu'exécutent vos workflows tant que le pin ne bouge pas. Le pin se déplace de deux façons :
- Manuellement — vous cliquez sur Mettre à jour le pack après la revue d'impact (comportement par défaut pour chaque connexion).
- Automatiquement — une connexion peut s'inscrire aux mises à jour automatiques via sa politique de mise à jour :
| Politique | Comportement |
|---|---|
manual (défaut) | Les mises à jour sont uniquement mises en attente ; vous les appliquez depuis la page Packs. |
auto_patch | Les versions patch (1.1.0 → 1.1.1) s'appliquent automatiquement lorsque le diff de manifeste ne détecte aucun changement incompatible. |
auto_minor | Les versions patch et mineures s'appliquent automatiquement lorsque le diff de manifeste ne détecte aucun changement incompatible. |
Les mises à jour automatiques ne s'appliquent jamais lorsque le diff de manifeste détecte un changement incompatible — la connexion est signalée (mise à jour bloquée : breaking_diff) et la mise à jour attend votre révision manuelle sur la page Packs. Les versions majeures nécessitent toujours une mise à jour manuelle.
Erreurs de compatibilité SDK
Les bundles d'intégration sont compilés contre une version spécifique du SDK de création Scrydon. Si un bundle a été construit contre un contrat SDK que la plateforme ne supporte plus (ou pas encore), vous verrez :
- Au moment de l'installation : l'installation du pack échoue avec
integration_contract_incompatibleet un message indiquant les versions de contrat concernées. - Au moment de l'exécution : les outils du bundle échouent avec
BUNDLE_CONTRACT_INCOMPATIBLEau lieu de s'exécuter.
Ces deux messages signifient la même chose : le bundle doit être republié avec une version actuelle de @scrydon/sdk-authoring. Si vous êtes l'auteur du pack, reconstruisez-le avec le dernier SDK et publiez une nouvelle version ; s'il provient d'un vendeur, demandez-lui une version mise à jour. Les bundles construits contre le contrat SDK immédiatement précédent continuent de fonctionner — la plateforme effectue la traduction automatiquement.
Autres versions actives du catalogue
En bas de la ligne développée, Autres versions actives du catalogue liste les versions plus anciennes de ce pack encore présentes dans votre catalogue (par exemple, si une version précédente était installée et que le catalogue n'a pas été nettoyé). Ces entrées sont informatives — elles indiquent ce qui est disponible mais ne constituent pas la version installée active.
Trouver les mises à jour des intégrations dans la Marketplace
Lorsqu'une intégration de pack dispose d'une mise à jour, sa carte dans Paramètres → Plateforme → Intégrations → Ajouter une intégration affiche un badge Mise à jour au lieu du statut habituel. Cliquer sur la carte ou son action ouvre Paramètres → Plateforme → Packs avec le pack concerné présélectionné, afin que vous puissiez examiner l'impact et appliquer la mise à jour depuis cet emplacement.
Les intégrations déjà installées et à jour affichent un indicateur À jour dans le groupe Depuis votre catalogue de packs. Elles restent visibles pour vous permettre d'ouvrir la configuration du vendeur sans quitter la marketplace.