GEL 1001 Design I (méthodologie)"

Transcription

1 GEL 1001 Design I (méthodologie)" Gestion concourante de versions (Mercurial)" Hiver 2015" Département de génie électrique et de génie informatique

2 Hiver 2015" GEL 1001 Design I (méthodologie)" 2" Mercurial"! Outil multiplateforme «open source»"! Permet de gérer un ensemble de fichiers de manière concourante" " Chaque utilisateur modifie une copie des fichiers en parallèle" " Gère l historique" " Permet de revenir en arrière sur toute version" " Gère la fusion des fichiers entre plusieurs dépôts"! Permet des accès locaux ou via Internet" " Variété de protocoles disponible"

3 Systèmes de contrôles des versions"! RCS (~1985)" " Contrôle des versions dans un système de fichiers particulier"! CVS (~1990)" " Contrôle des versions avec accès distribués à un dépôt centralisé "! Subversion (SVN) (~2000)" " Accès distribués avec dépôt centralisé" " Corrections de faiblesses de CVS (p. ex. renommer ou déplacer les fichiers)"! Mercurial (~2005)" " Système de version décentralisé, avec emphase sur la simplicité" " Codé essentiellement en langage python"! Git (~2005)" " Système de version décentralisé, développé pour gérer le code source du noyau de Linux" " Concurrent de Mercurial, codé en C avec commandes en shell et perl" Hiver 2015" GEL 1001 Design I (méthodologie)" 3"

4 Hiver 2015" GEL 1001 Design I (méthodologie)" 4" Exemple d utilisation" Alice Dépôt maître pika iroquois.gel.ulaval.ca Bernard Dépôts locaux Carole

5 Hiver 2015" GEL 1001 Design I (méthodologie)" 5" Ligne de commande ou interface graphique?"! Mercurial : développé comme un outil ligne de commande (dans un terminal)" " hg version Mercurial Distributed SCM (version ) [ ] " Tout est possible par la ligne de commande"! Interfaces graphiques pour les opérations quotidiennes" " On doit parfois utiliser la ligne de commande pour effectuer des opérations complexes"

6 Hiver 2015" GEL 1001 Design I (méthodologie)" 6" Faire une copie locale"! hg clone : faire une copie locale d un dépôt" hg clone ssh://username@pika.gel.ulaval.ca//services /GEL1001/equipe00/demo destination directory: demo requesting all changes adding changesets adding manifests adding file changes added 2 changesets with 23 changes to 22 files updating to branch default 22 files updated, 0 files merged, 0 files removed, 0 files unresolved

7 Hiver 2015" GEL 1001 Design I (méthodologie)" 7" Visualiser l historique"! hg log : visualiser l historique des modifications" " hg log changeset: 1:6eca e tag: tip user: Christian Gagne <christian.gagne@gel.ulaval.ca> date: Wed Jan 13 16:05: summary: Date de remise modifiee. changeset: 0:96f6ec3d3032 user: Christian Gagne <christian.gagne@gel.ulaval.ca> date: Wed Jan 13 15:59: summary: Ajout de l'exemple du rapport.

8 Hiver 2015" GEL 1001 Design I (méthodologie)" 8" Révision et identifiant"! Avec Mercurial, chacun travaille avec un dépôt local distinct"! Les dépôts sont synchronisés"! Le numéro de révision est spécifique à la copie locale"! L identifiant est globalement unique" Révision locale Identifiant unique changeset: 1:6eca e changeset: 0:96f6ec3d3032

9 Hiver 2015" GEL 1001 Design I (méthodologie)" 9" Différences entre révisions"! hg diff : connaître les différences entre deux révisions d un fichier" hg diff -r 0 diff -r 96f6ec3d3032 rapport/rapport_demo.tex --- a/rapport/rapport_demo.tex Wed Jan 13 15:59: b/rapport/rapport_demo.tex Wed Jan 13 17:05:14 -51,7 55\,555\,555 & Ordralphabétix & \\\hline % matricule & nom & \\\hline 66\,666\,666 & Tragicomix & \\\hline % matricule & nom & \\\hline } -\DateRemise{23 janvier 2008} % Date de remise +\DateRemise{5 février 2010} % Date de remise

10 Historique et différences" Hiver 2015" GEL 1001 Design I (méthodologie)" 10"

11 Hiver 2015" GEL 1001 Design I (méthodologie)" 11" Obtenir le statut des fichiers"! hg status : état actuel des fichiers par rapport au dépôt local" hg status M rapport/rapport_demo.tex A.hgignore " " Fichier rapport/rapport_demo.tex est modifié" " Fichier.hgignore est ajouté"

