35
modifications
Modifications
aucun résumé de modification
= Présentation des outils =
= Présentation des outils =
'''Git''' est un logiciel de gestion de versions décentralisé. Il permet, en autres, de sauvegarder chaque modification d'un programme, de travailler à plusieurs sur le même projet et de gérer différentes versions d'un programme. 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).
Voir sur le site https://www.sublimemerge.com/ .
Voir sur le site https://www.sublimemerge.com/ .
= Configuration =
= Organisation des repos de Polybot =
Les repository de PolyBot se trouve à cette adresse : https://gitlab.com/polybot-grenoble . Si vous n'y avez pas accès, vous pouvez demander qu'on vous le donne aux responsables de Polybot.
Voici une description de chaque projet sur GitLab :
* Power Supply : La carte de puissance (projet 5A 2021)
* Robot Core : Le code qui tournera sur le robot principal
* Tutorials and Exemples : Code utilisé pour certains tutos
* CAN Bus : Exemple de communication de 2 STM via le bus CAN
* Supervisor : Outils qui permettent de contrôler les robots à distance depuis un ordi
* Hub ToF : Code et Hardware qui va gérer les capteurs distance pour les collisions
* ROBOT-2 : Le code qui tournera sur le robot 2
* CAD : Modélisation 3D SolidWorks des robots
* MCP230 DSUB Breakout : PCB pour connecter les encodeurs au contrôleur moteur
* ArUco_4A : Code pour lire une image avec un code ArUco (projet 4A 2020)
Chaque projet est indépendant, vous pouvez travailler sur un ou plusieurs projet en même temps.
Chaque projet est indépendant, vous pouvez travailler sur un ou plusieurs projet en même temps.
== Les conflits ==
== Les conflits ==
[todo]
[todo]
https://git-scm.com/book/en/v2/Git-Branching-Basic-Branching-and-Merging#_basic_merge_conflicts
== Le fichier .gitignore ==
== Le fichier .gitignore ==
Le fichier <code>.gitignore</code> situé à la racine du projet est particulier. Il permet de lister les fichiers qui seront ignorés par git. Il ne les prendra pas en compte pour lors de leur modification dans le projet.
Le fichier <code>.gitignore</code> situé à la racine du projet est particulier. Il permet de lister les fichiers qui seront ignorés par git. Il ne les prendra pas en compte lors de leur modification dans le projet.
Exemple de contenu du fichier <code>.gitignore</code> :
Exemple de contenu du fichier <code>.gitignore</code> :
L'utilisation principale de ce fichier est d'ignorer les fichiers temporaires, les fichiers de build et les fichiers générés par les IDE.
L'utilisation principale de ce fichier est d'ignorer les fichiers temporaires, les fichiers de build et les fichiers générés par les IDE.
= Pour aller plus loin =
= Pour aller plus loin (Facultatif) =
== Ajout d'une clé SSH ==
GitLab autorise la communication avec ses serveurs via des clés SSH. L'avantage principal est de pouvoir se connecter à GitLab sans devoir rentrer son nom d'utilisateur et son mot de passe à chaque fois.
# 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 la clé publique générée avant (le contenu du fichier terminant par <code>.pub</code>).
# Valider en cliquant sur "Add key".
== Ajout d'une clé PGP ==
== Ajout d'une clé PGP ==
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 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].
[todo] [pas urgent car pas utilisé actuellement]
[todo] [pas urgent car pas utilisé actuellement]
= Liens et ressources =
* [https://git-scm.com/book/fr/v2 La documentation officielle de git (en français)]
* [https://git-scm.com/book/fr/v2 La documentation officielle de git (en français)]
* [https://try.github.io/ Ressources de GitHub pour apprendre git]
* [https://try.github.io/ Ressources de GitHub pour apprendre git]
* [https://docs.gitlab.com/ee/gitlab-basics/start-using-git.html La doc de Gitlab sur git]
* [https://docs.gitlab.com/ee/gitlab-basics/start-using-git.html La doc de Gitlab sur git]
* [https://www.google.fr/ Google :)]
* [https://www.google.fr/ Google :)]