Importer des données historiques pour les outils DevOps
Utilisez le catalogue de services pour intégrer une nouvelle application et importer des données historiques DevOps pour cette application. Activez la fonction d'interrogation pour importer les données mappées sur des plans, référentiels et pipelines associés selon une fréquence planifiée.
Importer des données historiques DevOps pour les outils existants
Vous pouvez créer une demande d'intégration d'application et importer les données historiques pour un outil DevOps que vous avez préalablement intégré à l'aide du formulaire de catalogue d'intégration d'application. Actuellement, vous pouvez importer des données historiques des 90 derniers jours à partir de la date actuelle et activer l'interrogation à une fréquence planifiée pour les outils suivants :
- Jira (Plan)
- GitHub et GitHub Enterprise (codage)
- Jenkins (Orchestration)
Remarque :
- Assurez-vous d'avoir créé, connecté et détecté l'outil pour lequel vous importez des données.
- Les demandes d'importation de l'outil Plan (Jira) sont traitées en premier, suivies des demandes d'importation de référentiels et de pipelines.
Workflow d'importation et nouveaux essais
Après avoir correctement soumis la demande de catalogue à partir du catalogue en libre-service, la demande est envoyée pour approbation en suivant le flux d'approbateur désigné que vous avez configuré. Une fois la demande approuvée, un événement entrant est créé pour la demande d'intégration d'application. Le champ Détails du traitement de l'enregistrement d'événement entrant affiche l'ID et l'état de la demande d'importation. Une seule demande d'importation crée plusieurs pages de demandes d'importation enfants qui s'affichent dans la liste connexe. Les pages de demandes d'importation sont créées selon la logique suivante pour les outils pris en charge :
- Jira : une page est créée pour une période de 15 jours.
- GitHub : une page est créée toutes les 100 validations.
- Jenkins : les pages sont créées par version.
Une fois l’importation réussie, vous pouvez afficher toutes les validations importées dans le :
- Succursales
- Validations
- Valideurs
- Balises
- Référentiels
- Éléments de travail
Pendant le traitement d'une demande d'importation, si une erreur se produit sur une page, un mécanisme de nouveaux essais intégré tente de traiter la page un nombre défini de fois. Après tous les nouveaux essais automatiques, si la page est toujours à l'état d'erreur, les pages suivantes ou restantes dans la demande d'importation sont traitées. L'état général de la demande d'importation reste erroné.
Par exemple, si la demande d'importation de plans a échoué (après tous les nouveaux essais), les importations de référentiels et de pipelines sont traitées. Vous pouvez configurer les nouveaux essais pour la demande d’importation à partir de .
- En cas d'erreur sur la page de demande d'importation, spécifiez le nombre de nouveaux essais automatiques dans le champ Nombre maximal de nouveaux essais par page lors de l'importation. Si, après tous les nouveaux essais automatiques, une erreur se produit sur la page, la demande d'importation traite les pages restantes. L'état général de la demande d'importation est erroné.
- Vous pouvez relancer manuellement une importation en échec en cliquant sur le bouton Réessayer l'importation sur la page de la demande d'importation ayant échoué.
Planifier et configurer l'interrogation
Activez l'interrogation pour importer des données DevOps selon un calendrier défini dans des applications disposant de données historiques importées, et qui sont mappées sur des plans, référentiels et pipelines associés.
Après avoir intégré une application et importé les données DevOps associées, vous pouvez activer le calendrier du système de base pour les demandes d'importation à créer pour les plans, les référentiels et les pipelines qui sont suivis et associés à une application. Au terme du traitement des demandes d'importation, les données associées sont conservées et s'affichent sur l'application. Bien que le travail planifié DevOpsImportPolling du système de base soit activé par défaut, vous devez activer l'interrogation à partir des propriétés de DevOps pour exécuter le travail planifié.
Pour activer l’interrogation, accédez à et cochez la case.
L'activation de ce marqueur de propriété active le travail planifié DevOpsImportPolling du système de base. Le travail planifié pour l'interrogation tient compte soit de la dernière importation réussie, soit des 30 derniers jours, la date la plus tardive étant la « date de début » et la date d'aujourd'hui étant la « date de fin » de l'importation de données, et ce, pour toutes les applications actives et dotées de pipelines suivis. Le travail recherche l'heure de la dernière importation réussie et crée la demande d'importation suivante en conséquence. Cette logique garantit que le travail planifié d'interrogation importe le delta de données DevOps pertinentes pour cette application, depuis la dernière importation réussie jusqu'à aujourd'hui, jusqu'à un maximum de trente jours.
Remarque :
La fréquence par défaut du travail est définie pour s'exécuter quotidiennement à minuit selon le fuseau horaire du système. Pour modifier la fréquence des travaux planifiés, vous devez disposer du rôle d'administrateur ServiceNow ServiceNow AI Platform (Administrateur).Ne configurez pas une fréquence d'interrogation inférieure à un jour ou 24 heures.
Accédez à la et modifiez les valeurs des champs Fréquence d’exécution , Fuseau horaire et Heure , le cas échéant. Pour plus d'informations, consultez Travaux planifiés.
Remarque :
- Le travail planifié ne s'applique qu'aux applications actives. Assurez-vous que l'application pour laquelle vous configurez l'interrogation est à l'état actif et que le champ Suivre est activé pour les pipelines pertinents.
- Tenez compte des éléments suivants lorsque vous modifiez la fréquence du calendrier :
- Pour JIRA, le fuseau horaire par défaut est basé sur le fuseau horaire de l'emplacement du serveur JIRA.
- Pour Jenkins, le fuseau horaire est défini par défaut sur UTC. Pour plus d'informations, consultez la Jenkins documentation sur les fuseaux horaires de l'heure système.
Les travaux planifiés qui activent l'interrogation pour importer des données DevOps respectent les valeurs par défaut des propriétés DevOps suivantes liées aux importations et aux demandes d'importations :
- Nombre maximal de nouveaux essais par page lors de l'importation
- Nombre maximal de pages à traiter à la fois pour une demande d'importation
- Pour enregistrer les charges utiles en tant que pièces jointes sur l'enregistrement de la page de demande d'importation, définissez le champ « Valeur » sur « true ». Tout le reste est considéré comme false.
Importer des pipelines, des référentiels et des plans Azure DevOps existants
Une fois que vous avez intégré Azure DevOps à DevOps, vous pouvez importer jusqu'à 90 jours de données de pipelines, de référentiels et de plans Azure DevOps existants. Vous pouvez ensuite utiliser les tableaux de bord DevOps pour afficher et gérer les données Azure DevOps.
Avant de commencer
Rôle requis : admin
Pourquoi et quand exécuter cette tâche
- Vous devez demander les données du catalogue de services en tant qu'élément de catalogue prédéfini.
- Les résumés des tests, les artefacts et les packages importés sont liés aux exécutions de pipelines et non aux exécutions d'étapes.
- Les résultats d'analyse SonarQube ne sont pas importés.
- Azure DevOps impose les restrictions suivantes :
- 20 000 éléments de travail au plus peuvent être importés tous les 15 jours.
- 200 validations d'exécution au plus peuvent être mappées à une exécution de pipeline.
- Les résultats des tests pour les exécutions de pipelines antérieures à 7 jours ne sont pas renvoyés.
Remarque :
Le processus d'importation peut prendre un certain temps, voire des heures pour de très grands ensembles de données.
Procédure
-
Sur le formulaire Élément de catalogue, sélectionnez Essayer pour demander les données.
Le formulaire Intégration avec l'application DevOps qui en résulte vous permet de spécifier l'élément de catalogue à commander. Dans ce cas, « l'application » à commander est votre instance Azure DevOps.
-
Sélectionnez l'icône Select in list (Sélectionner dans la liste) (
) dans le champ Application, puis sélectionnez votre instance de Azure DevOps.
Maintenant que vous avez spécifié l'instance, vous devez spécifier la plage de dates ainsi que les sources de données à importer. -
Répétez la procédure suivante pour chaque pipeline, chaque référentiel et chaque plan à importer :
-
Sélectionnez l'icône Select in list (Sélectionner dans la liste) ( ) dans le champ Intégration approprié pour sélectionner l'élément à importer.
Vous pouvez sélectionner plusieurs éléments.
-
Sélectionnez l'icône Select in list (Sélectionner dans la liste) (
-
Sélectionnez le numéro de la demande afin que vous ou un autre utilisateur disposant du rôle administrateur puissiez l'approuver.
Importer des pipelines et des référentiels GitLab existants
Une fois que vous avez intégré GitLab à DevOps, vous pouvez importer jusqu'à 90 jours de données de pipelines et de référentiels GitLab existants. Vous pouvez ensuite utiliser les tableaux de bord DevOps pour afficher et gérer les données GitLab.
Avant de commencer
Rôle requis : admin
Pourquoi et quand exécuter cette tâche
- Vous devez demander les données du catalogue de services en tant qu'élément de catalogue prédéfini.
- Les résumés des tests importés sont liés aux exécutions de pipelines et non aux exécutions d'étapes.
- Seuls les artefacts publiés à l'aide du mot clé artefacts sont importés.
- Les résultats des tests ne sont pas affichés pour les artefacts arrivés à expiration. Vous pouvez définir la date d'expiration d'un artefact en configurant la propriété expire_in dans le pipeline. Pour plus d'informations sur les politiques d'expiration des artefacts, consultez Expiration des métadonnées des artefacts et des tâches.
- Les résultats d'analyse SonarQube ne sont pas importés.
- Seules 6 400 validations par branche peuvent être importées en une seule fois.
- GitLab impose la restriction suivante : lors de l'association des validations d'exécution à une exécution de pipeline, GitLab ne fournit pas le début des détails de la validation dans certains scénarios. Il ne fournit que l'élément figurant devant le SHA sous la forme « 000000000000000000 ». Dans de tels scénarios, la dernière validation est associée en tant que validation d'exécution. Par exemple, lorsqu'une branche est créée ou lorsqu'un pipeline est exécuté manuellement.Remarque :Le processus d'importation peut prendre un certain temps, voire des heures pour de très grands ensembles de données.
Procédure
-
Sur le formulaire Élément de catalogue, sélectionnez Essayer pour demander les données.
Le formulaire Intégration avec l'application DevOps qui en résulte vous permet de spécifier l'élément de catalogue à commander. Dans ce cas, « l'application » à commander est votre instance GitLab.
-
Sélectionnez l'icône Select in list (Sélectionner dans la liste) ( ) dans le champ Application, puis sélectionnez votre instance de GitLab.
Maintenant que vous avez spécifié l'instance, vous devez spécifier la plage de dates ainsi que les sources de données à importer.
-
Répétez la procédure suivante pour chaque référentiel à importer :
-
Sélectionnez l'icône Select in list (Sélectionner dans la liste) ( ) dans le champ Référentiels d'intégration, puis sélectionnez l'élément à importer.
Vous pouvez sélectionner plusieurs éléments.
Remarque :les pipelines mappés aux référentiels sont automatiquement sélectionnés lorsque vous sélectionnez le référentiel dans le champ Référentiels d'intégration. Vous n'avez pas besoin de sélectionner les pipelines séparément. -
Sélectionnez l'icône Select in list (Sélectionner dans la liste) (
-
Sélectionnez le numéro de la demande afin que vous ou un autre utilisateur disposant du rôle administrateur puissiez l'approuver.