Configuration d'un référentiel Git distant dans la Control Room

Configurez un référentiel Git distant dans la Control Room afin de pouvoir versionner tous les robots et leurs dépendances, et les stocker dans le référentiel Git. En plus du référentiel Automation 360 local dans la Control Room, le Git distant fournit une sauvegarde pour le les robots et leurs dépendances.

Prérequis

  • Afin de configurer un référentiel Git distant dans la Control Room, assurez-vous que le rôle AAE_Admin vous est attribué.
  • En fonction de votre région, configurez votre pare-feu réseau pour ajouter des adresses IP de passerelle NAT sortantes à la liste autorisée.

    Adresses IP Control Room pour les intégrations externes

Lorsque vous configurez un référentiel Git distant, tenez compte des points suivants :
  • Le référentiel Git doit être configuré de manière à disposer d'un accès en écriture uniquement sur la Control Room et non sur un autre client Git.
  • Vous ne pouvez pas charger des fichiers de plus de 100 Mo vers le référentiel Git.
  • Veillez à intégrer un référentiel Git vide.
  • Vous devez éviter d'archiver manuellement dans le référentiel Git un fichier provenant d'un autre utilisateur, d'un autre produit ou d'une autre application.
  • Lorsque vous intégrez Git, le référentiel ne doit pas contenir le fichier ReadMe.md.
  • Assurez-vous que votre référentiel Git est privé (interne). Pour des raisons de sécurité, Automation 360 ne peut pas se connecter à un référentiel public Git, car tous les robots et les fichiers sont généralement accessibles dans un référentiel public Git.

Procédure

  1. Dans la Control Room, accédez à Administration > Paramètres > Intégration du référentiel Git distant.
  2. Cliquez sur Modifier.
  3. Choisissez l'une des méthodes d'authentification suivantes et effectuez les étapes correspondantes pour mettre en place votre configuration Git :
    Méthode d’authentificationÉtapes
    Authentification HTTPS
    1. Saisissez le chemin du référentiel HTTPS, y compris le nom d'utilisateur au format suivant :

      https://<username>@bitbucket.org/companyname/product.git

      Remarque : Utilisez l'hôte Git pour lequel vous souhaitez obtenir l'adresse du référentiel Git.
    2. Saisissez le nom de la branche.

      Les modifications sont poussées vers la branche sélectionnée. Par défaut, la branche principale est sélectionnée.

      Vous pouvez utiliser des caractères minuscules pour les noms des branches, mais ils ne doivent pas dépasser 250 caractères. N'incluez pas de caractères de contrôle ASCII tels que des espaces, des tildes ou des deux-points dans les noms de branches. Vous pouvez utiliser le trait d'union pour séparer les mots. Pour plus d'informations sur la dénomination des branches, reportez-vous à la rubrique Create a new Git branch.

    3. Saisissez le mot de passe de votre référentiel Git ou un jeton Git généré.
      Remarque :
      • La longueur du jeton doit être limitée à 75 caractères.
      • Vous devez saisir le mot de passe généré pour votre connexion au référentiel. Il est recommandé d'utiliser des jetons, car ils sont plus sûrs que les mots de passe.
      • Pour GitHub, vous devez utiliser uniquement les jetons d'accès personnels (classiques). Les jetons d'accès personnels (ultra précis) ne fonctionnent pas dans GitHub.
      • Pour BitButcket, vous devez utiliser uniquement les mots de passe de l'application.
    4. Saisissez à nouveau le mot de passe ou le jeton Git pour confirmer.
    Authentification SSH
    1. Saisissez le chemin du référentiel SSH au format suivant :

      https://git@bitbucket.org:companyname/product.git

      Remarque : Utilisez l'hôte Git pour lequel vous souhaitez obtenir l'adresse du référentiel Git.
    2. Saisissez le nom de la branche.

      Les modifications sont poussées vers la branche sélectionnée. Par défaut, la branche principale est sélectionnée.

      Vous pouvez utiliser des caractères minuscules pour les noms des branches, mais ils ne doivent pas dépasser 250 caractères. N'incluez pas de caractères de contrôle ASCII tels que des espaces, des tildes ou des deux-points dans les noms de branches. Vous pouvez utiliser le trait d'union pour séparer les mots. Pour plus d'informations sur la dénomination des branches, reportez-vous à la rubrique Create a new Git branch.

    3. Saisissez votre clé privée d'authentification SSH.

      Vous devez créer la paire de clés privée et publique en utilisant l'algorithme RSA.

      Remarque : Assurez-vous que la clé privée saisie dans le champ Control Room contient la chaîne suivante : -----BEGIN RSA PRIVATE KEY----- AND -----END RSA PRIVATE KEY-----

      Vous devez générer la clé publique et la saisir dans votre serveur Git.

      Consultez les rubriques suivantes pour connaître les étapes à suivre pour générer la clé publique en fonction de votre serveur :
    4. Facultatif : Entrez la phrase secrète.
  4. Facultatif : Sélectionnez la case à cocher Se connecter à Git via un proxy.
    1. Saisissez l'adresse IP ou le nom d'hôte du proxy.
    2. entrez le numéro de port.
    3. Facultatif : Sélectionnez la case d'authentification et saisissez le nom d'utilisateur et le mot de passe.
  5. Cliquez sur Connecter et enregistrer.
    La Control Room se connecte au référentiel Git distant et le message suivant apparaît : Les paramètres d'intégration Git ont été enregistrés avec succès. Vous pouvez également vérifier dans le journal d'audit où le statut pour Définir les paramètres Git s'affiche comme étant réussi.
Remarque :
  • L'opération d'archivage peut prendre plus de temps si vous avez beaucoup de fichiers de robot dans votre dossier Git de l'espace de travail public. En effet, l'augmentation de la taille du référentiel entraîne un ralentissement des validations Git. Nous vous recommandons de supprimer de votre espace de travail public les fichiers de robot qui ne sont pas utilisés.
  • Si le référentiel Git contient des fichiers de verrouillage comme index.lock ou master.lock, supprimez ces fichiers de verrouillage, car ils peuvent entraver les opérations d'archivage et d'extraction.

Vous pouvez vous connecter au même référentiel Git avec un nom d'utilisateur différent dans Control Room. Pour plus d'informations, consultez How to change the remote Git repository username in the control room (A-People login required).

Regardez la vidéo suivante pour avoir un aperçu de Git :