12 Hiver 2015" GEL 1001 Design I (méthodologie)" 12" Modifier la copie locale"! hg commit : intégrer les changements aux fichiers dans le dépôt local " " L utilisateur doit entrer une brève description des changements" " Les changements restent locaux, les modifications ne sont pas propagées aux autres dépôts" " Propagation des changements au dépôt maître uniquement avec hg push

13 Hiver 2015" GEL 1001 Design I (méthodologie)" 13" Modification de la copie locale"

14 Hiver 2015" GEL 1001 Design I (méthodologie)" 14" Configurer le nom d utilisateur"! Confirmation des changements exige de configurer Mercurial avec un nom d utilisateur " " Configuration dans fichier.hgrc du répertoire de l utilisateur" " Sous Linux et Mac OS X, fichier ~/.hgrc " Sous Windows, le répertoire d utilisateur est donné par la commande suivante (dans un terminal) C:\> echo %UserProfile% # Par exemple, la réponse peut être: C:\Users\username # Le fichier à modifier est mercurial! Section du fichier avec le nom d utilisateur" # Ceci est le fichier de configuration de Mercurial. [ui] username = Prenom Nom <prenom.nom.#@ulaval.ca>

15 Hiver 2015" GEL 1001 Design I (méthodologie)" 15" Intégrer les changements dans le dépôt maître"! hg push : intégrer les nouvelles révisions du dépôt local dans le dépôt maître hg push pushing to ssh://username@pika.gel.ulaval.ca //services/gel1001/equipe00/demo searching for changes remote: adding changesets remote: adding manifests remote: adding file changes remote: added 1 changesets with 2 changes to 2 files " " Modifications doivent être intégrées au préalable dans le dépôt local via hg commit

16 Mettre à jour le dépôt local"! hg pull : intégrer les nouvelles révisions du dépôt maître dans le dépôt local hg pull! pulling from ssh://username@pika.gel.ulaval.ca //services/gel1001/equipe00/demo searching for changes adding changesets adding manifests adding file changes added 1 changesets with 2 changes to 2 files (run 'hg update' to get a working copy) " " Met à jour uniquement le dépôt local, ne met pas à jour les fichiers locaux" " hg pull -u : synchroniser le dépôt local et mettre à jour les fichiers locaux" Hiver 2015" GEL 1001 Design I (méthodologie)" 16"

17 Hiver 2015" GEL 1001 Design I (méthodologie)" 17" Synchroniser les fichiers avec le dépôt local"! hg update : mettre à jour les fichiers avec la révision la plus récente du dépôt local" hg update! 2 files updated, 0 files merged, 0 files removed, 0 files unresolved

18 Vérifier la mise à jour" Hiver 2015" GEL 1001 Design I (méthodologie)" 18"

19 Hiver 2015" GEL 1001 Design I (méthodologie)" 19" Commandes principales"! hg clone : obtenir une copie locale d un dépôt maître" "! hg pull : synchroniser le dépôt local avec le dépôt maître, afin d obtenir toutes les nouvelle révisions"! hg update : mettre à jour les fichiers avec la révision la plus récente présente dans le dépôt local" "! hg commit : sauvegarder des révisions des fichiers dans le dépôt local"! hg push : transmettre les révisions du dépôt local vers le dépôt maître"

20 Hiver 2015" GEL 1001 Design I (méthodologie)" 20" Intégrer deux copies locales"! Mercurial est un outil distribué, sans l obligation de toujours utiliser le dépôt centralisé" " Deux utilisateurs peuvent directement synchroniser leurs dépôts locaux" " hg serve : démarrer un serveur temporaire permettant à d autres utilisateurs de faire des hg pull de votre dépôt local" " Offre également un serveur Web local pour explorer le contenu de dépôt (par défaut sur port 8000)"

21 Serveur Web intégré" Hiver 2015" GEL 1001 Design I (méthodologie)" 21"

22 Hiver 2015" GEL 1001 Design I (méthodologie)" 22" Fusion de changements et gestion de conflits"! Mercurial fait une gestion intelligente des modifications «parallèles»" " Si modifications sur sections différentes du fichier, changements fusionnés automatiquement "! Si modifications se recoupent, l utilisateur doit intervenir manuellement" " Utilisateur informé d un changement recoupant des modifications absentes dans le dépôt local" " Commandes clés : hg heads, hg merge, hg resolve

