35
modifications
Modifications
Petite reorganisation du sommaire et amélioration du contenu
On va utiliser un certain nombre de termes anglais car c'est ceux qui sont utilisés partout, et l'informatique se fait en anglais.
On va utiliser un certain nombre de termes anglais car c'est ceux qui sont utilisés partout, et l'informatique se fait en anglais.
'''Git''' est un logiciel de gestion de versions décentralisé, c'est-à-dire que l'on peut travailler en local. On peut également partager (''push'') nos modifications vers un serveur (GitLab pour nous).
'''Git''' est un logiciel de gestion de versions décentralisé, c'est-à-dire que l'on peut travailler en local. Il permet, en autres, de sauvegarder chaque modification d'un programme. On peut également partager (''push'') nos modifications vers un serveur (GitLab pour nous).
'''GitLab''' est une plateforme qui permet de sauvegarder et de visualiser un ''repository'' git. Il propose aussi un certain nombre de services comme par exemple un gestionnaire de bug (''issues''), de la code review ou de l'intégration continue (CI).
'''GitLab''' est une plateforme qui permet de sauvegarder et de visualiser un ''repository'' git. Il propose aussi un certain nombre de services comme par exemple un gestionnaire de bug (''issues''), de la code review ou de l'intégration continue (CI).
= Installation =
= Installation =
== Installation de git ==
== Installation de git ==
Sur ubuntu ou debian : <code>apt install git</code>
Sur ubuntu ou debian, il suffit de faire cette commande dans un terminal <code>sudo apt install git</code>.
Pour les autres plateformes :
Pour les autres plateformes :
# Accéder à https://git-scm.com/download/
# Télecharger la dernière version du logiciel pour votre plateforme.
# Pour Windows, en faisant clique droit dans un dossier vous devriez voir apparaître "Git GUI Here" et "Git Bash Here".
== Installation de sublime-merge ==
== Installation de sublime-merge ==
= Configuration =
= Configuration =
== Ajout d'une clé SSH ==
== Ajout d'une clé SSH ==
GitLab autorise la communication avec ses serveurs via des clés SSH.
GitLab autorise la communication avec ses serveurs via des clés SSH. En gros, cela remplace le mot de passe, et ça fournit d'autres avantages. Cette étape n'est pas obligatoire, mais elle est conseillé.
# Pour générer une clé SSH suivez les indications [https://git-scm.com/book/fr/v2/Git-sur-le-serveur-G%C3%A9n%C3%A9ration-des-cl%C3%A9s-publiques-SSH ici].
# Puis, sur GitLab, cliquer sur l'avatar en haut à droite, puis sur Settings.
# Cliquer sur "SSH Keys" puis coller le contenu de la clé publique générée avant (le fichier terminant par <code>.pub</code>).
# Valider en cliquant sur "Add key".
= Organisation des repos de Polybot =
= Organisation des repos de Polybot =
= Utilisation pratique =
= Utilisation pratique =
== Guide video ==
Cette vidéo explique les étapes importantes pour pouvoir utiliser git, GitLab et sublime-merge.
https://tube.nocturlab.fr/videos/watch/2055a0cd-1b93-4e8d-ab41-a41cc1c0ccbe
== La commande stash ==
== La commande stash ==
# Faire la commande <code>stash pop</code>, qui permet d'appliquer toutes les modifications précédement enregistré
# Faire la commande <code>stash pop</code>, qui permet d'appliquer toutes les modifications précédement enregistré
# Si cela fonctionne, c'est fini, sinon cela peut créer un '''conflit'''. Voir la section sur les conflits pour plus de détail.
# Si cela fonctionne, c'est fini, sinon cela peut créer un '''conflit'''. Voir la section sur les conflits pour plus de détail.
== Les conflits ==
[todo]
== Le fichier .gitignore ==
[todo]
= Pour aller plus loin =
= Pour aller plus loin =
== Ajout d'une clé PGP ==
== Ajout d'une clé PGP ==
Ce n'est pas obligatoire mais c'est une forme d'authentification en plus et certains projets (comme par exemple le noyau linux) l'oblige.
Une clé PGP (Pretty Good Privacy) permet de ''signer'' son travail.
Une clé PGP (Pretty Good Privacy) permet de ''signer'' son travail.
Tout le monde peut changer son nom lors du commit et peut donc usurper votre identité [https://github.com/jayphelps/git-blame-someone-else]. PGP empêche cela, en signant le commit. Voici une vidéo explicant le fonctionnement général de PGP : https://www.youtube.com/watch?v=GSIDS_lvRv4 .
Tout le monde peut changer son nom lors du commit et peut donc usurper votre identité [https://github.com/jayphelps/git-blame-someone-else]. PGP empêche cela, en signant le commit. Voici une vidéo explicant le fonctionnement général de PGP : https://www.youtube.com/watch?v=GSIDS_lvRv4 .
# Pour créer et mettre en place votre clé PGP, suivez la partie Introduction [https://git-scm.com/book/fr/v2/Utilitaires-Git-Signer-votre-travail ici].
# Pour l'ajouter sur GitLab, aller dans les paramètres puis dans "GPG Keys".
# Ajouter la clé.
# Pour signer chaque commit automatiquement faire : <code>git config --global commit.gpgsign true</code>
Maintenant, lorsque vous faites un commit, vous pouvez voir la mention <code>Verified</code> sur le commit signé comme sur l'image ci-dessous.
Maintenant, lorsque vous faites un commit, vous pouvez voir la mention <code>Verified</code> sur le commit signé comme sur l'image ci-dessous.
[[Fichier:Commit signé.png|Exemple d'un commit signé et d'un commit non signé]]
[[Fichier:Commit signé.png|Exemple d'un commit signé et d'un commit non signé]]
== Utilisation des sous-modules ==
== Utilisation des sous-modules ==
[todo]
[todo] [pas urgent car pas utilisé actuellement]