Création d'intégrations de plug-in#
Utilisez des outils externes en définissant des intégrations.
Les intégrations exigent des données d'identification d'utilisateur et des informations de connexion, comme des URL et des nœuds finaux d'API. Pour créer une intégration avec UrbanCode™ Deploy, par exemple, vous avez besoin d'un jeton utilisateur généré par UrbanCode Deploy, ainsi que l'URL de l'endroit où se trouve le serveur. Veillez à disposer de toutes les informations de connexion nécessaires avant de démarrer.
Les données d'identification et les autres propriétés de connexion varient d'un plug-in à un autre. Vous pouvez trouver des descriptions de propriété et des cas d'utilisation pour tous les plug-ins sur le site Web d'UrbanCode.
Un plug-in est un module complémentaire logiciel conçu pour communiquer avec des services et des applications externes. Chaque plug-in définit un type d'enregistrement attendu et une méthode de communication. La communication peut être unidirectionnelle ou bidirectionnelle. Pour utiliser un plug-in, vous configurez une intégration. Il existe trois façons de configurer une intégration :
- Créer une définition d'intégration sur la page Plug-ins.
- Ajouter une définition d'intégration à un fichier JSON de la chaîne de valeur.
- Configurer une tâche de plan de déploiement pour l'un des types d'intégrations natives.
Cette rubrique décrit les deux premières méthodes. Les intégrations natives sont décrites dans une section distincte.
Pour configurer une intégration, procédez comme suit :
-
Sur la page IBM™ UrbanCode Velocity Accueil, cliquez sur
Paramètres > Intégrations > Plug-ins.La page Plug-ins répertorie les plug-ins disponibles. Vous pouvez librement utiliser les plug-ins répertoriés sans effectuer d'étape d'installation.
-
Cliquez sur Ajouter une intégration pour le plug-in que vous souhaitez utiliser, puis définissez les propriétés d'intégration.
-
Vous pouvez configurer des intégrations pour certains types de plug-in en ajoutant une définition d'intégration à un fichier JSON de chaîne de valeur.
A l'aide d'un éditeur de texte, définissez un objet d'intégration dans la matrice integrations du fichier
value_stream_name.json. L'exemple de code suivant illustre une intégration Jira.{ "_id": "velocity-generated-id", "type": "ucv-ext-jira", "tenant_id": "velocity-generated-id", "name": "my-JIRA", "disabled": false, "properties": { "baseUrl": "http://my-jira-url", "username": "admin", "password": "****", "jiraProjects": [ "My-Project" ] } },Les intégrations créées par la méthode de la chaîne de valeur s'affichent sur la page Intégrations, en plus d'intégrations créées par les autres méthodes.
L'intégration est répertoriée sur la page Intégrations. La page Intégrations vous permet de gérer des intégrations.
Les intégrations commencent à fournir des données dès qu'elles sont correctement configurées. Pour certains types d'intégration, comme les types qualité-données, vous pouvez commencer à utiliser leurs données sans configuration supplémentaire. Par exemple, vous pouvez créer des graphiques de tableau de bord contenant des données de qualité dès que vous terminez l'intégration. JUnit est un exemple de plug-in de type qualité.
D'autres types d'intégration exigent une configuration supplémentaire avant que vous ne puissiez commencer à utiliser leurs données. Les intégrations natives exigent que des tâches soient ajoutées aux plans de déploiement. Les intégrations de chaîne de valeur, comme GitHub™, exigent une référence dans le fichier JSON de la chaîne de valeur. Si vous définissez une intégration sur la page Plug-ins, ajoutez une référence au nom d'intégration dans le fichier JSON. Si vous définissez une intégration directement dans un fichier JSON, comme décrit à l'étape 3, aucune configuration supplémentaire n'est requise.
Pour de plus amples informations, reportez-vous à Installation de plug-ins dans des produits UrbanCode.
Sujet parent : Extension des fonctions du produit