23 Hiver 2015" GEL 1001 Design I (méthodologie)" 23" Désynchronisation de dépôts" hg push pushing to ssh://username@pika.gel.ulaval.ca //services/gel1001/equipe00/demo searching for changes abort: push creates new remote heads! (did you forget to merge? use push -f to force) hg pull pulling from ssh://username@pika.gel.ulaval.ca //services/gel1001/equipe00/demo searching for changes adding changesets adding manifests adding file changes added 1 changesets with 1 changes to 1 files (+1 heads) (run 'hg heads' to see heads, 'hg merge' to merge)

24 Hiver 2015" GEL 1001 Design I (méthodologie)" 24" Conflits entre révisions" hg heads changeset: 4:7e929321cade tag: tip parent: 2:710a9666f4a4 user: Christian Gagne <christian.gagne@gel.ulaval.ca> date: Thu Jan 14 15:07: summary: Le titre est change. changeset: 3:f3b017a655f1 user: Christian Gagne <christian.gagne@gel.ulaval.ca> date: Thu Jan 14 15:06: summary: Modification au titre. hg merge merging rapport/rapport_demo.tex warning: conflicts during merge. merging rapport/rapport_demo.tex failed! 0 files updated, 0 files merged, 0 files removed, 1 files unresolved use 'hg resolve' to retry unresolved file merges or 'hg update -C' to abandon

25 Conflits entre révisions" Hiver 2015" GEL 1001 Design I (méthodologie)" 25"

26 Hiver 2015" GEL 1001 Design I (méthodologie)" 26" Commandes utiles"! hg init : créer un nouveau projet"! hg add : ajouter un fichier!! hg rename : renommer un fichier"! hg copy : copier un fichier"! hg remove : retirer un fichier du dépôt"! hg help : obtenir de l aide générale"! hg help commande : obtenir de l aide sur une commande spécifique"

27 Hiver 2015" GEL 1001 Design I (méthodologie)" 27" Dépôts pour le cours"! Trois dépôts ont été créés pour chaque équipe sur les serveurs du département de génie électrique et de génie informatique"! Dépôt du rapport ssh://idul@pika.gel.ulaval.ca//depots/2015/h/gel1001/equipe##/hgroot/rapport! Dépôt de gestion ssh://idul@pika.gel.ulaval.ca//depots/2015/h/gel1001/equipe##/hgroot/gestion! Dépôt de présentation ssh://idul@pika.gel.ulaval.ca//depots/2015/h/gel1001/equipe##/hgroot/presentation"

28 Hiver 2015" GEL 1001 Design I (méthodologie)" 28" Remise des travaux"! Chaque semaine, les assistants vont consulter vos dépôts d équipe" " Ordres du jour et procès-verbaux dans le dépôt de gestion" " Fichier Project de la planification des tâches dans le dépôt de gestion" " État du rapport dans le dépôt du rapport"! Remises des quatre versions du rapport comme «bundle» de votre dépôt dans Pixel" " Créer le «bundle»: hg bundle a equipe##version#.hg " Remettre le «bundle» equipe##version#.hg dans Pixel" " Récupérer le fichier remis de Pixel et vérifier le contenu du «bundle»: hg unbundle fichier_récupéré.hg

29 Hiver 2015" GEL 1001 Design I (méthodologie)" 29" Conclusion"! Mercurial : outil puissant pour le travail collaboratif et la gestion des versions" " Facilite le travail en équipe" " Permet le retour en arrière" " Décentralisé"! Supporte les fichiers binaires, mais plus utile pour les fichiers contenant du texte" " HTML, XML, LaTeX, C++, Java, Python, etc. " " Les différences entre les fichiers binaires ne peuvent pas être visualisées"

30 Hiver 2015" GEL 1001 Design I (méthodologie)" 30" Références"! Mercurial : The Definite Guide par Bryan O Sullivan" " Tutoriel sur Mercurial" " Site Web de Mercurial" " "

31 Hiver 2015" GEL 1001 Design I (méthodologie)" 31" Logiciels conseillés"! Mercurial (toutes plateformes)" " TortoiseHg : interface graphique pour Windows et Linux" " Murky : interface graphique pour Mac OS X" " "

32 Hiver 2015" GEL 1001 Design I (méthodologie)" 32" Activation du compte"! Pour activer votre compte informatique sur le réseau du département de génie électrique et de génie informatique (nécessaire une seule fois)*" " " " " * Votre «idul» doit être entré en minuscules"