Créer une intégration d’outils DevOps

Pour créer une intégration d’outil DevOps, votre développeur d’intégration configure des paramètres d’intégration d’outils DevOps et un Studio de workflow flux secondaire pour collecter et transformer les données à partir de l’outil source. Ensuite, votre DevOps administrateur configure vos DevOps connexions d’outils.

Avant de commencer

Remarque :

Lors de la création d’une intégration en tant qu’application incluse dans le périmètre, l’administrateur système doit affecter ces rôles au développeur d’intégration afin que celui-ci puisse créer des enregistrements d’intégration d’outils et d’options d’intégration pour le champ d’application spécifique.

• Rôle de développeur pour l’application incluse dans le périmètre
• DevOps Rôle administrateur

Rôle requis : sn_devops.admin

Pourquoi et quand exécuter cette tâche

La création d’une procédure d’intégration d’outils DevOps implique une configuration à la fois par votre développeur d’intégration et votre DevOps administrateur.

• Votre développeur d’intégration crée un enregistrement d’intégration d’outil dans DevOps, un Studio de workflow flux secondaire, un mappage d’aptitude d’outil et un enregistrement d’option d’intégration dans DevOps pour mapper les options et les actions ensemble.
  Remarque :

  Les fonctionnalités de notification, de connexion et de détection sont prises en charge.
• Votre DevOps administrateur configure les connexions DevOps (outil de planification ou de codage) et configure l’outil source avec le webhook et les informations d’identification.

Cette procédure fournit des étapes détaillées pour créer votre DevOps intégration d’outils.

Procédure

1. Développeur d’intégration :
   Configurez les options et les actions d’intégration de l’outil source, ainsi qu’un flux secondaire.
   1. Accédez à la DevOps > Intégrations > Intégrations d'outils et créez un enregistrement pour définir l’outil que vous intégrez (outil source).
      Remarque :

      Ne modifiez pas les enregistrements d’intégration d’outils fournis avec l’application DevOps .

      Tableau 1. Intégration de l’outil DevOps

      Étiquette d'outil	Exemple d’outil de code
      Table	Outil de code [sn_devops_tool]
      Utiliser des intégrations packageables	Sélectionné
      Version d'intégration	1.0
      Actif	Sélectionné

   2. Accédez à la Concepteur de flux > Concepteur et créez un flux secondaire pour collecter et transformer les données de l’outil que vous intégrez (outil source).
      Remarque :

      Le champ Exécuter en tant que doit être défini sur Utilisateur système et l’étiquette Entrées doit être définie sur la variable actuelle.

      Tableau 2. Propriétés du flux secondaire de notification

      Nom	Notification de l’outil de code
      Application	Exemple d’application d’intégration
      Accessible depuis	Tous les périmètres de l'application
      Description	Outil de code pour l’application d’intégration
      Exécuter en tant que	Utilisateur système

      Le flux secondaire doit contenir Obtenir plus de données via des appels API et/ou transformer la charge utile d’origine. Copiez la charge utile transformée dans l’enregistrement des événements entrants.

      Remarque :

      Ne modifiez pas le flux principal DevOps.
   3. Accédez à la DevOps > Intégrations > Mappages des aptitudes de l'outil et créez un enregistrement pour mapper l’enregistrement d’intégration de l’outil à l’aptitude du type d’outil.

      Tableau 3. DevOps Mappage de l’option de l’outil

      Intégration d'outils	Exemple d’outil
      Aptitude du type d'outil	Code

   4. Accédez à la DevOps > Intégrations > Options d'intégration et créez un enregistrement pour spécifier l’action pour le mappage des aptitudes de l’outil.
      Remarque :

      Ne modifiez pas les enregistrements d’aptitude d’intégration fournis avec l’application DevOps .

      Tableau 4. DevOps Option d’intégration

      Intégration d'outils	Exemple d’outil de code
      Mappage d'aptidudes	Exemple de code Tool-Code Remarque : Ne modifiez pas les enregistrements d’aptitude de type d’outil.
      Action	Notification Remarque : Ne modifiez pas les enregistrements d’actions d’outils.
      Actif	Sélectionné
      Délai d'expiration (ms)	Délai d’expiration du flux secondaire correspondant. Si l’exécution du flux secondaire dépasse cette valeur, une exception de délai d’expiration se produit. La valeur est en millisecondes (ms). La valeur par défaut est 45 000 (45 secondes).
      Nom de flux secondaire	x_snc_sample_integ.code_tool_notification Le nom est précédé du nom du périmètre et d’un point (.) avant le nom réel du flux secondaire. Par exemple, étant donné : connect_code_tool flux secondaire my_app_scope champ d’application La valeur de ce champ est my_app_scope.connect_code_tool. Remarque : Si le champ Nom du flux secondaire est laissé vide pour une option de notification, les notifications sont gérées par défaut. Voir Action d’aptitude de l’outil de notification.
      Domaine	global

2. DevOps Admin:

   Configurez la connexion DevOps depuis l’outil source.

   1. L’enregistrement de l’outil doit contenir :
      • Référence à l’enregistrement d’intégration d’outils créé par le développeur d’intégration (dans le champ Outil )
      • Étiquette d'outil
      • Alias de connexion (connexion et informations d’identification)
   2. Copiez la notification (webhook) créée sur l’outil DevOps de planification sur le hook de service de l’outil source du point de terminaison de notification et définissez les informations d’identification sur devops.integration.user.
   Vous pouvez afficher l’état des événements d’intégration dans la liste des événements entrants (DevOps > Administration > Événements entrants).

   L’état de l’enregistrement de l’événement entrant est défini sur Traité une fois que l’objet a été inséré dans la table DevOps Core. Les états des événements comprennent Nouveau, En cours, Traité, Sans correspondance et Erreur.

3. Si l’enregistrement d’intégration de l’outil et le flux secondaire sont créés dans un champ d’application différent, l’administrateur DevOps doit créer deux nouveaux enregistrements de privilèges entre périmètres pour permettre à l’application d’accéder à la table des événements entrants.
   Accédez à la Applications système > Accès à l'application entre périmètres et créez des enregistrements de privilèges entre périmètres en lecture et en écriture pour permettre à votre application d’accéder à la table des événements entrants.

   Champ	Lire	Écriture
   Périmètre source	Rempli automatiquement en fonction de l’application actuelle
   Périmètre cible	DevOps
   Nom cible	sn_devops_inbound_event
   Type cible	Table
   Opération	Lire	Écriture
   Statut	Autorisé

Exemple

Figure 1. DevOps intégration d’outils

Figure 2. Studio de workflow Propriétés de flux secondaire

Figure 3. Studio de workflow flux secondaire

Figure 4. Studio de workflow DevOps Intégration : flux de notification

Figure 5. DevOps Mappage de l’option de l’outil

Figure 6. Option d'intégration

Figure 7. Outil de planification

Figure 8. Enregistrements d’accès entre périmètres (lecture et écriture)