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

La liaison d’une application ou d’une personnalisation d’application au contrôle de code source permet aux développeurs d’applications de gérer les modifications apportées à (AES) à Studio du moteur de développement d'application partir d’un référentiel Git.

Avant de commencer

• En savoir plus sur Gérer les personnalisations des applications.
• Créez un référentiel Git dédié pour l’application. Pour une sécurité accrue, 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’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 à leurs enregistrements respectifs de la Table des utilisateurs (ServiceNow sys_user) qu’ils utilisent dans leurs validations vers le 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 les applications sur une instance de production à partir du référentiel d’applications, d’un ensemble de mises à jour ou du Studio du moteur de développement d'application.

Procédure

1. Accédez à la Tous > Moteur de développement d'application > Studio du moteur de développement d'application.
2. Sur la page Mes applications, ouvrez votre application.
3. Sélectionner Contrôle de source > Lien vers le contrôle de source.
   Studio du moteur de développement d'application affiche la boîte de dialogue Lien vers le contrôle de source.

   

4. Saisissez les détails de connexion du référentiel Git.

   Tableau 1. Détails de la connexion au contrôle de source

   Champ	Description
   Protocole réseau	Type d’informations d’identification https ou SSH qui active l’échange de données du canal sécurisé.
   URL	URL du référentiel Git dans lequel vous souhaitez enregistrer les fichiers d’application. Pour le protocole SSH, utilisez la commande pour générer une 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 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.
   Brancher	Branche du référentiel sur laquelle travailler dans 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 dépôt git distant, l’instance crée une nouvelle branche par défaut avec le nom « main ». Ceci est configuré à l’aide de la propriété système glide.source_control.git_default_branch .
   Nom de Serveur MID	Le nom du MID Server existant à lier. Remarque : Utilisez un MID Server distinct pour éviter les conflits avec Détection les activités. Assurez-vous que l’utilisateur du MID Server peut créer des fichiers pour la table sys_attachment et que la table peut accepter des fichiers du type « bundle ». La liaison d’une application via un MID Server 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 sys_user si 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 ([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é. Consultez Getting started with credentials 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 d’informations d’identification d’authentification de base.
   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.
5. Sélectionnez Lier au contrôle de source.
   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 sur l’instance peuvent utiliser le référentiel Git lié pour gérer les modifications.

Information associée

• Serveur MID
• Introduction aux informations d'identification