Propriétés du Vélocité de changement DevOps
Utilisez ces propriétés pour configurer les paramètres de l'application Vélocité de changement DevOps.
Rôle requis : sn_devops.admin
Vous pouvez afficher les propriétés à partir de l’espace Changement DevOps de travail en accédant à .
Pour afficher les propriétés à partir de l’interface utilisateur classique, accédez à .
| Propriété | Description | Valeur par défaut | Nom |
|---|---|---|---|
| Nombre maximal de nouveaux essais pour les événements entrants erronés | Nombre maximal de nouvelles tentatives pour les événements entrants erronés. | 3 | [sn_devops.max_retry_count_inbound_event] |
| Options des outils | Options des outils prises en charge, saisies sous forme de valeurs séparées par des virgules. | code,plan,orchestration,artefact,test | [sn_devops.tool_capabilities] |
| Texte d'approbation de la demande de changement DevOps | Texte d'approbation de la demande de changement DevOps à utiliser pour les personnalisations de gestion des changements. | Approuvé | [sn_devops.change_request.approved_approval] |
| Demande de changement DevOps : appliquer des attributs à la création de changement |
Si cette option est activée, les attributs de changement sont appliqués lorsqu'un changement est créé. Si des politiques de données sont affectées aux attributs de changement, elles sont appliquées lorsque le changement est créé. Si cette propriété n'est pas activée, les attributs de changement sont appliqués après la création du changement, ce qui peut entraîner l'échec de la création du changement si des politiques de données sont présentes dans les attributs de changement. |
False (désactivé) | [sn_devops.change_request.apply_attributes_on_creation] |
| Durée du rapport d'intégrité du système DevOps (en jours) | La valeur par défaut est 7 derniers jours, pour afficher les mesures d'intégrité du système telles que les événements entrants. | 7 | [sn_devops.health_duration_report] |
| Activer l'association automatique des référentiels aux applications lors de l'exécution du pipeline | Si cette option est activée, elle associe automatiquement les référentiels aux applications et active le suivi lorsqu'un pipeline identifie des validations d'un référentiel qui n'est pas encore associé. Elle associe également les pipelines qui ne sont pas encore associés à l'application correspondante lorsque le référentiel est déjà affecté à l'application. | Oui (activé) | [sn_devops.enable_automatic_associations] |
| Nombre maximal de pages à traiter à la fois pour une demande d'importation | Nombre maximal de pages devant être traité à la fois pour une demande d'importation. | 10 | [sn_devops.import.max.pages.processing.per_import] |
| Flux secondaire de décision de réutilisabilité de demande de changement DevOps | Flux secondaire qui peut être appelé pour vérifier s'il est possible de réutiliser un changement précédemment créé au lieu d'en créer un nouveau. | sn_devops.change_request_reusability_subflow | [sn_devops.change_request_reusability_decision] |
| URL de l'GitHub | Pour GitHub, ce champ permet d'obtenir l'URL de l'API (pour les appels REST). | https://github.com | [sn_devops.github.url] |
| État de l'annulation de la demande de changement DevOps | État d'annulation de la demande de changement DevOps à utiliser pour les personnalisations de gestion des changements. |
4 (Annulé) |
[sn_devops.change_request.cancel_state] |
| Nombre maximal d'exécutions des outils Orchestration lors de l'importation | Nombre maximal d'exécutions d'outils d'orchestration lors de l'importation de travaux Freestyle Jenkins. | 1 000 | [sn_devops.import.orchestration_tool.executions.maximum] |
| 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. | Si la valeur true est sélectionnée, la charge utile JSON récupérée est enregistrée en tant que pièce jointe dans la page de 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. |
False (désactivé) | [sn_devops.import.save.payloads.as.attachments] |
| Marqueur de résumé de la qualité de logiciel non-administrateur DevOps | Activez cette option pour afficher et surveiller les analyses SonarQube configurées sur vos pipelines GitHub Actions, Jenkins ou Azure DevOps en tant qu'utilisateur non-administrateur SonarQube. | False (désactivé) | [sn_devops.non_admin_software_quality_summary_flag] |
| Type de test par défaut | Type de test par défaut des pipelines d'orchestration. | JUnit |
[sn_devops.default_test_type] |
| Branches d'outils de codage par page | Nombre de branches d'outils de codage par page. | 19 |
[sn_devops.import.coding_tool.branches.per_page] |
| Problèmes d'outils de planification par page | Nombre de problèmes d'outils de planification affichés par page. | 100 | [sn_devops.import.planning_tool.issues.per_page] |
| rôle sn_devops à ajouter automatiquement aux utilisateurs DevOps actifs | Le rôle sn_devops saisi dans le champ de valeur est automatiquement ajouté aux utilisateurs qui sont des utilisateurs DevOps actifs (par exemple, en effectuant une validation). Si un rôle hors du champ d'application de sn_devops est spécifié, il n'est pas ajouté. Laissez ce champ vide si aucun rôle ne doit être fourni automatiquement. |
sn_devops.viewer | [sn_devops.discovered.user.auto.assign.role] |
| Catégories de qualité de logiciel affichées par défaut dans la vue de pipeline de l'interface utilisateur | Catégories de qualité de logiciel affichées par défaut dans la vue de pipeline de l'interface utilisateur, saisies sous forme de valeurs séparées par des virgules. | coverage,lines_of_code,bugs,code_smells,duplications,vulnerabilities | [sn_devops.sq_ui_category_preferences] |
| Erreurs ou exceptions (séparées par des virgules) pour lesquelles les événements entrants avec erreur sont définis sur Réessayer | Erreurs ou exceptions pour lesquelles les événements entrants avec erreur sont définis sur Réessayer, saisies sous forme de valeurs séparées par des virgules. | TimeOutException,FlowObjectAPIException | [sn_devops.inbound_events_retry_error_list] |
| Niveau de connexion DevOps | Niveau de journal DevOps. Sélectionnez le niveau approprié parmi les suivants :
|
Avertissement | sn_devops.devops_log_level |
| Catégoriser les demandes de changement DevOps dans le champ Changement DevOps | . Sélectionnez cette option pour catégoriser les demandes de changement avec le champ Catégorie défini sur DevOps en tant que changement DevOps. Désélectionnez-la pour la désactiver. |
False (désactivé) | [sn_devops.custom_change_categorization] |
| Exécutions d'outils Orchestration par page | Nombre d'exécutions d'outils d'orchestration par page. | 50 | [sn_devops.import.orchestration_tool.executions.per_page] |
| Activer l'interrogation d'importation | Option permettant d'activer l'interrogation des demandes d'importation. Désactivez cette option pour désactiver l'interrogation. | False (désactivé) | [sn_devops.enable_import_polling] |
| Chemin de version de l'API GitHub | Chemin d'accès de la version de l'API GitHub. | /api/v3 | [sn_devops.github.api_version_path] |
| Délai de vérification d'autorisation d'outil (en millisecondes) |
Pendant le processus de connexion de l'outil, le système effectue des validations d'autorisation au premier plan et restreint la page de connexion de l'outil. Pour chaque validation d'autorisation, un appel d'API REST est effectué vers des outils externes afin d'évaluer la disponibilité de l'autorisation. Le délai de réponse de l'API REST peut varier en fonction de vos paramètres réseau. Pour éviter les retards, vous pouvez spécifier le délai que le système doit attendre pour obtenir une réponse d'un outil externe avant de marquer l'autorisation comme une erreur via cette propriété. |
10 000 | [sn_devops.permission_check_timeout] |
| Flux secondaire de modèle de réutilisabilité de demande de changement DevOps | Flux secondaire de modèle de réutilisabilité de demande de changement DevOps. | sn_devops.devops_reused_model_change_request | [sn_devops.devops_reused_model_change_request] |
| Temps écoulé (en minutes) | Temps écoulé, en minutes. La tâche de nouvelle tentative recherche les événements entrants avec erreur à partir du délai ou de la valeur spécifiée. | 1 440 (7 jours) | [sn_devops.inbound_events_error_retry_mins_ago] |
| Annuler la demande de changement lorsque l'étape associée du pipeline échoue ou est annulée |
Lorsque cette propriété est activée et que la tâche d'orchestration mappée sur une certaine étape de votre pipeline DevOps échoue ou est annulée, la demande de changement associée à cette étape est également annulée. Une demande de changement ne peut être annulée que si elle n'a pas déjà été rejetée ou si elle n'est pas à l'état Implémenter ou Examiner au moment de l'annulation. |
False (désactivé) | [sn_devops.cancel_change_on_pipeline_cancel] |
| Seuil de suppression en cascade (limite recommandée de premier plan : 1 000) | Seuil de suppression en cascade. | 1 000 | [sn_devops.cascade_delete_threshold] |
| Nombre maximal de nouveaux essais par page lors de l'importation | Nombre maximal de nouvelles tentatives par page lors de l'importation des données à partir des outils. | 3 | [sn_devops.import.max.retries.per_page] |
| État post-implémentation de la demande de changement DevOps | État post-implémentation de la demande de changement DevOps à utiliser pour les personnalisations de gestion des changements. |
0 (Examiner) |
[sn_devops.change_request.post_implement_state] |
| État d'implémentation de la demande de changement DevOps | État d'implémentation de la demande de changement DevOps à utiliser pour les personnalisations de gestion des changements. | -1 (Implémenter) | [sn_devops.change_request.implement_state] |
| Score du validateur par défaut | Score du validateur par défaut. | 50 | [sn_devops.committer.score.default] |
| Activez cette option pour suivre les demandes d'extraction (fusion) GitLab. Si cette option n'est pas activée, les demandes d'extraction (fusion) et les événements associés sont ignorés. | Lorsque cette propriété est activée, les demandes d'extraction (fusion) GitLab font l'objet d'un suivi dans Vélocité de changement DevOps. Si elle est désactivée, tous les événements de demande de fusion sont ignorés. | Oui (activé) | sn_devops.track.gitlab.pullrequests |
| Temps de réinitialisation de l'accélérateur par défaut en minutes à partir de l'heure actuelle | Si un outil ne prend pas en charge un délai de réinitialisation de l'accélérateur, le délai de réinitialisation de l'accélérateur est considéré comme l'heure actuelle, plus la valeur indiquée pour cette propriété. | 15 minutes | [sn_devops.throttle.reset.time.default] |
| Activez cette option pour suivre Azure DevOps les demandes d’extraction de code. Si cette option est activée, les webhooks de demande d’extraction Azure sont automatiquement configurés lorsque l’outil ou le projet est configuré. | Lorsque cette propriété est activée, les webhooks de demande d’extraction Azure DevOps sont automatiquement configurés à chaque fois qu’un outil ou un projet est configuré. | Oui (activé) | sn_devops.Track.Azure.Pullrequests |
| Facteur de multiplication pour le score des validateurs | Facteur de multiplication à utiliser pour le score du validateur. | 1 | [sn_devops.committer.score.multiply.factor] |
| Archivage automatique (en mois) | Durée après laquelle les données de table doivent être archivées automatiquement. | 9 | [sn_devops.table_auto_archive_duration] |
| Obsolète - Activer le marqueur de débogage (utiliser la nouvelle propriété Niveau de journal DevOps) |
Enregistreur de débogage DevOps.
Remarque : Cette propriété est déconseillée, utilisez plutôt la propriété (DevOps Niveau de journal sn_devops.devops_log_level). |
Oui (activé) | [sn_devops.enable_debug] |
| Temps de traitement maximal par page lors de l'importation (en secondes) | Temps de traitement maximal, en secondes, qui doit être autorisé par page lors de l'importation de données à partir d'outils. | 300 | [sn_devops.import.max.processing.time.seconds.per_page] |
| Options de webhook prises en charge | Options de webhook prises en charge par Vélocité de changement DevOps. | code,plan,orchestration,artefact, test | [sn_devops.supported_webhook_capabilities] |
| État fermé de la demande de changement DevOps | État fermé de la demande de changement DevOps à utiliser pour les personnalisations de gestion des changements. | 3 | [sn_devops.change_request.closed_state] |
| Délai d'expiration du flux en bloc (en millisecondes) | Délai d'expiration du flux en bloc, en millisecondes. | 60 000 | [sn_devops.bulk_flow_timeout] |
| Validations d'outils de codage par page GitHub/Bitbucket | Nombre de validations d'outils de codage par page pour GitHub et Bitbucket. | 100 | [sn_devops.import.coding_tool.commits.per_page] |
| Profondeur du dossier |
Récupère uniquement les tâches et les pipelines d'orchestration qui se trouvent dans des dossiers dont le niveau d'imbrication est inférieur ou égal à la valeur spécifiée ici. La profondeur du dossier correspond au niveau d'imbrication spécifié sur les dossiers dans Jenkins, qui contient les tâches et les pipelines d'orchestration que vous souhaitez détecter. Par exemple, si vous souhaitez détecter des tâches et des pipelines d'orchestration pour une structure de dossiers imbriquée 2 fois dans votre environnement Jenkins, vous devez saisir 2 comme valeur pour cette propriété. |
3 | [sn_devops.discover.jenkins.folder.depth] |
| Flux secondaire du gestionnaire des demandes de changement DevOps | Si vous utilisez un flux secondaire personnalisé au lieu du flux secondaire Gestionnaire des changements par défaut dans le concepteur de flux (utilisé pour renseigner les champs de demande de changement avec les valeurs par défaut), vous devez mettre à jour cette valeur de propriété vers le nouveau flux secondaire. Vous pouvez copier le flux secondaire Gestionnaire des changements par défaut dans le concepteur de flux et le mettre à jour en fonction des besoins de votre organisation. Pour en savoir plus sur le flux secondaire Gestionnaire des changements par défaut, consultez Personnaliser des flux DevOps. Pour en savoir plus sur la copie d'un flux secondaire, consultez Copy a subflow. |
sn_devops.default_change_handler_subflow | [sn_devops.change_request_handler_subflow] |
| Référentiels des outils de codage par page |
Nombre de référentiels devant être affichés par page lorsque vous importez des référentiels après la connexion à un outil. Le nombre total de référentiels importés ne dépend pas de cette propriété, mais vous pouvez spécifier le nombre de référentiels à afficher par page en fonction du nombre total de référentiels importés à l'aide de cette propriété. Par exemple, si votre outil contient 1 000 référentiels et que vous spécifiez 100 comme valeur de propriété, 1 000 référentiels sont importés, dont 100 s'affichent par page sur la page Demandes d'importation. Lorsque vous détectez des référentiels, le nombre de référentiels devant être récupérés par appel d'API dans le back-end dépend également de cette valeur de propriété. Dans le cas d'un grand nombre de référentiels, définissez une valeur relativement plus faible dans cette propriété afin de récupérer un nombre inférieur de référentiels par appel et d'éviter l'expiration du système. |
100 | [sn_devops.import.coding_tool.repos.per_page] |
| URL d'API GitHub | URL d'API GitHub. | https://api.github.com | [sn_devops.github.api_url] |
| Limite d'importation max des problèmes liés à l'outil de planification ITBM Agile | Limite d'importation maximale des problèmes liés à l'outil de planification Gestion stratégique des portefeuilles (SPM) Agile. | 1 000 | [sn_devops.import.planning_tool.itbm.issues.max.limit] |
| Affecter une tâche universelle et notifier la mise à jour des informations d'identification de l'outil lorsqu'elles ont expiré |
Les administrateurs et les propriétaires d'outils sont informés (par le biais d'une tâche universelle, d'un e-mail, d'une bannière et d'un message de champ) de l'expiration des informations d'identification de l'outil une fois les informations d'identification expirées. En tant qu'administrateur ou propriétaire de l'outil, vous pouvez mettre à jour les informations d'identification de votre outil et connecter l'outil pour éviter toute perte supplémentaire de données. Pour en savoir plus sur la mise à jour des informations d'identification de l'outil, consultez Mettre à jour les informations d'identification d'outils tiers dans Vélocité de changement DevOps. |
Oui (activé) | [sn_devops.credential_expiration.notify_on_expiration] |
| Nombre de jours avant l'expiration des informations d'identification de l'outil pour affecter une tâche universelle et la notifier (le cas échéant) |
Définissez le nombre de jours avant l'expiration des informations d'identification de l'outil pour envoyer des notifications (via une tâche universelle, un e-mail, une bannière et un message de champ) aux administrateurs pour les outils GitHub créés avec l'authentification de base. Pour arrêter l'envoi de notifications proactives, sélectionnez 0 comme valeur pour cette propriété. Pour en savoir plus sur la mise à jour des informations d'identification de l'outil, consultez Mettre à jour les informations d'identification d'outils tiers dans Vélocité de changement DevOps. |
3 | [sn_devops.credential_expiration.notify_before_days] |
| Nombre de jours pour afficher les alertes d'avertissement lorsque des événements n'ont pas été reçus |
Définissez le nombre de jours pour afficher les alertes d'avertissement dans le champ Dernier événement reçu de l'enregistrement de l'outil lorsque des événements n'ont pas été reçus. Cela ne s'applique qu'aux outils qui envoient des données à ServiceNow. Le champ Dernier événement reçu dans l'en-tête de l'enregistrement de l'outil et à l'intérieur de l'enregistrement de l'outil est mis en surbrillance en jaune pour les alertes d'avertissement d'événements non reçus. |
2 | [sn_devops.last_event_received.warning] |
| Nombre de jours pour afficher les alertes critiques lorsque des événements n'ont pas été reçus |
Définissez le nombre de jours pour afficher les alertes critiques dans le champ Dernier événement reçu de l'enregistrement de l'outil lorsque des événements n'ont pas été reçus. Cela ne s'applique qu'aux outils qui envoient des données à ServiceNow. Le champ Dernier événement reçu dans l'en-tête de l'enregistrement de l'outil et à l'intérieur de l'enregistrement de l'outil est mis en surbrillance en rouge pour les alertes critiques d'événements non reçus. |
7 | [sn_devops.last_event_received.critical] |
| Déterminer les validations d'exécution Azure DevOps à partir de la dernière version réussie du pipeline |
Si cette option est activée, Changement DevOps choisit les dernières validations, jusqu'à un maximum de 2 000, créées après la dernière version réussie du pipeline à partir de Azure DevOps dans le cadre des validations d'exécution. Si cette option est désactivée, seules les 200 dernières validations sont prises en compte pour l'exécution des validations. |
Non | [sn_devops.enable_ado_bulk_run_commits] |
| Déterminer les validations d'exécution GitHub à partir de la dernière exécution réussie du workflow |
Si cette option est activée, Changement DevOps choisit les 2 000 premières validations après la dernière exécution réussie du workflow dans GitHub dans le cadre des validations d'exécution.
Remarque : Les validations ignorées ne sont pas prises en compte. Si cette option est désactivée, seule la dernière validation est choisie pour les validations d'exécution. |
Non | [sn_devops.enable_github_run_commits] |
| Cette propriété indique s'il est nécessaire de créer une connexion générique lors de l'opération de configuration pour Azure DevOps. | L'étape de saisie du nom d'utilisateur et du mot de passe d'intégration est requise pour configurer les webhooks lorsque cette propriété est activée. | Non | [sn_devops.enable_ado_generic_connection] |
| Limite maximale du nombre de pipelines pouvant être détectés pour un projet Azure DevOps | Définissez le nombre maximal de pipelines pouvant être détectés dans une demande d'importation pour un projet ADO. Si votre projet compte plus de 15 000 pipelines, vous pouvez essayer de définir cette valeur de propriété sur cette valeur et observer si les pipelines sont détectés. Si ce n'est pas le cas, vous pouvez réduire cette valeur et relancer la détection. | 15 000 | [sn_devops.discover.max.pipelines.ado] |
| Mettre à jour automatiquement les états des demandes de changement DevOps lorsque le reçu de changement est activé | Met à jour automatiquement les états des demandes de changement DevOps lorsque le reçu de changement est activé. Si vous souhaitez arrêter la transition automatique des états des demandes de changement, même lorsque la réception des changements est activée, vous devez désactiver cette propriété. | Sélectionné (activé) | [sn_devops.enable_change_receipt_state_transition] |
| Basculer vers cet utilisateur une fois l'authentification basée sur le jeton réussie | Si l'utilisateur devops.system n'est pas disponible dans votre instance ServiceNow, utilisez cette propriété pour définir tous les autres utilisateurs disposant du rôle sn_devops.integration nécessaire pour terminer l'authentification par jeton. | devops.system | [sn_devops.token_auth.user] |
| Limite maximale du nombre de tentatives d'action de détection dépassant la limite spécifiée. | Détermine le nombre maximal de fois où l'action de détection est automatiquement relancée une fois qu'elle a atteint la limite spécifiée. Par exemple, si l'intervalle dans Azure DevOps est de 5 minutes et que vous saisissez une valeur de 4 dans ce champ, l'action de détection est relancée à 4 reprises toutes les 5 minutes. | 10 | [sn_devops.max_retry_count_discover] |
| Activer la création de demandes de changement, même avec des erreurs dans la récupération de données DevOps |
Si cette option est activée, lorsqu'une erreur se produit lors de la récupération de données DevOps telles que les éléments de travail, les validations, les résumés de tests, les résumés de sécurité, etc., la demande de changement correspondante est quand même créée. Les données pouvant être récupérées sont toujours associées à la demande de changement. Si les données sont impossibles à récupérer, le motif de l'erreur est notifié à l'utilisateur dans la console tierce, et les mêmes informations sont ajoutées au champ Commentaires sur le changement dans l'enregistrement d'exécution de l'étape et dans les notes de travail du changement. |
Non (désactivé) | [sn_devops.enable_change_creation_with_partial_data] |
| Activer la transition d'état de Nouveau à Évaluer lorsque le flux d'approbation manuelle de demande de changement DevOps est actif | Si cette option est activée, elle met à jour l'état de la demande de changement de Nouveau à Évaluer directement lorsque le flux d'approbation manuelle de demande de changement DevOps est actif. Si vous souhaitez arrêter la transition automatique de l'état de la demande de changement à l'état Évaluer lorsque le flux d'approbation manuelle de demande de changement DevOps est actif, vous devez désactiver cette propriété. | Oui (activé) | [sn_devops.enable_change_request_state_transition] |
| Délai de rappel de demande de changement (en minutes) | Définissez la valeur du délai d'expiration, en minutes, jusqu'à ce que le système tente de traiter un changement lorsqu'un événement entrant passe à l'état En attente pendant une exécution de pipeline. Passé ce délai, le pipeline est abandonné. Le motif de l'erreur s'affiche dans les journaux de la console de votre outil tiers. Lorsqu'un pipeline est annulé en raison d'un délai d'expiration du rappel, les mêmes informations sont ajoutées à l'enregistrement de rappel de l'exécution de l'étape correspondante. | 120 minutes | [sn_devops.change_request_callback_timeout] |
| Branche Bitbucket par défaut utilisée pour la demande d'importation | Spécifiez le nom de branche Bitbucket par défaut devant être utilisé pour créer une demande d'importation. | maître | [sn_devops.bitbucket_default_branch] |
| Valeur du code de fermeture d'une demande de changement terminée avec succès lorsque le paramètre autoCloseChange est activé. | Entrez la valeur du code de fermeture d’une demande de changement effectuée avec succès lorsque le paramètre autoCloseChange est activé. | Réussi | [sn_devops.change_request.auto_close_successful_code] |
| Valeur du code de fermeture d'une demande de changement terminée avec des problèmes lorsque le paramètre autoCloseChange est activé. | Entrez la valeur du code de fermeture d’une demande de changement effectuée avec des problèmes lorsque le paramètre autoCloseChange est activé. | successful_issues | [sn_devops.change_request.auto_close_partial_successful_code] |
| Valeur du code de fermeture d'une demande de changement terminée sans succès lorsque le paramètre autoCloseChange est activé. | Entrez la valeur du code de fermeture d’une demande de changement qui n’a pas abouti lorsque le paramètre autoCloseChange est activé. | En échec | [sn_devops.change_request.auto_close_failure_code] |
| Collecte de preuves basées sur l'importation pour l'aptitude d'orchestration | Cette propriété modifie la manière dont les événements de pipeline sont traités. Lorsqu’il est activé, le paramètre réduit la surcharge d’instance en ignorant le traitement au niveau de l’étape dans le pipeline. Les événements au niveau de l’étape ignorés sont ignorés avec les détails de traitement « IGNORÉ : cet événement est ignoré, car la propriété « Collecte de preuves basées sur l’importation pour l’aptitude d’orchestration » est activée ». À l’inverse, la désactivation revient au mode standard, où tous les événements entrants sont traités. | False (désactivé) | [sn_devops.import_based_evidence_collection] |