Groupe Eyrolles, 2006, ISBN : 2-212-11919-4

Groupe Eyrolles, 2006, ISBN : 2-212-11919-4

Table des matières Préface... III Remerciements................................................... III Conventions typographiques........................................ IV CHAPITRE 1 Introduction... 1 Possibilités offertes par le contrôle de version............................ 2 Étude de cas n 1 : travail concurrent................................. 2 Étude de cas n 2 : correction d un bogue.............................. 3 Étude de cas n 3 : travail distant.................................... 3 Conclusion.................................................... 3 Organisation de cet ouvrage.......................................... 4 Pourquoi choisir Subversion?........................................ 4 Versionner des fichiers, des répertoires et des métadonnées................ 5 Propagations atomiques et ensembles de modifications................... 5 Fonctions réseau : copier en local, SSH, Apache......................... 6 Créer des branches, marques et fusions sans coût........................ 6 Un outil multi-plates-formes...................................... 6 CHAPITRE 2 Qu est-ce que le contrôle de versions?... 7 Un dépôt central, ou référentiel....................................... 7 Un serveur et des clients distants.................................... 8 La possibilité de travailler hors ligne................................. 8 Quels éléments enregistrer sur le dépôt?................................ 9 Des copies de travail locales pour manipuler des fichiers................... 10 Récupérer une première copie (checkout)............................ 11 Propager ses modifications....................................... 11 Actualiser sa copie de travail...................................... 11 Organisation en projets, répertoires et fichiers........................... 12 Le rôle des versions................................................ 13

VI Pratique du développement collaboratif avec Subversion Numérotation des versions....................................... 13 Enregistrement des versions...................................... 15 Marquer l état du projet à un instant donné............................. 15 Créer plusieurs branches............................................ 15 Un problème fréquent : gérer le code à livrer.......................... 15 La solution : utiliser des branches.................................. 16 Gestion des branches........................................... 17 Fusionner des branches............................................ 18 Les différents types de verrouillage.................................... 18 Verrouillage strict.............................................. 19 Verrouillage optimiste.......................................... 19 Contrôle de versions ou gestion de configuration........................ 21 Mise en œuvre.................................................... 22 Principes de base.............................................. 22 Éléments importants lors de l usage du contrôle de versions.............. 23 CHAPITRE 3 Installer Subversion, créer un dépôt et y accéder... 25 Installer Subversion............................................... 26 La ligne de commande.......................................... 26 Invites de commande........................................... 28 Subversion est-il installé?........................................ 29 Créer un dépôt................................................... 30 Créer un projet simple............................................. 31 Extraire un projet................................................. 33 Subversion et les protocoles réseau.................................... 34 svn......................................................... 35 svn+ssh..................................................... 35 http........................................................ 37 Choisir une méthode d accès réseau................................... 38 CHAPITRE 4 Commandes usuelles de Subversion... 41 Créer une copie de travail........................................... 42 Garder la copie locale à jour......................................... 43 Modifier un fichier................................................ 45 Apporter des modifications....................................... 45 Propager des modifications....................................... 46 Afficher l historique des changements................................. 48 Historique par ligne............................................ 49

