GitLab - 8.1 Créer un dépôt distant sur GitLab
Jusqu'ici, votre dépôt Git vit uniquement sur votre ordinateur. Un dépôt distant, hébergé sur GitLab, permet de partager votre travail et de récupérer celui des autres. Cette leçon montre comment le créer et le relier à votre projet local.
Créer un projet vide sur GitLab
Ouvrez un compte sur gitlab.com, ou utilisez l'instance GitLab de votre organisation si elle existe. La création d'un compte est gratuite.
Créez un nouveau projet vide et gardez-le privé. Ne cochez pas l'option qui ajoute un fichier README : votre projet local contient déjà des fichiers, et ce README entrerait en conflit au premier envoi.
Relier le dépôt local au dépôt distant
Copiez l'adresse du dépôt fournie par GitLab, puis ajoutez-la comme télécommande dans votre dossier local. Le nom origin n'est qu'un alias court pour cette adresse. Vous l'utiliserez dans la plupart des commandes.
Pour échanger avec GitLab sans saisir votre mot de passe à chaque fois, configurez une clé SSH. La leçon sur les clés SSH explique la procédure.
git remote add origin <adresse-du-depot>
git remote -v- Créer un projet vide et privé sur GitLab
- Copier l'adresse du dépôt
- Ajouter la télécommande origin
- Vérifier la liaison avec git remote -v
En résumé
Un dépôt distant permet de partager votre code et de travailler à plusieurs. Créez un projet vide sur GitLab, reliez-le à votre dépôt local sous le nom origin, puis vérifiez la liaison. Une clé SSH évite de saisir un mot de passe à chaque échange.
Points clés
- Un dépôt distant héberge votre projet sur un serveur comme GitLab.
- Le nom origin est un alias pour l'adresse du dépôt distant.
- Un projet vide évite les conflits avec les fichiers déjà présents en local.
- La commande git remote -v liste les télécommandes configurées.
- Une clé SSH permet de se connecter sans mot de passe.
Questions fréquentes
Dois-je créer un compte GitLab pour utiliser un dépôt distant ?
Oui, sauf si votre organisation possède sa propre instance GitLab. La création d'un compte sur gitlab.com est gratuite.
Pourquoi ne pas cocher l'option README ?
Le README crée un fichier distant qui n'existe pas en local. Au premier envoi, cela provoque un conflit.
Que faire si je ne peux ni lire ni envoyer sur le dépôt ?
Vérifiez que votre clé SSH est configurée. Une absence d'autorisation vient souvent de là.