Sourcetree

https://www.sourcetreeapp.com

Sourcetree est un outil graphique permettant de gérer des dépôts git. Il fonctionne avec le protocole https ou ssh.

Il est possible de connecter Sourcetree directement à IRD Forge pour pouvoir gérer, directement depuis Sourcetree, tous les dépôts hébergés sur IRD Forge.

Génération d'un Personnal access token (PAT)

Un PAT est un mot de passe associé à votre nom d'utilisateur, il donne accès à nombre restreint d'actions. Un utilisateur peut avoir plusieurs PAT.

Pour plus de sécurité : un PAT par application

Une bonne pratique de sécurité consiste à utiliser plusieurs PAT, un par application nécessitant un PAT, avec uniquement les droits nécessaires. Il est également possible d'ajouter une date d'expiration à un PAT.

1. Pour générer un PAT, se rendre sur https://forge.ird.fr/-/profile/personal_access_tokens
2. Donner un nom à votre token (ex : "Sourcetree-nomordinateur")
3. Par défaut, une date d'expiration est définie. Le token sera valide 30 jours
4. Sélectionner les scopes suivant :
   • api
   • read_user
   • write_repository
5. Valider en cliquant sur le bouton Create personnal access token. Le PAT s'affiche en haut de la page. Le PAT ne s'affiche qu'une fois

Configurer Sourcetree

1. Ouvrir les préférences, puis sélectionner l'onglet "Comptes". Cliquer sur "Ajouter"
2. Renseigner le formulaire :
   • Hôte : Gitlab CE
   • URL : https://forge.ird.fr
   • Nom d'utilisateur : votre adresse mail, en remplaçant le @ par _
   • Mot de passe : le PAT généré à l'étape précedente
   • Protocole : HTTPS

Dans l'onglet "Distant" de Sourcetree, vous pouvez maintenant voir la liste de vos dépôts sur IRD Forge et les cloner sur votre poste local.