Table des matières VII Vérifier l espace de travail........................................ 50 Copies de travail correspondant à plusieurs révisions.................... 51 Ajout de fichiers et de répertoires..................................... 51 Copier et déplacer des fichiers et des répertoires......................... 52 Copier un fichier.............................................. 53 Renommer un fichier........................................... 54 Renommer un répertoire........................................ 56 Afficher les différences............................................. 57 Différences entre la copie locale et le dépôt........................... 57 Identifiants de versions de Subversion............................... 58 Différences entre versions........................................ 59 Différentiels et patchs........................................... 61 CHAPITRE 5 Conflits et annulations... 63 Gérer les conflits de versions........................................ 63 Réparer un conflit............................................. 65 Verrouiller des fichiers.......................................... 68 Verrouillage et déverrouillage..................................... 68 Suppression et vol de verrous..................................... 69 Annuler une modification.......................................... 70 Annuler les modifications d un seul fichier........................... 70 Annuler de plus grosses modifications............................... 73 CHAPITRE 6 Propriétés... 75 Qu est-ce qu une propriété?......................................... 75 Manipuler les propriétés............................................ 76 Expansion des mots-clés............................................ 77 Ignorer certains fichiers............................................ 79 Codes de fin de ligne............................................... 80 Types de contenu MIME........................................... 81 Fichiers exécutables............................................... 81 Fichiers en lecture seule............................................ 82 Gestion automatique des propriétés................................... 83 CHAPITRE 7 Organiser votre dépôt... 85 Gestion d un seul projet............................................ 85 Gestion de projets multiples......................................... 86

VIII Pratique du développement collaboratif avec Subversion Dépôts multiples.................................................. 87 CHAPITRE 8 Marques et branches... 89 Marques et branches, de quoi s agit-il?................................ 90 Les marques et les branches en pratique............................. 91 Les branches de livraison...................................... 91 Les livraisons proprement dites................................. 92 Les corrections de bogues...................................... 92 Les expériences des développeurs................................. 93 Créer une branche de livraison....................................... 93 Travailler dans une branche de livraison................................ 94 Extraire une branche de livraison.................................. 94 Associer la copie de travail à une branche de livraison................... 95 Créer une livraison................................................ 96 Corriger des bogues dans une branche de livraison....................... 98 Correctifs de bogues simples...................................... 99 Bogues complexes............................................ 100 Branches expérimentales pour les développeurs......................... 102 Travailler sur du code expérimental................................ 102 Fusionner la branche expérimentale............................... 103 CHAPITRE 9 Créer un projet... 105 Créer le projet de départ........................................... 106 Importer dans Subversion....................................... 106 Créer des répertoires à la main................................... 107 Structure interne d un projet....................................... 108 Fichiers au premier niveau d arborescence........................... 108 Répertoires au premier niveau d arborescence........................ 109 Partager du code entre des projets................................... 111 Partager le code grâce à un sur-projet.............................. 111 Partager le code par modules externes.............................. 113 CHAPITRE 10 Code des tierces parties... 117 Bibliothèques binaires............................................ 117 Où les classer dans votre dépôt?.................................. 117 S intégrer à un environnement de compilation........................ 119 Bibliothèques avec code source...................................... 119

Table des matières IX Première importation du code source d une tierce partie................ 120 Mettre à jour une livraison à partir d un paquetage fournisseur........... 121 Utiliser le code d une tierce partie dans un projet...................... 124 Modifier le code d une tierce partie................................ 124 Actualiser du code modifié...................................... 125 Expansion des mots-clés pendant l importation......................... 125 CHAPITRE 11 Installer, mettre en réseau, sécuriser et administrer Subversion... 127 Installer Subversion.............................................. 127 Installation sous Windows...................................... 128 Installation sous Linux......................................... 128 Mise en réseau avec svnserve....................................... 128 svnserve sous Windows........................................ 128 svnserve sous Unix............................................ 129 Mise en réseau avec svn+ssh........................................ 129 Dépanner une connexion SSH................................... 131 svn: Le fichier spécifié est introuvable (Windows)................... 131 svn: Aucun fichier ou répertoire de ce type (Unix).................... 132 Subversion ne répond plus (Windows)........................... 132 svnserve: command not found et svn: Connection closed unexpectedly...... 132 svn: No repository found in 'svn+ssh://monserveur/home/svn-repos...... 133 Mise en réseau avec Apache........................................ 133 Apache sous Windows......................................... 133 Télécharger et installer Apache................................. 133 Installer les modules d Apache pour Subversion...................... 134 Configurer Apache......................................... 135 Apache sous Linux RedHat..................................... 137 Installer mod_dav_svn...................................... 137 Configurer Apache......................................... 137 Sécuriser Subversion.............................................. 138 svnserve.................................................... 138 svn+ssh.................................................... 141 Apache.................................................... 141 Contrôle d accès avec des scripts attachés........................... 143 Sauvegarder le dépôt.............................................. 144 Sauvegardes complètes......................................... 144 Sauvegardes incrémentales...................................... 145

