Aller au contenu

Configuration de votre Environnement Git et GitHub

Ce guide vous accompagnera dans la configuration de votre environnement Git et GitHub, outils essentiels pour la gestion de code et la collaboration. Nous aborderons l'installation de Git, sa configuration et les méthodes de connexion à GitHub. Suivez ce guide pas à pas pour configurer votre environnement de développement.

1. Installation de Git

  1. Téléchargez le dernier installateur Git pour Windows.
  2. Lorsque vous avez démarré le programme d'installation avec succès, vous devriez voir l'écran de l'assistant de configuration de Git. Suivez les instructions en cliquant sur 'Suivant' et 'Terminer' pour compléter l'installation. Les options par défaut sont assez sensibles pour la plupart des utilisateurs.

  3. Ouvrez une invite de commande (ou Git Bash si, lors de l'installation, vous avez choisi de ne pas utiliser Git à partir de l'invite de commande Windows) pour vérifier que l'installation a réussi.

    1
    git --version

    1
    git version 2.48.1

Les packages Git sont disponibles via apt :

  1. Depuis votre shell, installez Git en utilisant apt-get :

    1
2
    sudo apt-get update
sudo apt-get install git

  2. Vérifiez que l'installation a réussi en tapant git --version :

    1
2
    git --version
git version 2.38.0

Contrôle de version avec Git

Le contrôle de version est essentiel pour tout développeur. Vous pouvez gérer vos projets avec Git en utilisant:

N'hésitez pas à explorer ces outils et à choisir ceux qui correspondent le mieux à votre façon de travailler.

2. Configuration de Git

Exécutez les commandes suivantes pour configurer votre nom d'utilisateur et votre adresse e-mail Git à l'aide des commandes suivantes :

1
git config --global user.name "votre_nom_prenom" # (1)!
  1. Nom et prénom: Veuillez remplacer votre_nom_prenom par votre nom et prénom.
1
git config --global user.email "votre_email" # (1)!
  1. Adresse e-mail: Remplacez votre_email par l'adresse e-mail que vous utilisez avec GitHub (personnelle ou institutionnelle).

Ces détails seront associés à tous les commits que vous créez. Cela permettra à Git de savoir qui a effectué les modifications dans un dépôt donné.

Adresse e-mail visible sur GitHub

Votre adresse e-mail sera visible publiquement dans vos contributions sur GitHub. Si vous préférez ne pas afficher votre adresse e-mail personnelle, vous pouvez utiliser une adresse e-mail institutionnelle ou créer une adresse e-mail spécifiquement pour vos contributions publiques.

3. Se connecter à GitHub

Création d'un compte GitHub

Si vous n'en avez pas déjà un, créez un compte GitHub en suivant ce lien : https://github.com/join

vous n'avez pas besoin de créer un nouveau compte GitHub. Il vous suffit d'ajouter l'adresse e-mail de votre institut à votre compte personnel. Vous pouvez le faire en vous rendant dans la section Settings de votre compte GitHub et en ajoutant l'adresse e-mail de votre institut dans le champ Emails.

SSH est comme un code secret qui permet à votre ordinateur de communiquer en sécurité avec des serveurs distants, comme GitHub. Au lieu de taper votre nom d'utilisateur et votre mot de passe à chaque fois, vous utilisez une "clé SSH" pour vous identifier. C'est plus pratique et plus sûr !

Comment ça marche ?

  1. Vous créez une paire de clés : une clé privée (gardée secrète sur votre ordinateur) et une clé publique (que vous partagez avec GitHub).
  2. Vous ajoutez votre clé publique à votre compte GitHub.
  3. Quand vous vous connectez à GitHub avec SSH, votre ordinateur utilise votre clé privée pour prouver votre identité. C'est tout ! Plus besoin de vous souvenir de votre mot de passe à chaque fois.

Pour résumer

  • SSH = sécurité et facilité pour se connecter à GitHub.
  • Clé SSH = votre identifiant secret pour GitHub.

Avant de commencer à utiliser SSH, vous devrez créer votre clé SSH et l'ajouter à votre compte GitHub. Nous verrons comment faire ça dans les prochaines étapes.

1. Générer une nouvelle clé SSH

Pour activer l'authentification pour les opérations Git via SSH, vous devez générer une nouvelle clé SSH sur votre ordinateur local et l'ajouter à votre compte sur GitHub.

  1. Ouvrez le terminal.

    Ouvrez Git Bash

    Ctrl+T pour ouvrir un terminal sous Ubuntu.

  2. Collez le texte ci-dessous, en le remplaçant par votre adresse e-mail GitHub.

    1
    ssh-keygen -t ed25519 -C "your_email@example.com"

    Compatibilité SSH : Générer une clé RSA pour les systèmes anciens

    Si vous utilisez un ancien système qui ne prend pas en charge l'algorithme Ed25519, utilisez :

    1
    $ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

    Cela crée une nouvelle clé SSH, en utilisant l'e-mail fourni comme étiquette.

    1
    > Generating public/private ALGORITHM key pair.

  3. Lorsque vous êtes invité à Enter a file in which to save the key, appuyez sur Enter. Ceci accepte l'emplacement de fichier par défaut.

    1
    > Enter a file in which to save the key (/home/YOU/.ssh/ALGORITHM):[Press enter]

  4. À l'invite, saisissez une phrase de passe sécurisée. (une sorte de mot de passe pour sécuriser votre clé, peut être vide)

    1
