Intégrations créées par les utilisateurs dans Vélocité de changement DevOps
Les intégrations créées par les utilisateurs permettent d’intégrer des outils de planification, de codage et de test supplémentaires qui ne sont pas disponibles par défaut dans l’application Vélocité de changement DevOps .
L’application Vélocité de changement DevOps inclut des définitions d’outils pour intégrer des éléments communs de planification, de codage et DevOps intégration d’outils de test, mais vous pouvez également configurer des intégrations créées par les utilisateurs pour des outils supplémentaires dans votre environnement DevOps.
Objets d’intégration
DevOps L’intégration de l’outil se compose de ces objets.
Actions d'aptitude de l'outil
- Action de connexion :
Lors de la connexion, le flux secondaire de l’outil spécifique est appelé et l’état de la connexion est mis à jour. Le message d’état de connexion s’affiche sur le formulaire.
Reportez-vous à la rubrique Flux secondaire de l’aptitude de Connexion pour en savoir plus.
- Découvrir l’action :
Lors de la détection, un enregistrement de demande d’importation est créé et le flux secondaire pour l’outil spécifique est appelé (tel que défini dans l’enregistrement d’aptitude d’intégration). Les champs Détails et État de l’enregistrement de demande d’importation sont mis à jour avec le nombre d’éléments détectés, mis à jour et échoués.
La charge utile transformée se compose d’un tableau d’objets sous forme de chaîne JSON. Les éléments varient en fonction du type d’outil.
Reportez-vous à la rubrique Détecter le flux secondaire d’aptitude pour en savoir plus.
- Action d’importation :
L’action d’importation ne prend pas en charge la fonctionnalité d’importation d’historique.
- Action de recherche :
Le flux principal de recherche est fourni pour prendre en charge le type d’outil d’artefact dans un flux secondaire créé par votre développeur d’intégration.
- Action de notification (webhook) :
L’outil source est configuré manuellement (par votre développeur d’intégration) pour envoyer des données brutes à l’instance ServiceNow . La charge utile brute est ensuite transformée en objet JSON standard à l’aide d’un flux secondaire.
Flux secondaire de l’aptitude de notification Pour plus d’informations, reportez-vous au point de terminaison DevOps : POST /devops/tool/{capability} de l’API DevOps.
Remarque :Si aucun flux secondaire n’est spécifié, la gestion des notifications est par défaut (la charge utile d’origine est automatiquement copiée dans la charge utile transformée).Ce comportement est utile lorsque les données transactionnelles de l’outil sont prises en charge par ServiceNow DevOps tel quel.
Consultez les charges utiles standard attendues dans le Flux secondaire de l’aptitude de notification pour plus de détails.
DevOps Vue d’ensemble de la configuration d’intégration
La configuration de l’intégration de l’outil peut être effectuée par votre développeur d’intégration et votre DevOps administrateur.
- Développeur d’intégration
- Créez un enregistrement d’intégration d’outils pour DevOps définir l’outil que vous intégrez (outil source).
- Créez un Studio de workflow flux secondaire pour collecter et transformer les données à partir de l’outil que vous intégrez (outil source).
- Créez un enregistrement de mappage de l’aptitude de l’outil dans DevOps pour mapper l’enregistrement d’intégration de l’outil à l’aptitude du type d’outil.Remarque :L’aptitude de notifications (webhook) est prise en charge. Les fonctionnalités de connexion et de découverte sont également prises en charge.
- Créez un enregistrement d’option d’intégration dans DevOps pour spécifier l’action relative à l’aptitude du type d’outil.
- DevOps administrateur
- Créez un enregistrement d’outil (planification, codage ou test) pour DevOps vous connecter à l’outil que vous intégrez (outil source).Remarque :L’enregistrement de l’intégration de l’outil doit être spécifié dans le champ Outil de l’enregistrement de l’outil.
- Configurez l’outil source avec le webhook et les informations d’identification.
- Créez un enregistrement d’outil (planification, codage ou test) pour DevOps vous connecter à l’outil que vous intégrez (outil source).
Événements entrants
Un événement entrant sert d’aire de transit pour le flux de notifications qui prend en charge le retraitement des charges utiles ayant échoué. En d’autres termes, un enregistrement dans un état d’erreur provenant d’une intégration ou d’une transformation ayant échoué peut faire l’objet d’une nouvelle tentative.
Si un enregistrement d’événement entrant est à l’état Erreur , le flux n’a pas été en mesure d’insérer l’enregistrement dans les tables principales DevOps .
Les erreurs courantes peuvent être résolues à l’aide de ces actions.
| Erreur | Action |
|---|---|
| Champs obligatoires manquants | La charge utile transformée ne correspond pas à la charge utile standard. Reportez-vous aux charges utiles standard et JSON fournies. |
| Le référentiel n’est pas marqué pour le suivi. | La validation ne peut pas être insérée. L’administrateur DevOps doit suivre le référentiel. |
| [Flux secondaire] n’a pas été publié dans le périmètre de l’application [app_scope] | Le flux secondaire est créé, mais n’est pas encore publié. |
| Exception de délai d’expiration | Le flux secondaire prend plus de temps que la valeur définie dans la propriété : com.glide.hub.flow_api.default_execution_time Pour plus d’informations, consultez FlowAPI : executeSubflowQuick(nom de chaîne, entrées de carte, délai d’expiration du numéro). Remarque : L’exécution du flux secondaire dépasse la valeur définie dans le champ Délai d’expiration de l’enregistrement d’aptitude d’intégration. |
| Flux secondaire correspondant pour l’intégration de l’aptitude de notification et de l’outil [tool_integration_sys_id] | Le flux n’a pas pu trouver le flux secondaire correspondant. Vérifiez la procédure de configuration de l’intégration. |
| La charge utile ne correspond pas à l’aptitude attendue. | La charge utile d’origine (charge utile envoyée) est d’un type d’aptitude différent de l’aptitude de type d’outil configurée dans votre mappage d’aptitudes d’outils. Le type de charge utile doit correspondre à l’aptitude de type d’outil configurée dans votre intégration d’outils. |
- L’outil source n’a pas transmis l’ID de l’outil comme paramètre de requête.
- L’outil source a transmis un ID d’outil, mais il n’y a pas d’ID d’outil correspondant dans l’instance.
Mappages d’outils
Un outil peut être mappé à plusieurs options.
| Intégration d'outils | Aptitude du type d'outil | Mappage des aptitudes de l’outil | |
|---|---|---|---|
|
|
Plan
Code
Orchestration
Test
|
|
Un mappage d’aptitudes d’outil peut être mappé à plusieurs actions.
| Mappage des aptitudes de l’outil | Action de l'outil | Option d'intégration | |
|---|---|---|---|
|
|
Agile Development 2.0
Azure DevOps
Bitbucket
GitHub
GitHub Enterprise
GitLab
Jenkins
Jira
Rally
|
|
Plusieurs types de tests peuvent être mappés à chaque intégration d’outils.
| Type de test | Intégration d'outils | Mappage de type de test |
|---|---|---|
Unité : JUnit, XUnit, NUnit, Test unitaire Fonctionnel:
Performances : chargement |
|
Azure DevOps
Jenkins
GitLab
GitHub et GitHub Enterprise
|