Voir la source de Cours:Méthodologie (R&D)

{{encart|Pour un [[Cours:Versioning avec Git|approfondissement]]}}
== Génie logiciel et gestion de versions ==
L'objectif de cette formation est de proposer une introduction à la gestion de versions, notamment dans la perspective d'un travail de groupe. L'outil choisi est un outil open source : Git. On couvrira ici plusieurs objectif :
* installer Git :
* notion de dépôt ;
* flux de travail de base (add/commit) ;
* branches et dépôts distants.
{{encart|
=== Ressources<ref>Ce cours a été adapté par [https://larac.univ-grenoble-alpes.fr/membre/philippe-dessus Philippe Dessus] dans le cadre du projet ReflexPro : http://espe-rtd-reflexpro.u-ga.fr/docs/projet-reflexpro/fr/latest/git.html</ref> ===
*[[:File:775-Git-énoncé.pdf|TD git]] ;
*[[:File:775-IdL-gitlab-énoncé.pdf|TD gitlab]] ;
*[[:File:775-IdL-git-TD corrigé.pdf|TDs corrigés]] ;
*[[:File:775-IdL-git.pdf|diaporama]].}}

=== Installation du logiciel ===
* Linux :
** Debian et dérivés: {{code|apt-get install git}} ;
** fedora {{Code|yum install git}} ;
* Mac/Windows : https://git-scm.com/downloads.

=== [[Wfr:Forge_(informatique)|forge]]s utilisables pour le cours ===
Github est incontestablement la solution la plus connue, mais n'est pas la seule solution viable.
# Forges utilisant le logiciel [[Wfr:GitLab CE|GitLab]], installable sur votre propre serveur :
#* [https://framagit.org framagit] ;
#* [https://gricad-gitlab.univ-grenoble-alpes.fr Forge de l'UGA] ;
# Forges avec logiciels ''ad hoc'' :
#* [https://bitbucket.org bitbucket] ;
#* [https://github.com Github].

Enfin, pour qui ne veut pas des fonctionnalités d'une forge (visibilité du projet, bugs, affichages), tout serveur muni d'un accès ssh peut jouer le rôle de dépôt distant.

=== Générer une clé [[wfr:Chiffrement RSA|RSA]] ===
[[File:Gitlab — Clefs SSH · Paramètres de l’utilisateur.png|495px|thumb|Exemple d'interface d'ajout de clé '''publique''' pour l'utilisation de git en ssh avec gitlab]]
# sous '''git-bash''' (windows) / dans le '''terminal''' (Linux, Mac), utiliser la commande {{code|ssh-keygen|bash}} ;
# choisissez l'emplacement par défaut (laisser le premier champ vide et appuyer sur entrée)<ref>Si vous avez déjà une clé et que vous voulez en créer une autre à utiliser avec git, il faudra alors spécifier un autre chemin. Quand vous utiliserez le ssh (si vous ne la mettez pas dans le dossier {{code|~/.ssh}}), il faudra, au lancement de git taper :
# windows seulsement : {{code|eval "ssh-agent -s"|bash}} (windows) ;
# {{code|ssh-add /c/users/nomutilisateur/.ssh/cle_ou_autre_chemin_absolu_vers_la_cle|bash}} (tous OS<br />sauf que le chemin sera plutôt de la forme {{code|/home/nomutilisateur/.ssh/cle_ou_autre_chemin_absolu_vers_la_cle|bash}} pour les systèmes unix).</ref> ;
# saisissez un mot de passe pour protéger votre clé privée.

Une fois ce couple clé publique/clé privé généré, vous pourrez-vous en servir pour vous connecter en ssh dans de nombreux contextes (dépôts git, serveurs). Pour cela, il suffira de fournir à l'administrateur système du serveur (éventuellement via une interface web<ref>Par exemple :
* https://gricad-gitlab.univ-grenoble-alpes.fr/profile/keys
* https://github.com/settings/keys
</ref>), votre clé '''publique''' (jamais la clé privée).

Pour la version windows, vous pouvez suivre [https://www.liquidweb.com/kb/putty-ssh-keys/ ce tuto].

=== Cycle d'usage de base de git ===
<syntaxhighlight lang="bash">#récupération des dernières modifications depuis un éventuel dépôt distant
git pull origin maBranche
#préparation de TOUS les fichiers modifiés pour le prochain commit
git add .
#commiter les changements
git commit -m "Explication de mes modifications"
#envoi des changements sur le dépôt distant
git push origin maBranche</syntaxHighlight>
Pour des informations beaucoup plus détaillées voir [[Cours:Versioning_avec_Git|Versioning avec Git]].

== Méthodologie du mémoire ==
=== Ressources ===
* L'[[:File:775-exo méthodo(Magnat).pdf|exercice d'écriture]] d'[https://www.researchgate.net/profile/Emilie_Magnat Émilie Magnat] ;
* [[:Fichier:775-Méthodo mémoire.pdf|le support de cours]].

=== Ressources externes ===
* [[wfr:Logiciels de gestion bibliographique|Logiciels de gestion bibliographique]] ;
** [https://www.zotero.org/styles 9000 feuilles de style zotero] ;
* [https://llasic.univ-grenoble-alpes.fr/menu-principal/bibliotheques/procedure-de-depot-des-memoires-de-master-17061.kjsp Ressources de l'UFR LLASIC] :
** [https://llasic.univ-grenoble-alpes.fr/medias/fichier/modele-memoire-libreoffice-2018-2019-1-_1542893386441-odt?INLINE=FALSE Feuille de style {{code|.odt}}] ;

== Notes et références ==
<references />
[[Catégorie:Enseignement/ML]]