2
    > Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]

2. Ajouter votre clé SSH à l'agent SSH

Avant d'ajouter une nouvelle clé SSH à l'agent ssh pour gérer vos clés, vous devez avoir vérifié les clés SSH existantes et généré une nouvelle clé SSH.

  1. Démarrez l'agent ssh en arrière-plan.

    Dans une nouvelle fenêtre de terminal des privilèges élevés d’administrateur PowerShell, vérifiez que l’agent ssh est en cours d’exécution.

    1
2
3
    # start the ssh-agent in the background
Get-Service -Name ssh-agent | Set-Service -StartupType Manual
Start-Service ssh-agent

    1
2
    eval "$(ssh-agent -s)"
> Agent pid 59566

  2. Ajoutez votre clé privée SSH au ssh-agent. Si vous avez créé votre clé avec un nom différent, ou si vous ajoutez une clé existante qui porte un nom différent, remplacez id_ed25519 dans la commande par le nom de votre fichier de clé privée.

    1
2
    # Dans une fenêtre de terminal sans autorisations élevées.
ssh-add c:/Users/YOU/.ssh/id_ed25519

    1
    ssh-add ~/.ssh/id_ed25519

  3. Ajoutez la clé SSH à votre compte sur GitHub.

3. Ajouter la nouvelle clé SSH à votre compte GitHub

  1. Copiez la clé publique SSH dans votre presse-papiers. Si le nom de votre fichier de clé publique SSH est différent de celui de l'exemple de code, modifiez-le pour qu'il corresponde à votre configuration actuelle. Lors de la copie de votre clé, veillez à ne pas ajouter de nouvelles lignes ou d'espaces.

    1
2
    $ clip < ~/.ssh/id_ed25519.pub
# Copie le contenu du fichier id_ed25519.pub dans votre presse-papiers

    Utiliser clip.exe avec WSL

    Avec le Sous-système Windows pour Linux (WSL), vous pouvez utiliser clip.exe. Si clip ne fonctionne pas, vous pouvez localiser le dossier .ssh masqué, ouvrir le fichier dans votre éditeur de texte favori et le copier dans le Presse-papiers.

    1
2
3
    $ cat ~/.ssh/id_ed25519.pub
# Sélectionnez ensuite et copiez le contenu du fichier id_ed25519.pub
# affiché dans le terminal dans votre presse-papiers

    Accéder à votre clé SSH

    Vous pouvez également localiser le dossier masqué .ssh, ouvrir le fichier dans votre éditeur de texte favori et le copier dans le Presse-papiers.

  2. Pour accéder aux paramètres de votre compte GitHub, cliquez sur votre photo de profil dans le coin supérieur droit de n'importe quelle page de GitHub, puis Settings.

  3. Dans la section Access de la barre latérale à gauche, cliquez sur SSH and GPG keys.
  4. Cliquez sur New SSH key ou sur Add SSH key.
  5. Dans le champ Title, ajoutez un nom descriptif pour la nouvelle clé. Par exemple, si vous utilisez un ordinateur portable personnel, vous pouvez l'appeler "Mon PC".
  6. Sélectionnez Authentication key comme type de clé.
  7. Collez votre clé dans le champ Key. a19f09eea8afd047.png
  8. Finalement, Cliquez sur Add SSH key.

Pour une authentification sécurisée, utilisez un jeton d'accès personnel au lieu de votre mot de passe. Pour plus de commodité, utilisez un assistant d'identification.

Cette méthode est fortement recommandée, surtout si vous utilisez un ordinateur public (par exemple, un ordinateur institutionnel).

Création d'un jeton d'accès personnel (classique)

  1. Vérifiez votre adresse e-mail, si elle n'a pas encore été vérifiée.

  2. Dans le coin supérieur droit de n'importe quelle page sur GitHub, cliquez sur votre photo de profil, puis sur Settings.

  3. Dans la barre latérale gauche, cliquez sur Developer settings.

  4. Dans la barre latérale gauche, sous Personal access tokens, cliquez sur Tokens (classic).

  5. Sélectionnez Generate new token, puis cliquez sur Generate new token (classic).

  6. Dans le champ Note, donnez un nom descriptif à votre jeton.

  7. Pour donner une expiration à votre jeton, sélectionnez Expiration, puis choisissez une option par défaut ou cliquez sur Custom pour saisir une date.

  8. Sélectionnez les permissions que vous souhaitez accorder à ce jeton. Pour utiliser votre jeton pour accéder aux depôts à partir de la ligne de commande, sélectionnez repo. Un jeton sans permissions attribuées ne peut accéder qu'aux informations publiques.

  9. Cliquez sur Generate token.

  10. Si vous le souhaitez, pour copier le nouveau jeton dans votre presse-papiers, cliquez sur .