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) :
- Chercher dans toutes les marketplaces actives (résultats fusionnés, étiquetés), ou saisir une URL git.
- Lire l'aperçu : type, droits, domaines de sortie, secrets, réglages, état de la CI. Rien n'est installé à ce stade.
- 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.