Aller au contenu

Marketplaces de plugins

Une marketplace est un catalogue de plugins interrogé par l'API v1 (/api/v1/meta, /api/v1/plugins, /api/v1/plugins/{slug}). L'installation passe toujours par git.

Marketplace d'origine

Au premier démarrage, la marketplace default est créée depuis l'environnement du service web :

Variable Rôle Défaut
HARNESS_DEFAULT_MARKETPLACE_URL adresse interne http://marketplace:8090
HARNESS_DEFAULT_MARKETPLACE_PUBLIC_URL adresse publique (liens) vide
HARNESS_DEFAULT_MARKETPLACE_TOKEN jeton de lecture (catalogues privés) vide

Le jeton est importé une seule fois dans le coffre (secret core/marketplace/default) ; il n'est jamais réaffiché. Elle ne se supprime pas, on peut la désactiver.

Gérer les marketplaces

Opérations core.marketplace.list|get|add|update|remove|token.set|test|search. Ajout, modification, suppression et jeton sont réservés à un humain connecté, avec ré-authentification récente. test vérifie la méta publique puis la lecture du catalogue avec le jeton.

Public = sans jeton ; privé = avec jeton. Un refus 401 de la marketplace est affiché tel quel : il n'y a jamais de repli silencieux sur le catalogue public.

Installer un plugin

Écran Installer un plugin (/admin/plugins/install) :

  1. Chercher dans toutes les marketplaces actives (résultats fusionnés, étiquetés), ou saisir une URL git.
  2. Lire l'aperçu : type, droits, domaines de sortie, secrets, réglages, état de la CI. Rien n'est installé à ce stade.
  3. Consentir. Le plugin est installé en mode shadow (il reçoit, ne transmet pas).

L'opération core.plugin.install suit le même chemin que core.plugin.source.add : les préfixes de plugins.allowed_prefixes restent imposés et la CI doit être verte.

Dépôts privés

Si la marketplace fournit un identifiant de clone, il est rangé dans le secret core/plugins_git_token/<plugin> (utilisateur:jeton). Il sert au clone, aux vérifications et aux mises à jour de ce plugin, à défaut le jeton global core/plugins_git_token. Il disparaît à la désinstallation.

Limite connue

Les requêtes vers les marketplaces partent du service web, sur le réseau edge, qui est interne : une marketplace externe n'est joignable qu'avec un routage de sortie ajouté par l'exploitant.