Actions personnalisées ServiceNow DevOps de la place de marché GitHub
Utilisez les actions personnalisées de la place de marché GitHub pour collecter les données d'analyse SonarQube, collecter des données de sécurité, mettre en pause ou reprendre un workflow, reprendre un workflow jusqu'à ce qu'une demande de changement soit approuvée ou rejetée dans votre instance, obtenir et mettre à jour les détails de la demande de changement, etc.
Vous pouvez également utiliser des images de conteneurs Docker pour implémenter des actions personnalisées pour les pipelines GitHub Actions. Pour plus d'informations, consultez Implémenter des actions personnalisées pour les pipelines utilisant une image de conteneur Docker générique.
Action personnalisée SonarQube ServiceNow DevOps
Enregistrez les résultats de l'analyse SonarQube d'un projet initié par le workflow exécuté dans votre instance ServiceNow. Vous devez créer l'outil SonarQube dans votre instance et utiliser l'action personnalisée SonarQube ServiceNow DevOps au niveau des étapes d'une tâche dans le workflow.
- Accédez à la .
- Accédez à la et en sélectionnant un enregistrement d’exécution de tâche pertinent.
- Créez l'outil SonarQube dans votre instance.
Générer un jeton à partir de dans votre outil SonarQube et créez un outil dans l’instance à l’aide ServiceNow du jeton généré. Pour plus d'informations, consultez Intégrer SonarQube à Vélocité de changement DevOps - Espace de travail et Intégrer SonarQube à Vélocité de changement DevOps - Classique.
- Créez les clés secrètes suivantes pour enregistrer les résultats de l'analyse SonarQube dans l'instance ServiceNow.
- SONAR_HOST_URL : URL de l'instance SonarQube. Par exemple, https://sonarcloud.io
- SONAR_PROJECT_KEY : clé d'identification d'un projet dans l'instance SonarQube. Par exemple, org.examples:demo
- Configurez l'action personnalisée SonarQube ServiceNow DevOps dans le workflow.
Vous devez configurer l'action personnalisée
servicenow-devops-sonarau niveau des étapes de la tâche dans le workflow avec le mot clé uses. Veillez à ne pas altérer les entrées de cette action personnalisée pour enregistrer les résultats de l'analyse SonarQube dans l'instance ServiceNow. Pour plus d'informations, consultez Sonar ServiceNow DevOps.
Action personnalisée Rapport de test ServiceNow DevOps
Enregistrez les résultats des tests unitaires du projet initié par le workflow exécuté dans votre instance ServiceNow. Vous devez utiliser l'action personnalisée Rapport de test ServiceNow DevOps au niveau des étapes de la tâche dans le workflow.
Affichez les résultats des tests unitaires enregistrés dans votre ServiceNow instance en accédant à .
Vous pouvez également l’afficher en accédant à et cliquer sur un enregistrement d’exécution de tâche pertinent.
- Créez des clés secrètes dans le référentiel GitHub.
- Configurez l'action personnalisée Rapport de test DevOps dans le workflow.
Vous devez configurer l'action personnalisée
servicenow-devops-test-reportau niveau des étapes de la tâche dans le workflow avec le mot clé uses. Veillez à ne pas altérer les entrées de cette action personnalisée pour enregistrer les résultats des tests unitaires dans votre instance ServiceNow. Pour plus d'informations, consultez Rapport de test ServiceNow DevOps.
Action personnalisée Enregistrer l'artefact ServiceNow DevOps
Enregistrez les artefacts créés ou déployés par le workflow exécuté dans votre instance ServiceNow. Utilisez l'action personnalisée Enregistrer l'artefact ServiceNow DevOps au niveau des étapes de la tâche dans le workflow.
Affichez les détails des artefacts enregistrés dans votre instance en accédant à .
- Créez des clés secrètes dans le référentiel GitHub.
- Configurez l'action personnalisée Enregistrer l'artefact ServiceNow DevOps dans le workflow.
Vous devez configurer l'action personnalisée
servicenow-devops-register-artifactau niveau des étapes de la tâche dans le workflow avec le mot clé uses. Veillez à ne pas altérer les entrées de cette action personnalisée pour enregistrer les détails de l'artefact dans votre instance. Pour plus d'informations, consultez Enregistrer les artefacts ServiceNow DevOps.
Action personnalisée Enregistrer le package ServiceNow DevOps
Enregistrez les packages créés ou déployés par le workflow exécuté dans l'instance ServiceNow. Utilisez l'action personnalisée Enregistrer le package ServiceNow DevOps au niveau des étapes de la tâche dans le workflow.
Affichez les détails du package enregistrés dans l’instance ServiceNow en accédant à .
- Créez des clés secrètes dans le référentiel GitHub.
- Configurez l'action personnalisée Enregistrer l'artefact ServiceNow DevOps dans le workflow.
Vous devez configurer l'action personnalisée
servicenow-devops-register-packageau niveau des étapes de la tâche dans le workflow avec le mot clé uses. Veillez à ne pas altérer les entrées de cette action personnalisée pour enregistrer les détails de l'artefact dans votre instance. Pour plus d'informations, consultez Enregistrer le package ServiceNow DevOps.
Action personnalisée d’automatisation des changements ServiceNow DevOps
Créez une demande de changement dans l'instance ServiceNow pour mettre en pause et reprendre l'exécution du workflow à partir de l'instance ServiceNow.
Utilisez l'action personnalisée Automatisation des changements ServiceNow DevOps au niveau des étapes de la tâche dans le workflow. Si le changement n'est pas créé dans le délai spécifié dans le seuil (changeCreationTimeOut) et que le paramètre abortOnChangeCreationFailure est activé, le pipeline est abandonné.
Cette action personnalisée crée une demande de changement dans ServiceNow, active l'option Contrôle du changement et interroge l'instance ServiceNow à l'intervalle défini pour connaître l'état du changement jusqu'à ce que le changement soit approuvé ou rejeté, ou que le seuil de délai d'expiration soit atteint. GitHub abandonne l'exécution du workflow si le seuil de délai est atteint et que le paramètre abortOnChangeStepTimeout est activé.
Cette action personnalisée reprend immédiatement l'exécution du workflow lorsque le reçu du changement est activé pour le pipeline dans ServiceNow sans attendre que le changement soit approuvé ou rejeté dans l'instance ServiceNow.
Affichez le changement créé pour le workflow exécuté dans l’instance ServiceNow en accédant à .
Le numéro de changement avec l'état pending_decision s'affiche dans la console Actions GitHub lors de l'interrogation de l'instance ServiceNow pour connaître l'état du changement. Diverses informations, telles que les commentaires sur le changement, la personne à l'origine de l'approbation, la date d'approbation et l'état, sont enregistrées dans la console Actions GitHub une fois le changement approuvé, rejeté ou annulé par l'utilisateur dans l'instance ServiceNow.
Vous pouvez accéder aux journaux de la console dans votre pipeline pour afficher l'état d'une demande de changement ; lors de la création d'une demande de changement, les détails du changement s'affichent selon l'intervalle d'interrogation. Les conditions de politique associées à l'état de la demande de changement sont également évaluées et consignées dans les journaux. Par exemple, si la politique Automatisation avancée de la demande de changement DevOps est activée, les conditions de politique sont évaluées et la décision correspondante (approbation automatique/rejet automatique/approbation manuelle) est consignée dans les journaux.
- Numéro
- Détails
- état
- sys_id
- type
- risk
- Priorité
- changeState
- plannedStartDate
- plannedEndDate
- changeRequestURL
- Politique Changement de modèle DevOps : seuls les journaux s'affichent lors de la création du changement et lors de la mise à jour de l'état du changement.
- Politique Automatisation minimale de demande de changement DevOps : les journaux ainsi que la décision de changement et les conditions de politique correspondant à la décision de changement s'affichent.
- Politique Automatisation avancée de demande de changement DevOps : les journaux ainsi que la décision de changement et les conditions de politique correspondant à la décision de changement s'affichent.
- Champs
- code_coverage
- commits_without_work_item
- integration_tests_failed
- load_tests_failed
- regression_tests_failed
- num_of_outages_in_last_7_days
- num_of_current_outages
- num_of_open_incidents
- total_num_of_commits
- tests_passing_percent
- risk
- code_security
- validations
- Opérateurs
- <=
- >=
- !=
- =
- <
- >
- ISNOTEMPTY
- ISEMPTY
- ENTRE
- ANYTHING
- NSAMEAS
- SAMEAS
- GT_FIELD
- LT_FIELD
- Créez des clés secrètes dans le référentiel GitHub.
- Configurez l'action personnalisée Automatisation des changements ServiceNow DevOps dans le workflow.
L'action personnalisée
servicenow-devops-changedoit être configurée au niveau des étapes de la tâche dans le workflow avec le mot clé uses. Les entrées de cette action personnalisée ne doivent pas être altérées pour créer un changement dans votre instance et interroger l'état du changement toutes les secondes. Pour plus d'informations, consultez Automatisation des changements ServiceNow DevOps.
Action GitHub - Obtenir un changement ServiceNow DevOps
Récupérez le numéro de la demande de changement dans un pipeline Actions GitHub en fonction des détails d'un changement spécifique.
L'action personnalisée Action GitHub - Obtenir un changement ServiceNow DevOps doit être ajoutée au niveau de l'étape d'une tâche de pipeline pour récupérer le numéro de la demande de changement à partir d'une instance ServiceNow en spécifiant les détails du changement.
Action GitHub - Mettre à jour le changement ServiceNow DevOps
Mettez à jour les détails de la demande de changement associés à un pipeline Actions GitHub.
Vous devez ajouter l'action personnalisée Action Github - Mettre à jour le changement ServiceNow DevOps au niveau des étapes dans une tâche de pipeline pour mettre à jour la demande de changement dans une instance ServiceNow. Le numéro de la demande de changement dont les détails doivent être mis à jour ainsi que les détails de la demande de changement à mettre à jour doivent être spécifiés comme entrée.
Action Résultats de sécurité ServiceNow DevOps
Récupérez les résultats de l'analyse de sécurité dans ServiceNow.
Vous devez ajouter l'action personnalisée Action Résultats de sécurité ServiceNow DevOps au niveau de l'étape dans une tâche de pipeline pour récupérer les résultats de l'analyse de sécurité dans ServiceNow.