Skip to main content

Gitlab

Git est un système de contrôle de version distribué, ce qui signifie que vous pouvez travailler localement, puis partager ou pousser vos modifications vers un serveur. Nous disposons d'un serveur GitLab local, dédié à l'usage des agents de l'IMEV pour la gestion de leurs projets et du code source, disponible sur https://gitlab.imev-mer.fr/ 

Première connexion

Screenshot from 2024-08-26 14-38-12.png

  • Après la connexion, votre compte devra être approuvé par un administrateur. Une fois approuvé, vous recevrez une notification.

Des clés SSH pour communiquer avec GitLab

GitLab utilise le protocole SSH pour communiquer en toute sécurité avec Git. Lorsque vous utilisez des clés SSH pour vous authentifier auprès du serveur distant GitLab, vous n'avez pas besoin de fournir votre nom d'utilisateur et votre mot de passe à chaque fois.

Vous pouvez consulter la documentation officielle GitLab pour plus de détails sur les clés SSH.

Générer une paire de clés SSH ED25519

Suivez les étapes ci-dessous pour générer une clé SSH de type ED25519, en fonction de votre système d'exploitation.

Windows

  1. Ouvrez PowerShell en tant qu'administrateur : 

    Screenshot 2024-10-21 171543.png

  2. Exécutez la commande suivante pour créer une paire de clés SSH ED25519 :

    ssh-keygen -t ed25519 -C "<commentaire>"
    Comme <commentaire> vous pouvez mettre votre nom

  3. Lorsque vous y êtes invité, acceptez l'emplacement par défaut en appuyant sur Entrée ou spécifiez un emplacement personnalisé.

  4. Ajoutez une phrase de passe (facultatif) pour plus de sécurité. Elle vous sera demandée lors de votre première connexion de la journée.

     

    Vous trouverez vos clés générées dans le dossier par défaut : C:\Users\<Votre_Nom_Utilisateur>\.ssh\

MacOS et Linux (Terminal)
  1. Ouvrez un terminalTerminal.
    2. et
  2. exé

    Exécutez la commande suivante pour créer une paire de clés SSH ED25519 :

    

    ssh-keygen -t ed25519 -C "<commentaire>"


Lorsque

Comme <commentaire> vous ypouvez êtesmettre invité,votre choisisseznom

  • Acceptez l'emplacement où enregistrer la clé (par défaut :en appuyant sur Entrée (généralement ~/.ssh/id_ed25519)id_ed25519 et) ajoutezou éventuellementspécifiez un emplacement personnalisé.

  • Ajoutez une phrase de passe pour plus de sécurité (facultatif). Elle vous sera demandée lors de votre première connexion de la journée.

    Vous trouverez

    ensuite
    • vos

    Une fois ces étapes terminées, vous aurez deux clés généréesfichiers :

    • Clé privée : id_ed25519
    • Clé publique : id_ed25519.pub

    Ajouter une clé SSH à votre compte GitLab

    Pour utiliser cette clé SSH avec GitLab, il est nécessaire de l’ajouter à votre compte :

    1. Copiez le contenu de votre fichier de clé publique. Vous pouvez le faire manuellement ou utiliser un script. Par exemple, pour copier une clé ED25519 dans le presse-papiers :

      ImportantmacOS

      :
      Les
      tr connexions-d '\n' < ~/.ssh/id_ed25519.pub | pbcopy

      Linux (requiert le package xclip)

      xclip -sel clip < ~/.ssh/id_ed25519.pub

      Git Bash sur Windows

      cat ~/.ssh/id_ed25519.pub | clip
      Si vous avez copié la clé manuellement, assurez-vous de copier l'intégralité de la clé, qui commence par  ssh-ed25519 et se fonttermine par le commentaire que vous avez mis, dans ce cas, votre nom.

    2. Connectez-vous à votre compte GitLab, puis allez dans uniquementPreferences via> HTTPSSSH Keys.

    3. LaSélectionnez Add new key

    4. Collez la clé publique dans le champ Key, puis cliquez sur Add key.

    Vérifier que vous pouvez vous connecter

    Après avoir ajouté la clé, vous pouvez vérifier que la connexion SSH neest serabien utiliséeétablie :

    1. Exécutez la commande suivante pour letester moment. Pour éviter authentification à chaquela connexion (push,:

      pull
      etc.)
      vous
      ssh pouvez-T ajoutergit@gitlab.com

    2. Si la configuration suivanteest depuiscorrecte, lavous terminalverrez avecun gitmessage indiquant que l'authentification a réussi, par exemple :

      

      

      gitWelcome configto --globalGitLab, credential.helper@votre_nom_utilisateur!
'cache
      
--timeout=36000'

    Configurer un projet avec une connexion SSH

    Pour cloner ou gérer un projet GitLab via SSH :

    1. Allez sur la page de votre projet GitLab.

    2. Cliquez sur le bouton Clone, puis choisissez l'option Clone with SSH.

    3. Copiez l'URL SSH fournie.

    4. Dans cevotre cas,terminal, clonez le timeoutprojet està l’aide de 10la heures,commande desuivante sorte:

      qu'il
      ne
      faut
      git pasclone s'authentifiergit@gitlab.com:votre_nom_utilisateur/votre_projet.git qu'

    Cela configurera votre dépôt en utilisant une foisconnexion parSSH jour.sécurisée.

    Back to top