Création de plug-ins avec le kit de développement de logiciels de plug-ins#
Vous pouvez créer vos propres plug-ins et les installer dans HCL™ Accelerate. Après avoir installé des plug-ins personnalisés, vous pouvez les intégrer dans vos éditions, rapports et chaînes de valeur.
HCL Accelerate fournit un kit de développement logiciel qui contient les outils, y compris les dépendances locales et les encapsuleurs, dont vous avez besoin pour créer vos propres plug-ins. Le kit de développement logiciel de plug-in fournit un exemple de plug-in que vous pouvez utiliser pour démarrer, et des modèles JavaScript que vous pouvez personnaliser pour vos propres plug-ins.
Pour créer un plug-in, votre environnement de développement doit inclure les éléments suivants :
- Node.js version 12 ou ultérieure
- NPM version 6 ou ultérieure
- Docker
- HCL Accelerate version 2.0 ou ultérieure
Pour démarrer avec le kit de développement logiciel de plug-in, procédez comme suit :
- Téléchargez le kit de développement logiciel de plug-in. Dans l'onglet HCL Accelerate Plug-ins, cliquez sur Télécharger l'exemple de plug-in. Une fois le téléchargement terminé, extrayez le fichier compressé.
-
Générez l'exemple de plug-in. Dans le dossier ucv-ext-sdk-template, exécutez les commandes suivantes. Des instructions supplémentaires sont fournies dans le fichier du kit de développement de logiciels Readme.md.
npm install npm run dist-runnable docker build . -t name:tag
La valeur
name
peut être n'importe quelle valeur que vous souhaitez. La valeurtag
doit représenter la dernière version de l'image ou une autre version sémantique valide. Par exemple,docker build . -t testplugin:0.1
. -
Transférez l'exemple de plug-in. Dans l'onglet HCL Accelerate Plug-ins, cliquez sur Charger le plug-in, puis sélectionnez l'image Docker qui contient votre plug-in. Pour transférer l'image à partir de l'étape précédente, spécifiez
testplugin:0.1
. - Créez une intégration à l'aide de l'exemple de plug-in. Dans l'onglet Plug-ins, cliquez sur Ajouter une intégration.
Les plug-ins sont catégorisés à l'aide de méthode de collecte de données et de communication. En règle générale, les plug-ins sont conçus pour utiliser l'une des méthodes de communication suivantes.
- Webhook. Ces plug-ins utilisent des Webhooks pour communiquer avec un nœud final d'API HCL Accelerate défini. Le Webhook sert à déclencher des événements de collecte de données. Les plug-ins AppScan™ et SonarCube sont des exemples.
- Poller. Ces plug-ins se basent sur un événement défini par le plug-in. Des requêtes sont effectuées afin de déterminer le moment d'envoyer et de mettre à jour des données à partir du service externe. Les plug-ins GitHub™ et Rally sont des exemples.
- Parser. Ces plug-ins intègrent des fonctions permettant d'analyser un type de fichier spécifique et de créer un document d'indicateurs que HCL Accelerate peut afficher avec d'autres vues de portefeuille et de gestion de chaîne de valeur. Les plug-ins JUnit et OneTest sont des exemples.
Le kit de développement logiciel de plug-in fournit des modèles JavaScript pour chaque type. Par exemple, le modèle ucv-ext-sdk-templates/src/endpoints/SampleEdnpoint.js définit les propriétés dont vous avez besoin pour créer un plug-in de type de point de terminaison.
Sujet parent : Extension des fonctions du produit