Lier une application au contrôle de source dans ServiceNow Studio

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 changements à partir d’un ServiceNow Studio référentiel Git.

Avant de commencer

• En savoir plus sur Gérer les personnalisations apportées aux applications.
• 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 de contrôle de source peut utiliser à la place d’un mot de passe et d’une clé d’accès d’authentification multifacteur lors de la création d’un enregistrement d’informations d’identification. 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.
• Assurez-vous que les utilisateurs ajoutent l’adresse e-mail aux enregistrements de la table Utilisateurs [sys_user] respectifs qu’ils utilisent dans leurs validations au référentiel Git.
• Rôle requis : admin

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 ServiceNow Studio.

Procédure

1. Accédez à la Tous > App Engine > ServiceNow Studio.
2. Dans le navigateur de fichiers, sélectionnez l’application que vous souhaitez ouvrir.
3. Sélectionnez Détails de l’application pour ouvrir l’application dans le canevas.
4. Sélectionner Contrôle de source > Lien vers le contrôle de source.

   

5. Saisissez les détails de connexion pour le référentiel Git.

   Tableau 1. Détails de la connexion du 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 du référentiel Git pour SSH fournie par votre serveur Git ne fonctionne pas, vérifiez auprès de votre propriétaire ou fournisseur de serveur Git 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 l’URL de votre référentiel Git fonctionne.
   Brancher	La branche de référentiel sur laquelle travailler au sein de l’application. Remarque : Cette branche est utilisée pour les commits. La branche par défaut est définie sur « main » si elle n’est pas déjà définie dans le référentiel distant. S’il n’y a pas de branche par défaut sur le référentiel git distant, l’instance crée une branche par défaut avec le nom « main ». Cette configuration est effectuée à l’aide de la propriété système glide.source_control.git_default_branch .
   Serveur MID Name (Nom)	Nom de l’existant Serveur MID à relier. Remarque : Utilisez une séparation Serveur MID pour éviter les conflits d’activités Découverte . Assurez-vous que l’utilisateur Serveur MID peut créer des fichiers pour la table [sys_attachment] et que la table peut accepter les fichiers de type « lot ». La liaison d’une application via un Serveur MID permet d’accéder aux référentiels derrière un pare-feu. Consultez MID Server pour plus d'informations.
   E-mail par défaut	L’adresse e-mail du validateur est définie par l’enregistrement de sys_user s’il est disponible. Mais si le champ d’e-mail d’enregistrement de sys_user d’un validateur est vide, un ServiceNow AI Platform autre e-mail est généré ([e-mail]). Vous pouvez également saisir 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.
   Informations d'identification	Informations d’identification à utiliser avec le protocole sélectionné. Pour en savoir plus sur la création d’informations d’identification, reportez-vous à la section Get started with credentials . 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 d’informations d’identification Authentification de base.
   Commentaire de validation	Description facultative du référentiel ou de l’application.

   Remarque :

   Tous les développeurs d’application dans l’instance partagent un ensemble unique d’informations d’identification de référentiel.
6. Sélectionnez Lien vers le contrôle de source.
   Valide ServiceNow AI Platform la connexion et les informations d’identification de l’utilisateur et affiche un message de réussite.

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

Information associée

• Serveur MID
• Introduction aux informations d'identification