Configuration de git avant utilisation #

Obligatoire : configurer votre nom et e-mail #

Le nom et e-mail que vous configurez ici sera utilisé comme l’auteur des commits dans le journal de chaque dépôt.

git config --global user.name "Albert Dupont"
git config --global user.email "aremplacer@gitlab.bordeaux-inp.fr"

Il est conseillé d’anonymiser votre adresse e-mail de façon à ne pas la rendre publique en ligne (elle serait collectée par des robots spammeurs). L’anonymisation s’active à cet endroit https://gitlab.bordeaux-inp.fr/-/profile en sélectionnant “Use a private e-mail”. GitLab anonymisera automatiquement votre adresse.

Vous pouvez au choix faire cette configuration :

• soit pour tous les dépôts sur votre ordinateur : avec l’option --global
• soit individuellement pour chaque dépôt. Plus pratique si vous utilisez git sur plusieurs serveurs (gitlab.com, framagit.org, github.com, …) : retirez --global tout en étant dans le bon dossier du dépôt à configurer

Facultatif : Configuration Linux pour utiliser GitLab avec SSH #

Utiliser SSH au lieu d’HTTPS pour se connecter au serveur a pour principal avantage de ne pas nécessiter de taper son mot de passe à chaque pull ou push en associant directement votre ordinateur à votre compte GitLab.

L’usage de SSH nécessite un compte Bordeaux INP, un compte sur le GitLab ne suffit pas.

Cette configuration est à réaliser sur tous les ordinateurs à partir desquels vous souhaitez.

1. Créer un fichier de configuration en remplaçant aremplacer001 par votre nom d’utilisateur :

tee -a ~/.ssh/config <<EOF
Host ssh.bordeaux-inp.fr
  User aremplacer001
  Hostname ssh.bordeaux-inp.fr

Host gitlab.bordeaux-inp.fr
  Hostname gitlab.bordeaux-inp.fr
  ProxyJump ssh.bordeaux-inp.fr
EOF

2. Clonez un dépôt pour tester la procédure : git clone git@gitlab.bordeaux-inp.fr:dev/doc ~/documentation-gitlab-bordeaux-inp

3. Un message Are you sure you want to continue connecting (yes/no/[fingerprint])? s’affiche. Son intérêt est de vous permettre de vérifier l’identité du serveur auquel vous vous connectez. Il y a peu de chances que cette identité soit incorrecte, vous pouvez taper yes et valider.

4. Votre mot de passe Bordeaux INP vous est demandé une première fois (il ne s’agit pas de votre mot de passe GitLab).

5. Le clonage se termine avec succès dans le dossier documentation-gitlab-bordeaux-inp

6. Créez une clé SSH pour cet ordinateur (sauf si vous en avez déjà une dans le fichier ~/.ssh/id_rsa.pub) avec la commande ssh-keygen (appuyez directement sur Entrée à haque question pour utiliser les réponses par défaut). La commande se termine par l’affichage d’une image aléatoire.

7. Autorisez la connexion de votre ordinateur sans mot de passe avec ces 2 commandes qui nécessitent de taper votre mdp :

ssh ssh.bordeaux-inp.fr mkdir -p .ssh
cat ~/.ssh/id_rsa.pub | ssh ssh.bordeaux-inp.fr -T "cat >> ~/.ssh/authorized_keys"

8. Déclarez votre clé SSH à GitLab en copiant/collant la ligne retournée par cat .ssh/id_rsa.pub dans https://gitlab.bordeaux-inp.fr/-/profile/keys

9. C’est terminé. Votre prochain pull ou push depuis cet ordinateur ne vous demandera plus de mot de passe pour tous les dépôts que vous clonerez avec la méthode SSH (c’est à dire avec git clone git@gitlab.bordeaux-inp.fr[...]).

Selon les procédures que vous pourriez avoir déjà réalisées dans le passé, certaines étapes peuvent être inutiles.