X Pratique du développement collaboratif avec Subversion CHAPITRE 12 Migrer vers Subversion... 149 Installer cvs2svn................................................. 150 Décider du niveau de conversion.................................... 150 Convertir votre dépôt............................................. 151 CHAPITRE 13 Outils tierce partie... 153 TortoiseSVN................................................... 153 Télécharger et installer......................................... 154 Extraire une copie de travail..................................... 154 Faire des modifications......................................... 155 Propager les modifications...................................... 157 Résoudre des conflits.......................................... 157 Intégration aux environnements de développement...................... 160 Autres outils.................................................... 160 ANNEXE A Résumé des commandes... 161 Résumé des commandes de Subversion............................... 161 Options communes........................................... 161 svn add.................................................... 162 Options................................................. 162 svn blame................................................... 162 svn cat..................................................... 162 Options................................................. 162 svn checkout................................................ 163 Options................................................. 163 svn cleanup................................................. 163 svn commit................................................. 163 Options................................................. 163 svn copy.................................................... 164 Options................................................. 164 svn delete................................................... 164 Options................................................. 164 svn diff..................................................... 165 Options................................................. 165 svn export.................................................. 165 Options................................................. 165 svn import.................................................. 166

Table des matières XI Options................................................. 166 svn info.................................................... 166 Options................................................. 166 svn list..................................................... 166 Options................................................. 166 svn log..................................................... 167 Options................................................. 167 svn merge................................................... 167 Options................................................. 168 svn mkdir................................................... 168 svn move................................................... 168 Options................................................. 168 svn propdel................................................. 168 svn propedit................................................. 169 svn propget................................................. 169 Options................................................. 169 svn proplist................................................. 169 Options................................................. 169 svn propset.................................................. 170 Options................................................. 170 svn resolved................................................. 170 Options................................................. 170 svn revert................................................... 170 Options................................................. 171 svn status................................................... 171 Options................................................. 172 svn switch.................................................. 173 Options................................................. 173 svn update.................................................. 173 Options................................................. 174 Comment faire pour............................................... 174 Extraire (chapitre 3)....................................... 174 Extraire une révision donnée (chapitre 4)......................... 174 Extraire la révision d une date donnée (chapitre 4).................. 174 Savoir d où vient une copie de travail (chapitre 4)................... 174 Actualiser une copie de travail (chapitre 4)........................ 174 Actualiser des éléments donnés d une copie de travail (chapitre 4)......... 174 Ajouter des fichiers à un dépôt (chapitre 4)......................... 174 Définir une propriété sur un fichier ou un répertoire (chapitre 6)......... 175 Modifier une propriété sur un fichier ou sur un répertoire (chapitre 6)...... 175

