Importation de données historiques pour DevOps les outils
Utilisez le catalogue de services pour intégrer une nouvelle application et importer des données historiques DevOps pour cette application. Activez l’interrogation pour importer des données mappées vers les plans, référentiels et pipelines associés à 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 des données historiques pour un DevOps outil que vous avez déjà intégré, à l’aide du formulaire de catalogue d’intégration d’application. Actuellement, vous pouvez importer des données historiques pour les 90 derniers jours à partir de la date actuelle et activer l’interrogation à une fréquence planifiée pour les outils suivants :
- Jira (Planifier)
- 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 pour l’outil de plan (Jira) sont traitées en premier, suivies des demandes d’importation de référentiel et de pipeline.
Importer le workflow et les nouvelles tentatives
Une fois la demande du catalogue en libre-service soumise avec succès, la demande est envoyée pour approbation en suivant le flux d’approbateur désigné que vous avez configuré. Lorsque la demande est approuvée, un événement entrant est créé pour la demande d’intégration de l’application. Le champ Détails du traitement de l’enregistrement de l’événement entrant affiche l’ID et l’état de la demande d’importation. Une seule demande d’importation crée plusieurs pages de demande d’importation enfants qui s’affichent dans la liste connexe. Les pages de demande d’importation sont créées en fonction de la logique suivante pour les outils pris en charge :
- Jira: une page est créée pour une plage de 15 jours.
- GitHub : une page est créée tous les 100 commits.
- 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
- Validateurs
- Balises
- Référentiels
- Éléments de travail
Lors du traitement d’une demande d’importation, en cas d’erreur de page, un mécanisme de nouvelle tentative intégré tente de traiter la page un nombre défini de fois. Après toutes les nouvelles tentatives automatiques, si la page est toujours dans l’état d’erreur, les pages suivantes ou restantes de la demande d’importation sont traitées. L’état global de la demande d’importation reste en erreur.
Par exemple, si la demande d’importation du plan a échoué (après toutes les nouvelles tentatives), nous procéderons au traitement des importations de référentiel et de pipeline. Vous pouvez configurer les nouveaux essais pour la demande d’importation à partir de .
- Spécifiez le nombre de nouvelles tentatives de tentative automatique, au cas où la page de demande d’importation échouerait dans le champ Nombre maximal de nouvelles tentatives par page, lors de l’importation . Si, après toutes les nouvelles tentatives automatiques, la page n’aboutit pas, la demande d’importation traitera les pages restantes. L’état général de la demande d’importation se reflète comme une erreur.
- Vous pouvez réessayer manuellement une tentative d’importation ayant échoué en cliquant sur le bouton Réessayer l’importation , sur la page de demande d’importation ayant échoué.
Calendrier et configuration de l’interrogation
Activez l’interrogation pour importer DevOps des données à une fréquence planifiée vers des applications qui ont importé des données historiques et qui sont mappées aux plans, référentiels et pipelines associés.
Une fois que vous avez intégré une application et importé les données associées DevOps , vous pouvez activer le calendrier du système de base pour que les demandes d’importation soient créées pour les plans, référentiels et pipelines suivis et associés à une application. Une fois le traitement des demandes d’importation terminé, les données associées sont conservées et affichées par rapport à l’application. Bien que la tâche planifiée DevOpsImportPolling du système de base soit active par défaut, vous devez activer l’interrogation DevOps à partir des propriétés pour exécuter la tâche planifiée.
Pour activer l’interrogation, accédez à et cochez la case.
L’activation de ce marqueur de propriété active la tâche planifiée DevOpsImportPolling du système de base. La tâche planifiée pour l’interrogation prend en compte soit la dernière importation réussie, soit les 30 jours, la date la plus tardive étant la « date de début », et la date du jour comme « date de fin » pour l’importation de données, pour toutes les applications actives qui ont des pipelines suivis. La tâche 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 la tâche d’interrogation planifiée importe le delta des données pertinentes DevOps pour cette application, de la dernière importation réussie jusqu’à ce jour, jusqu’à un maximum de trente jours.
Remarque :
La fréquence par défaut de la tâche est définie pour s’exécuter quotidiennement à minuit à l’aide du fuseau horaire du système. Pour modifier la fréquence du travail planifié, vous avez besoin du rôle d’administrateur ServiceNow ServiceNow AI Platform (admin).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 , selon vos besoins. Pour plus d’informations, voir Planifier des tâches
Remarque :
- La tâche planifiée s’applique uniquement 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 appropriés.
- 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 par défaut est UTC. Pour plus d’informations, consultez Jenkins la documentation sur les fuseaux horaires du système.
Les tâches planifiées qui effectuent une interrogation pour importer DevOps des données respectent les valeurs par défaut pour les propriétés suivantes DevOps liées aux importations et aux demandes d’importation :
- 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 « vrai ». Tout le reste est considéré comme faux.
Importer des pipelines, référentiels et plans existants Azure DevOps
Après l’intégration Azure DevOps à DevOps, vous pouvez importer jusqu’à 90 jours de données de pipeline, de référentiel et de plan existantes Azure DevOps . Vous pouvez ensuite utiliser DevOps des tableaux de bord pour afficher et gérer les Azure DevOps données.
Avant de commencer
Rôle requis : admin
Pourquoi et quand exécuter cette tâche
- Vous demanderez les données du catalogue de services en tant qu’élément de catalogue prédéfini.
- Les résumés de 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 de l’analyse SonarQube ne sont pas importés.
- Azure DevOps impose les restrictions suivantes :
- Vous pouvez importer au maximum 20 000 éléments de travail tous les 15 jours.
- Un maximum de 200 validations d’exécution peuvent être mappées à n’importe quelle exécution de pipeline.
- Les résultats des tests pour les exécutions de pipeline de plus de 7 jours ne sont pas renvoyés.
Remarque :
Le processus d’importation peut prendre un certain temps, 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 d’intégration de 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 Azure DevOps instance.
-
Sélectionnez l’icône Sélectionner dans la liste (icône
) dans le champ Application , puis sélectionnez votre instance de Azure DevOps.
Maintenant que vous avez spécifié l’instance, vous spécifiez la plage de dates et les sources des données à importer. -
Répétez la procédure suivante pour chaque pipeline, référentiel et plan que vous souhaitez importer :
-
Sélectionnez l’icône Sélectionner dans la liste ( ) dans le champ d’intégration approprié pour sélectionner l’élément à importer.
Vous pouvez sélectionner plusieurs éléments.
-
Sélectionnez l’icône 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 approuver la demande.
Importer les pipelines et référentiels existants GitLab
Après l’intégration GitLab à DevOps, vous pouvez importer jusqu’à 90 jours de données de pipeline et de référentiel existantes GitLab . Vous pouvez ensuite utiliser DevOps des tableaux de bord pour afficher et gérer les GitLab données.
Avant de commencer
Rôle requis : admin
Pourquoi et quand exécuter cette tâche
- Vous demanderez les données du catalogue de services en tant qu’élément de catalogue prédéfini.
- Les résumés de 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é artifacts sont importés.
- Les résultats des tests ne sont pas affichés pour les artefacts qui ont expiré. 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 de l’analyse SonarQube ne sont pas importés.
- Seuls 6400 validations par branche peuvent être importées en une seule importation.
- GitLab impose la restriction suivante : lors de l’association des validations d’exécution à une exécution de pipeline, GitLab ne fournit pas la partie de départ des détails de la validation dans certains scénarios. Il ne fournit que la partie précédant le SHA en tant que « 00000000000000000 ». Dans de tels scénarios, la dernière validation sera associée à la validation d’exécution. Par exemple, lorsqu’une nouvelle branche est créée ou lorsqu’un pipeline est exécuté manuellement.Remarque :Le processus d’importation peut prendre un certain temps, 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 d’intégration de 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 GitLab instance.
-
Sélectionnez l’icône Sélectionner dans la liste (icône ) dans le champ Application , puis sélectionnez votre instance de GitLab.
Maintenant que vous avez spécifié l’instance, vous spécifiez la plage de dates et les sources des données à importer.
-
Répétez la procédure suivante pour chaque référentiel que vous souhaitez importer :
-
Sélectionnez l’icône Sélectionner dans la liste (icône ) 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 Sélectionner dans la liste (icône
-
Sélectionnez le numéro de la demande afin que vous ou un autre utilisateur disposant du rôle administrateur puissiez approuver la demande.