Créer une intégration d’outils DevOps

Pour créer une intégration d’outil DevOps, votre développeur d’intégration configure DevOps les paramètres d’intégration de l’outil ainsi qu’un Studio de workflow flux secondaire pour collecter et transformer les données de l’outil source. Ensuite, votre DevOps administrateur configure les connexions de vos DevOps 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’intégration et d’intégration d’outils pour le périmètre 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 implique une DevOps 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’aptitude d’intégration dans pour mapper les options et les actions entre DevOps elles.
  Remarque :

  Les options de notification, de connexion et de détection sont prises en charge.
• Votre DevOps administrateur configure des 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 de l’intégration :
   Configurez les options et 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 codage [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 codage
      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 d’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 des options 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 d’aptitude 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 du type d’outil.
      Action	Notification Remarque : Ne modifiez pas les enregistrements d’actions de l’outil.
      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 exprimée 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 champ d’application précédé d’un point (.) avant le nom réel du flux secondaire. Par exemple, étant donné : connect_code_tool flux secondaire my_app_scope périmètre La valeur de ce champ est my_app_scope.connect_code_tool. Remarque : Si le champ de nom du flux secondaire est laissé vide pour une aptitude de notification, la gestion des notifications par défaut se produit. Reportez-vous à la section Action d’aptitude de l’outil Notification.
      Domaine	global

2. DevOps Admin:

   Configurez la connexion à partir de DevOps 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 vers le hook de service d’outils source du point de terminaison de notification et définissez les informations d’identification sur devops.integration.user.
   Vous pouvez consulter l’état des événements d’intégration dans la liste É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 périmètre 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 d’é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 d’événements entrants.

   Champ	Lecture	Écriture
   Périmètre source	Remplissage automatique en fonction de l’application actuelle
   Périmètre cible	DevOps
   Nom cible	sn_devops_inbound_event
   Type cible	Table
   Opération	Lecture	É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 des options 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)