Legacy - Intégration du contrôle de source

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • Permettez aux développeurs d’applications de s’intégrer à un référentiel de contrôle de source Git. Enregistrez et gérez plusieurs versions d’une application à partir d’une instance de non-production.

    Important :
    À partir de la Xanadu mise en production, la legacy version de est en cours de ServiceNow Studio préparation pour une éventuelle dépréciation. Ce module d'extension sera masqué et ne sera plus activé sur les nouvelles instances, mais continuera d'être pris en charge. Pour en savoir plus sur le processus de dépréciation, consultez l’article Processus de dépréciation [KB0867184] dans la base de connaissances Now Support.

    Essayez plutôt de créer et de modifier des applications dans la version actuelle de ServiceNow Studio Pour plus d'informations, consultez ServiceNow Studio.

    La liaison d’une application au contrôle de source permet à tous les développeurs d’applications sur une instance de non-production de :
    • Importez des applications à partir d’un référentiel Git.
    • Extrayez et appliquez des modifications distantes à partir d’un référentiel Git.
    • Validez tous les changements locaux sur l’instance dans un référentiel Git.
    • Créez des balises pour les lier en permanence à une version donnée d’une application.
    • Créez des branches pour gérer plusieurs versions d’une application simultanément.

    Exigences d’intégration

    Pour lier une application au contrôle de source :
    • L’utilisateur doit disposer du rôle d’administrateur.
    • L’instance de non-production doit disposer d’un accès réseau au référentiel Git.
    • Chaque application doit se trouver dans son propre référentiel Git.
    • Les informations d’identification de l’utilisateur du référentiel doivent accorder l’accès en lecture et en écriture.
    Remarque :
    Tous les développeurs d’application dans l’instance partagent un ensemble unique d’informations d’identification par référentiel.

    Options disponibles à partir du ServiceNow Studio

    Après avoir lié une application au contrôle de source, les développeurs d’applications peuvent l’utiliser ServiceNow Studio pour gérer le référentiel. À partir de , les Studiodéveloppeurs peuvent :
    • Modifiez les informations d’identification du référentiel d’applications.
    • Validez tous les changements locaux sur l’instance.
    • Appliquez les modifications distantes à partir du référentiel.
    • Créez une branche.
    • Changez de succursale.
    • Importez une application à partir d’un référentiel distant.

    Il n’est pas recommandé d’utiliser le contrôle de source pour gérer les applications sur une instance de production. Le déploiement en production peut avoir des conséquences imprévues, reportez-vous à la section Legacy - Conseils pour le déploiement de la production. Au lieu de cela, vous pouvez gérer les applications sur une instance de production à l’aide du référentiel d’applications, d’un ensemble de mises à jour ou du fichier ServiceNow Store. Pour plus d’informations sur la gestion des applications sur une instance de production, reportez-vous à la section Partage d’applications.

    Options disponibles à partir d’un référentiel Git

    La ServiceNow plateforme offre une prise en charge limitée de la modification des fichiers d’application liés en dehors d’une instance. Depuis Git, les développeurs peuvent :
    • Déplacez les fichiers d’application vers une autre structure de répertoire Git.
    • Modifiez les fichiers d’application en dehors de ServiceNow Studio.

    Le système génère un fichier texte de propriétés appelé sn_source_control.properties au niveau racine du référentiel. Pour déplacer les fichiers d’application vers une structure de répertoire Git différente, les développeurs d’applications peuvent définir le path paramètre pour spécifier le chemin du sous-dossier contenant leurs fichiers d’application. Par exemple, si vous avez déplacé votre application vers le sous-dossier src/app , définissez le pathsur path=src/app.

    Le système génère un fichier checksum.txt dans le référentiel Git pour déterminer si des fichiers d’application ont été modifiés en dehors de Studio. Lorsque la valeur de la somme de contrôle du fichier correspond à la valeur de somme de contrôle actuelle, l’intégration ignore le processus de validation et de nettoyage. Lorsque les valeurs des sommes de contrôle ne correspondent pas, l’intégration valide et nettoie les fichiers d’application dans le cadre de l’opération de contrôle de source. Le processus de désinfection :
    • Crée des entrées de journal de mise à niveau pour chaque action de nettoyage effectuée.
    • Supprime les dossiers et fichiers non pris en charge du référentiel.
    • Abandonne toutes les opérations de contrôle de source lorsqu’un fichier d’application système échoue à la validation du schéma XML. Par exemple, si un enregistrement de dictionnaire de base de données échoue à la validation du schéma XML, le système abandonne toutes les opérations.
    • Ignore l’opération de contrôle de source actuelle lorsqu’un fichier d’application non-système échoue à la validation du schéma XML.

    L’intégration du contrôle de source nettoie uniquement le contenu figurant dans le chemin d’accès de l’application répertorié dans le fichier sn_source_control.properties . Le contenu du référentiel en dehors du chemin d’accès de l’application est ignoré.

    Support du serveur MID

    Utilisez un serveur MID existant pour vous connecter à un référentiel de contrôle de source. La liaison ou l’importation d’une application via un serveur MID permet d’accéder aux référentiels derrière un pare-feu.

    Configurer le serveur MID pour l’intégration du contrôle de source

    Configurez un serveur MID pour l’intégration du contrôle de source afin d’activer la communication et le mouvement de données entre une instance et des ServiceNow applications, sources de données et services externes.

    • Ajoutez l’extension « bundle » aux propriétés glide.attachment.extensions .
    • Si les serveurs MID doivent passer par un proxy pour accéder au référentiel git distant, procédez comme suit :
      • Ajoutez la ligne suivante au fichier agent\conf\wrapper-override.conf :
      • wrapper.java.additionial.3=-Dhttps.proxyHost=<proxyHost>
      • wrapper.java.additionial.4=-Dhttps.proxyPort=<proxyPort>
      • Redémarrer le MID
      • Ajouter une nouvelle entrée dans « Politique de sécurité MID » :
      • Nom : <nom d’hôte proxy>
      • Cocher « Actif » uniquement

    Débruiter les validations de contrôle de source

    Ignorer le déchargement dans les fichiers XML des champs de mise à jour bruyants pour tout enregistrement de métadonnées dans le contrôle de source.