Git/Avant de commencer

Un livre de Wikilivres.
< Git

Cette première étape est incontournable, nous allons voir comment installer et configurer Git sur votre machine. Suivez les instructions selon votre environnement de travail.

Il est à noter que l'architecture étant décentralisée, ces installations peuvent jouer le rôle du client ou du serveur, qui utilise le port 9418 mais passe en réseau par les services qui écoutent au port 22 (SSH), 80 (HTTP) ou 433 (HTTPS).

Installation[modifier | modifier le wikicode]

Linux[modifier | modifier le wikicode]

Paquet logiciel

Sur la plupart des distributions, vous pouvez utiliser votre gestionnaire de paquet.

Vous pouvez aussi installer git depuis les sources.


Mac OS[modifier | modifier le wikicode]

Une installateur graphique est disponible sur Google. Sinon avec MacPorts lancer :

sudo port install git-core

Windows[modifier | modifier le wikicode]

Téléchargement de Git sur msysgit

Git pour Windows est téléchargeable sous forme de binaires précompilés sur msysGit ou encore Git Bash. Cela inclut l’utilitaire en lignes de commande, une interface graphique, et un client SSH.

De plus, le setup Cygwin le propose également.

Intégré dans un IDE[modifier | modifier le wikicode]

Plusieurs environnements de développement intégré incluent déjà des clients Git complets, comme NetBeans ou PhpStorm.

Configuration minimaliste de l'environnement[modifier | modifier le wikicode]

Avant d'aller plus loin, il est indispensable de configurer Git a minima.

Dans Git, les contributeurs à un projet sont identifiés par leur nom et leur adresse courriel, il faut donc fournir à Git ces deux informations.

git config --global user.email "michel.boudran@fr.wikibooks.org"
git config --global user.name "Michel Boudran"

Pour voir la configuration :

git config -l

Éviter de retaper son mot de passe[modifier | modifier le wikicode]

Git propose un mécanisme pour stocker temporairement votre mot de passe en mémoire et ainsi vous éviter d'avoir à le retaper à chaque push, pull ou toute opération impliquant un repo distant.

git config --global credential.helper cache

Si cela ne fonctionne pas après l'avoir retapé au moins une fois sur Linux, compléter le fichier suivant :

vim ~/.netrc

En ajoutant le nom du serveur. Exemple :

 machine bitbucket.org
       login <user>
       password <password>
 machine github.com
       login <user>
       password <password>
 machine gitlab.com
       login <user>
       password <password>

Logo

Depuis septembre 2021, GitHub n'accepte plus les mots de passe mais demande à la place un token généré sur https://github.com/settings/tokens.

Si cela ne fonctionne toujours pas, vérifier que vous êtes dans le répertoire racine du projet, et que votre fichier .git/config est de la forme :

[core]
        repositoryformatversion = 0
        filemode = true
        bare = false
        logallrefupdates = true
[remote "origin"]
        url = https://github.com/JackPotte/JackBot.git
        fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
        remote = origin
        merge = refs/heads/master

Obtenir de l'aide[modifier | modifier le wikicode]

Git gère très bien l'auto-complétion. Au fur et à mesure que vous saisissez vos commandes, utilisez la touche tabulation pour que git vous propose des options.

À tout moment vous pouvez consulter le manuel de git avec

git --help

Pour obtenir de l'aide sur une commande en particulier, utilisez (exemple pour la commande branch)

git branch --help

Lorsque vous lisez des documentations, vérifiez qu'elles s'appliquent bien à la version que vous utilisez :

git --version