Lier une application ou une personnalisation d’application au contrôle de source

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • La liaison d’une application ou d’une personnalisation d’application au contrôle de source permet aux développeurs d’applications de gérer les modifications à partir d’un référentiel Git.

    Avant de commencer

    • Rôle requis : administrateur
    • En savoir plus sur la gestion des personnalisations d’application.
    • Créez un référentiel Git dédié pour l’application. Pour plus de sécurité, activez l’authentification multifacteur pour le référentiel Git.
    • Générez un jeton d’accès que l’intégration du contrôle de source peut utiliser à la place d’un mot de passe et d’une clé d’accès à l’authentification multifacteur. Recherchez un jeton d’accès personnel sur GitHub ou GitLab.
    • Limitez les autorisations sur le jeton d’accès pour autoriser l’accès en lecture et en écriture au référentiel Git.
    • Vérifiez que l’instance de non-production dispose d’un accès réseau au référentiel Git.
    • Veillez à ce que les utilisateurs ajoutent l’adresse e-mail aux enregistrements de leur table d’utilisateurs respective (ServiceNow sys_user) qu’ils utilisent dans leurs validations vers le référentiel Git.
    • Pour en savoir plus : Migrer l’historique des ensembles de mises à jour terminés vers le contrôle de source

    Pourquoi et quand exécuter cette tâche

    L’intégration du contrôle de source ne prend pas en charge la liaison à une application ou la personnalisation sur une instance de production. Au lieu de cela, installez des applications sur une instance de production à partir du référentiel d’applications, d’un ensemble de mises à jour ou du ServiceNow Storefichier .

    Procédure

    1. Ouvrez l’application que vous souhaitez lier au contrôle de source dans Studio.
    2. Accédez à la Contrôle de source > Lien vers le contrôle de source.
      Studio Affiche la boîte de dialogue Lien vers le contrôle de source.Boîte de dialogue Lien vers le contrôle de source
    3. Entrez les détails de connexion au référentiel Git.
      Tableau 1. Détails de connexion au contrôle de source
      Champ Description
      Protocole réseau Type d’informations d’identification HTTPS ou SSH qui permet l’échange de données par canal sécurisé.
      URL L’URL vers le référentiel Git dans lequel vous souhaitez enregistrer les fichiers d’application. Pour le protocole SSH, utilisez la commande pour générer la clé privée ssh-keygen -t rsa -m PEM -b 4096 -C « email@address ».
      Remarque :
      Si l’URL Git Repo pour SSH fournie par votre serveur Git ne fonctionne pas, vérifiez auprès du propriétaire ou du fournisseur de votre serveur Git pour obtenir l’URL correcte. Des spécifications supplémentaires telles que des préfixes de protocole de schéma, des numéros de port, etc., peuvent être requises pour que votre URL de référentiel Git fonctionne.
      Informations d'identification Informations d’identification à utiliser avec le protocole sélectionné. Consultez Premiers pas avec les informations d’identification pour en savoir plus sur la création d’informations d’identification.
      Remarque :
      Si vous sélectionnez le protocole réseau SSH, entrez des informations d’identification valides du type de clé privée SSH. Si vous sélectionnez le protocole https, entrez des informations d’identification valides du type Informations d’identification pour l’authentification de base.
      Brancher Branche du référentiel sur laquelle travailler dans l’application.
      Nom du serveur MID Le nom du Serveur MID existant à traverser.
      Remarque :
      Utilisez un Serveur MID distinct pour éviter les conflits avec Découverte les activités.

      Assurez-vous que l’utilisateur du MID Server peut créer des fichiers dans la table sys_attachment et que la table peut accepter des fichiers de type « bundle ».

      La liaison ou l’importation d’une application via un MID Server permet d’accéder aux référentiels derrière un pare-feu. Consultez les rubriques Utilisation d’un serveur MID avec le contrôle de source et Serveur MID pour en savoir plus
      E-mail par défaut L’adresse e-mail du validateur est définie par l’enregistrement sys_user s’il est disponible. Cependant, si le champ d’e-mail d’enregistrement de sys_user d’un validateur est vide, le système génère un autre e-mail (username@instancename.service-now.com). Vous pouvez également entrer une adresse e-mail par défaut et la modifier ultérieurement. Pour utiliser cette adresse e-mail par défaut dans tous les cas, cochez la case.
      Commentaire de validation Description facultative du référentiel ou de l’application.
      Remarque :
      Tous les développeurs d’application de l’instance partagent un ensemble unique d’informations d’identification de référentiel.
    4. Cliquez sur Envoyer.
      Le système valide la connexion et les informations d’identification de l’utilisateur et affiche un message de réussite.

      Tous les développeurs d’applications de l’instance peuvent utiliser le référentiel Git lié pour gérer les changements.