XII Pratique du développement collaboratif avec Subversion Faire la liste de toutes les propriétés sur un fichier ou sur un répertoire (chapitre 6)................................ 175 Afficher le contenu d une propriété (chapitre 6)...................... 175 Supprimer une propriété (chapitre 6)............................ 175 Activer l expansion de mots-clés pour un fichier (chapitre 6)............. 175 Ignorer certains fichiers dans un répertoire (chapitre 6)................ 175 Définir le caractère de fin de ligne d un fichier (chapitre 6)............. 175 Définir le type MIME d un fichier (chapitre 6)..................... 175 Marquer un fichier comme exécutable (chapitre 6)................... 176 Copier un fichier ou un répertoire (chapitre 4)...................... 176 Renommer un fichier ou un répertoire (chapitre 4)................... 176 Déplacer un fichier ou un répertoire (chapitre 4)..................... 176 Afficher les changements dans un fichier ou un répertoire (chapitre 4)...... 176 Comparer deux révisions d un fichier (chapitre 4).................... 176 Afficher les différences entre un fichier et la dernière révision du dépôt (chapitre 4)........................ 176 Afficher les modifications les plus récentes d un fichier (chapitre 4)........ 176 Créer un fichier patch (chapitre 4).............................. 176 Appliquer un patch (chapitre 4)................................ 177 Supprimer vos modifications face à un conflit (chapitre 5).............. 177 Supprimer les modifications d une autre personne face à un conflit (chapitre 5).................................. 177 Marquer un conflit comme résolu (chapitre 5)...................... 177 Propager des modifications (chapitre 4)........................... 177 Afficher l historique d un fichier (chapitre 4)....................... 177 Afficher l activité récente d un répertoire (chapitre 4)................. 177 Afficher l historique détaillé d un fichier (chapitre 4).................. 177 Annoter un fichier avec les informations sur ses auteurs (chapitre 4)....... 177 Poser un verrou sur un fichier (chapitre 5)......................... 178 Supprimer un verrou en tant qu'administrateur (chapitre 5)............ 178 Supprimer un verrou en tant qu'utilisateur (chapitre 5)............... 178 Voler un verrou (chapitre 5).................................. 178 Revenir sur une modification déjà propagée (chapitre 5)............... 178 Vérifier l état de la copie de travail (chapitre 4)..................... 178 Afficher les mises à jour en attente par rapport au dépôt (chapitre 4)....... 178 Créer une branche de livraison (chapitre 8)........................ 178 Extraire une branche de livraison (chapitre 8)...................... 178 Associer une copie de travail à une branche de livraison (chapitre 8)....... 179 Associer une copie de travail au tronc commun (chapitre 8)............. 179 Créer une marque de livraison (chapitre 8)........................ 179 Extraire une livraison (chapitre 8).............................. 179

Table des matières XIII Fusionner un correctif de bogue simple depuis une branche de livraison vers le tronc commun (chapitre 8)............................... 179 Créer une branche pour un correctif complexe (chapitre 8).............. 179 Extraire une branche de correctif de bogue (chapitre 8)................ 179 Marquer la fin d un correctif (chapitre 8)......................... 180 Fusionner un correctif de bogue complexe dans une branche de livraison (chapitre 8)......................... 180 Créer des branches expérimentales (chapitre 8)...................... 180 Utiliser une branche expérimentale (chapitre 8)..................... 180 Revenir au tronc commun (chapitre 8)........................... 180 Savoir quand a été créée une branche (chapitre 8).................... 180 Fusionner une branche expérimentale (chapitre 8)................... 180 Importer un projet dans le dépôt (chapitre 9)....................... 181 Créer des répertoires pour un projet (chapitre 9)..................... 181 Importer du code de tierce partie (chapitre 10)...................... 181 Marquer un paquetage fournisseur (chapitre 10).................... 181 Charger un paquetage fournisseur (chapitre 10)..................... 181 Utiliser du code d un fournisseur dans un projet (chapitre 10)........... 181 Mettre à jour le code d un fournisseur dans un projet (chapitre 10)........ 181 Démarrer svnserve sous Windows (chapitre 11)..................... 182 Démarrer svnserve sous Unix (chapitre 11)........................ 182 Créer une sauvegarde complète de votre dépôt (chapitre 11)............. 182 Créer une sauvegarde incrémentale de votre dépôt (chapitre 11).......... 182 ANNEXE B Ressources... 183 Ressources en ligne............................................... 183 Le site web de Subversion....................................... 183 Pragmatic Programmer........................................ 184 Subversion Book............................................. 184 Better SCM................................................. 184 CM Crossroads.............................................. 184 Index... 185