> Le Site du Zéro - Informatique

> Cours

> Tutoriels

> Programmation

> IDE

> Gérez vos projets à l'aide du gestionnaire de versions Subversion

> Les bases - Utilisations des clients

> Premier pas !

> Lecture du tutoriel

Premier pas !

L'auteur de ce cours cherche un repreneur pour continuer son travail
Parfois, certains auteurs de cours n'ont plus le temps de rédiger et de mettre à jour leur travail. Ils recherchent alors un nouvel auteur pour "reprendre" leur tutoriel (voir la liste des tutoriels en attente de repreneur).
Contactez l'auteur si vous aimeriez continuer la rédaction !

Par

Dalshim

Mise à jour : 02/05/2009

1 845 visites depuis 7 jours, dont 340 sur ce chapitre classé 74/786

Voilà : plutôt que de faire une introduction longue et chi..., passons tout de suite à la pratique.
Dans cette partie nous allons voir comment récupérer les fichiers du serveur, avec et sans contrôle de version, comment mettre à jour ces fichiers et envoyer les modifications au serveur.

Retour en haut

Sommaire du chapitre :

Récupération des données
Exporter les données
Des update...
... et des commit

Retour en haut

Récupération des données

Avant de pouvoir récupérer des données, encore faut-il avoir un serveur avec des données. C'est pour cela que, rassurez-vous, j'ai préparé un petit serveur rien que pour les Zéros avec des fichiers dedans.
J'y ai mis quelques données pour le principe (qui ne servent à rien, vous allez le voir).

Et est-ce que l'on peut faire des trucs sur l'espace ?

Il n'y a pas de problème, vous pouvez tout chambouler, vous verrez qu'il n'y a rien d'important dedans. Sinon je vous aurais laissé en lecture seule.

Voilà, on a donc notre espace de données.

Je tiens à vous rassurer tout de suite : un mini-tuto viendra en annexe pour apprendre à créer son propre espace sur le web. Certains sites offrent ça gratuitement. Personnellement, j'ai créé l'espace pour le SdZ avec www.assembla.com !

Maintenant, allons-y pas à pas.

Dès à présent, vous pouvez créer un dossier sur votre ordinateur dans lequel seront stockés les répertoires (repository) SVN. Pour Windows, ce n'est pas pareil que pour UNIX.

Sous Windows

Créez un dossier dans lequel vous allez recevoir toutes les données du repository (répertoire SVN sur le serveur).
Pour UNIX, le dossier sera créé automatiquement !

Pour Windows, une fois que vous avez créé votre dossier, il vous suffit de faire un clic droit dessus et de cliquer sur Checkout dans le menu.
Une fois sur la fenêtre de Checkout, entrez l'URL suivante à l'endroit indiqué : http://svn.assembla.com/svn/Tuto-SdZ
Et là, quand vous validez, il vous sera demandé un login et un mot de passe :
login = SdZ-Guest
mdp = MySdZsvn

Avant de commencer à faire des bêtises sur le SVN, sachez que l'espace est limité à 500 Mo, et que toutes les versions sont sauvegardées. Certes, elles sont compressées sur le serveur, mais ça ne fait pas beaucoup quand même. Donc je vous fais confiance pour ne pas faire transiter d'énormes fichiers (programmes, images, vidéos ou autre) via le SVN. S'il y en a trop, je le fermerai, mais je ne vois pas pourquoi ça arriverait.

Une fois le login et le mot de passe renseignés, vous verrez la fenêtre de téléchargement vous mettre tous les fichiers dans votre répertoire local. Ensuite, vous pourrez aller voir les fichiers que vous venez de récupérer (on verra après comment faire pour les modifications).

Sous UNIX maintenant

Placez-vous dans le répertoire dans lequel vous voulez ajouter le repository à l'aide du terminal.

Rappel pour utiliser le terminal : cd permet de changer de dossier et ls de consulter les fichiers et dossiers présents dans le dossier courant.

Une fois dans le bon répertoire, vous lancez la commande suivante :
Code : Bash

1	svn checkout --username "SdZ-Guest" --password "MySdZsvn" "http://svn.assembla.com/svn/Tuto-SdZ"

sachant que l'on peut remplacer checkout par le raccourci co (c'est plus rapide). Ce qui donne :
Code : Bash

1	svn co --username "SdZ-Guest" --password "MySdZsvn" "http://svn.assembla.com/svn/Tuto-SdZ"

Comprenons ce qui se passe

Lors d'un checkout , que l'on peut assimiler aux termes "to check it out" (vérifier), on récupère les données pour les vérifier. Il signifie également "passer à la caisse" ; en gros, il représente la récupération / extraction des données.
Dans le langage informatique et celui du contrôle de version, on obtient les définitions suivantes.

repository :
dépôt de logiciels : un répertoire dans lequel Subversion stocke les informations nécessaires au contrôle des versions d'une série de projets.
Checkout :
opération d'extraction d'une version d'un projet du repository vers un répertoire de travail local.

On demande donc ici au serveur de nous envoyer tous les documents sous contrôle de version, dans la dernière version qu'il possède (serveur et repository sont renseignés dans l'URL). Comme l'accès est restreint, on précise le login et le mot de passe d'un compte ayant les droits.
Il est possible de renseigner d'autres options comme on peut le voir sur l'IHM de TortoiseSVN. Nous verrons ces options plus tard. De même, il est possible de ne pas renseigner les identifiants de connexion directement dans la ligne de commande. S'ils ne sont pas renseignés, ils seront demandés par la suite avant de télécharger les fichiers.

Pour ceux qui aiment comprendre comment fonctionne un outil...
Maintenant que nous avons téléchargé ce qui se trouve dans le repository, regardons ce que l'on peut trouver dans ces dossiers.
Bien sûr, on va trouver les données que l'on voulait télécharger. Mais si on regarde un peu plus loin (en activant l'affichage des fichiers et dossiers cachés pour Windows, ou que l'on fait des ls -a , a pour all, sous le terminal avec UNIX), on constate qu'en plus de tous les fichiers standards, on peut trouver dans chaque dossier du repository un autre dossier caché ".svn". Ce dossier sert à Subversion pour justement effectuer le contrôle de version sur les fichiers et dossiers. Il y aura sûrement une annexe sur le fonctionnement de SVN. Mais pour l'instant (et même après), on ne touche pas à ce dossier.

Maintenant, pour les utilisateurs de Windows (parfois aussi pour Mac et Linux, si vous avez certains clients installés), si vous regardez vos dossiers et fichiers en mode graphique (pas via le terminal), vous constatez Ô MIRACLE, que de superbes symboles (icônes superposées) se sont rajoutés sur tous vos fichiers et dossiers sous contrôle de version.

L'icône superposée verte signifie que vous n'avez pas modifié le fichier depuis que vous l'avez récupéré sur le serveur (ce qui ne veut pas dire qu'il n'y a pas de version plus à jour sur le serveur). Sur un dossier, cela signifie qu'aucun fichier dans le dossier n'a été modifié depuis la récupération sur le serveur.

(J'ai mis un screenshot des icônes sur mon Mac pour montrer qu'elles existent aussi.)

Si l'on regarde les screenshots que j'ai faits, on voit qu'il y a d'autres icônes. Si l'on va sur le site de TortoiseSVN, on trouve la signification de toutes ces icônes.

(Cette fois-ci, c'est la version TortoiseSVN pour Windows.)

Je préciserai la signification de chaque icône au moment voulu dans la suite du tuto.

Retour en haut

Exporter les données

Comme on vient de le voir, le contrôle de version ajoute des dossiers / données dans le répertoire local. Seulement, quand on a fini un projet, on ne veut pas forcément que ces petites icônes superposées restent sur les dossiers, ni que les dossiers cachés restent. Pour cela, il existe la fonction d'export, qui, contrairement au checkout, ne va faire que récupérer les données sans appliquer le contrôle de version.

Comme je disais, une fonction d'export, qui s'appelle brillamment... export. :waw:

Eh oui c'est sacrément compliqué SVN, pas vrai ?

Puisque je parle du nom de la commande, montrons tout de suite comment la lancer sous UNIX :
Code : Console

svn export --username "SdZ-Guest" --password "MySdZsvn" "http://svn.assembla.com/svn/Tuto-SdZ"

Bien sûr, je montre l'exemple précis pour l'espace SdZ que j'ai créé ; à partir de maintenant, je montrerai les commandes de manière générique :
Code : Console

svn export --username "login" --password "mot_de_passe" "URL_du_Repository"

On retrouve les mêmes options que pour le checkout : ce n'est pas étonnant étant donné que l'on demande la même chose (enfin presque) au serveur.

C'est pareil pour Windows, en dehors du fait que l'on doit cliquer sur Export et non sur Checkout, la fenêtre de dialogue reste la même que celle du checkout.

Vous pouvez maintenant vérifier dans les dossiers exportés, vous ne trouverez pas de dossiers ni de fichiers en plus des fichiers de données.

Retour en haut

Des update...

Bien sûr, s'il y a plusieurs personnes à utiliser le même serveur (à travailler sur le même projet), il semble évident qu'il faut un moyen pour récupérer les données qui auraient été modifiées par certains. Avant de commencer à travailler sur un fichier, il faut systématiquement mettre à jour le fichier sur lequel on veut travailler, juste avant de travailler dessus (pour être sûr de ne pas commencer sur une version obsolète). Or une mise à jour, en anglais, on appelle ça un update. Nous avons donc notre nouvelle commande : update.

Ce n'est pas parce que l'on a une très belle icône superposée verte qui indique que les fichiers sont "normaux" que les fichiers sont à jour. Ça veut seulement dire que vous ne les avez pas modifiés depuis que vous les avez récupérés sur le serveur !

Pour UNIX

Il faut se placer dans le dossier que l'on veut updater (mettre à jour), puis pour updater tout le projet se mettre sur le dossier racine, et on lance la commande suivante :
Code : Console

svn update [dossier_à_updater]

Ouh là, c'est compliqué !
Ceci dit, il se peut que vous rencontriez certains problèmes. S'il n'est pas nécessaire de renseigner le login / mdp, contrairement au checkout, c'est tout simplement que le login / mot de passe est retenu lors du checkout. Il est possible de ne pas le faire mémoriser à l'aide d'une option, mais on verra toutes les options des différentes commandes plus tard (on va déjà apprendre la base). Bref, si jamais vous avez besoin de renseigner votre login / mdp, on vous le fera savoir et il vous sera demandé de les écrire avant de télécharger les fichiers à jour. Sinon vous pouvez utiliser les mêmes options que pour le checkout (--username et --password).
Si vous ne renseignez pas le dossier_à_updater, il prendra par défaut le dossier courant (comme pour chaque commande agissant sur un dossier).

Voilà, il n'y a pas besoin d'en savoir plus pour l'instant.

Pour Windows

Là non plus, ça ne va pas être compliqué. Il suffit de faire un clic droit sur le dossier que l'on veut updater et de cliquer sur SVN update. Ni plus ni moins.
Je ne vous fais pas de screenshot, c'est vraiment trop facile.

Retour en haut

... et des commit

Une fois que l'on a récupéré les données avec le contrôle de version (à l'aide d'un checkout), on veut pouvoir les modifier et renvoyer les fichiers au serveur. Pour cette action, on parle de commit (vous me verrez ensuite souvent parler de commiter pour dire que je vais faire un commit).
Si l'on va chercher la définition de to commit, on obtient (entre autres) : "To put into a place to be kept safe or to be disposed of" et "To consign for future use or reference or for preservation" .
En gros, mettre dans un espace pour le garder en sécurité et le mettre à disposition pour une utilisation future.

Donc, pour nous, ça va vouloir dire la chose suivante :
commit permet d'envoyer au serveur la nouvelle version des fichiers que l'on a modifiés depuis leur dernière récupération sur le serveur.

Pour tester, rien de plus simple.
Vous venez de récupérer les fichiers à l'aide d'un checkout, a priori vous avez donc la dernière version (si vous avez fait le checkout il y a longtemps, utilisez la commande update pour mettre vos fichiers à jour).

Vous prenez un fichier au hasard (enfin, qui fasse quand même partie des fichiers sous contrôle de version

) et vous le modifiez (ajoutez une phrase au début, comme ça vous vous repèrerez facilement). Ensuite, vous sauvegardez et revenez sur l'explorateur de documents.

On constate que l'icône comporte maintenant un "!" rouge :

Cela signifie que le fichier a été modifié et que vous possédez une version du fichier que le serveur n'a pas. Mais si l'on revient au dossier parent (contenant le fichier modifié), on constate qu'il possède cette icône rouge aussi : ça veut dire que le contenu du dossier (au moins un fichier) n'est pas le même que celui situé sur le serveur.
Il faut donc lui envoyer les modifications que l'on a apportées.

Pour Windows

Clic droit sur le fichier ou sur n'importe quel dossier parent (faisant partie des dossiers sous contrôle de version) du fichier.

Dans mon cas, j'ai cliqué sur le dossier racine. On voit dans la fenêtre que je peux laisser un message, et que le fichier modifié apparaît dans une liste où l'on peut le décocher.
Les commentaires pourront ensuite être lus par les autres membres du groupe de travail lorsqu'ils récupèreront les fichiers du serveur.

Les commentaires

Ces commentaires sont très utiles, et je vous encourage très vivement à en laisser un pour que le suivant qui récupère les données, d'un simple coup d'oeil sur les commentaires laissés, puisse savoir ce qui a été fait sur les fichiers.

Exemple de commentaire utile :

Correction orthographique du compte rendu final.

Exemple de commentaire débile :

J'ai modifié le compte rendu final.

Pourquoi n'est-il pas utile de spécifier quels fichiers ont été modifiés ?

Tout simplement parce que lors du téléchargement des fichiers sur le serveur, on sait quels fichiers ont été modifiés / créés / supprimés. Lorsque l'on va sur la fenêtre des logs, le nom de la personne, le numéro de version lors de son commit ainsi que les fichiers qu'il a créés / modifiés / supprimés sont affichés automatiquement, le commentaire est là pour ajouter une information en plus sur ce que l'on a fait à ces fichiers.
Il est donc complètement inutile d'ajouter dans son commentaire ce que la personne peut lire plus clairement et plus rapidement sur la fenêtre.

La liste des fichiers modifiés

Lorsque l'on clique sur un dossier pour faire un commit, la fenêtre propose de commiter tous les fichiers contenus dans ce dossier et qui ont été modifiés. Si l'on ne veut pas envoyer l'un de ces fichiers au serveur, il suffit de le décocher.

Si vous avez ajouté manuellement des fichiers (non versionnés) dans le dossier (versionné), la fenêtre affichera ces fichiers non versionnés, mais décochés par défaut pour ne pas les envoyer au serveur. Si vous les cochez, il les enverra au serveur comme nouveau fichier à prendre en compte dans le contrôle de version. Le prochain chapitre expliquera les différentes façons d'ajouter un fichier.

Si l'on clique sur un fichier, la fenêtre ne proposera que d'envoyer le fichier en question (s'il a été modifié). Pour être sûr d'envoyer toutes les modifications d'un seul coup, il suffit de faire un commit sur le dossier racine, il prendra au moins toutes les modifications en compte.

Pour UNIX

Eh bien pour vous, c'est pareil. Il faut se mettre dans le dossier voulu (celui dans lequel il y a quelque chose à commiter ou un parent). Idéalement le dossier racine, et ensuite on lance la commande suivante :
Code : Console

svn commit fichier_ou_dossier_à_commiter -m "mon_commentaire"

On peut remplacer commit par ci, ce qui nous donne :
Code : Console

svn ci fichier_ou_dossier_à_commiter -m "mon commentaire"

-m indique que l'argument suivant est le message à mettre dans le log (journal).

Le -m "mon_commentaire" n'est, normalement, pas obligatoire. Il arrive parfois que le commit échoue parce que vous n'avez pas mis de commentaire. Vous obtiendrez un message d'erreur stipulant que SVN ne trouve pas d'éditeur externe pour obtenir le message de log. Si c'est le cas, pour passer à travers cette erreur, même si vous ne mettez pas de commentaire, mettez -m "".

On retrouve les mêmes options que pour Windows à quelques petits détails près. Les fichiers ajoutés manuellement dans le dossier à commiter et qui ne sont pas sous contrôle de version NE seront PAS envoyés au serveur.

L'argument fichier_ou_dossier_à_commiter n'est pas obligatoire. Si l'on ne met rien, il prendra par défaut le dossier courant. En revanche, on peut aussi donner un nom de fichier pour ne commiter que le fichier.

Retour en haut

Voilà : maintenant vous avez un peu mieux compris comment ça marche. Au prochain chapitre, on accélère le mouvement.

Retour en haut

Retour en haut

19 commentaires pour "Premier pas !"

Note moyenne : 3.46 / 4 (26 votes)

Pseudo	Commentaire
bestpv	# Posté le 10/03/2010 à 23:49:49
Vive le triple boot ! Ville : Etampes Pays : France métropolitaine Études : BTS IG Évry	Tout d'abord merci pour ce tuto, j'ai enfin cerné Subversion. Je peux maintenant avancé un projet de n'importe quel ordi et de n'importe où ! J'ai tout de même une petite question : Comment avoir les "symboles" sur les icônes des dossiers et fichiers sous Mac Os ? J'ai installé 2-3 clients svn et j'ai bien les symboles sur les icônes mais que dans le logiciel pas dans le Finder comme sur le sceenshot du tuto
gg++	# Posté le 05/05/2010 à 14:31:22
Ca gère la fougère	J'ai bien fait ce que tu as dit mais je n'ai pas les icons à coté des fichiers !
Jokyjo	# Posté le 19/07/2010 à 19:00:08
Blog Twitter close Études : EFREI	Idem, tu parles de "certains clients", tu sais ce ça peut se faire, où tu connais les paquets ? Seul point gris à un super tuto sinon
Dalshim	# Posté le 20/07/2010 à 22:29:38
Blog Twitter close Ville : Paris Pays : France métropolitaine Études : INSA Lyon	Pour les icones sous Windows, c'est TortoiseSVN. Pour les icones sous mac, ça semble être le SVNPlugin. Si ce n'est pas ça, je ne sais pas ce que c'est. Maintenant, toute personne pouvant me le confirmer ou donner la réponse est la bienvenue. Je l'intègrerai ensuite au tuto. Apprenez à utiliser SVN Bien fermer ses threads en Java
daspzero	# Posté le 14/10/2011 à 10:13:07
	Je suis peut être un peu hors sujet mais dans la section "Premier pas !" il n'est plus possible d'accéder au site (checkout => svn checkout --username "SdZ-Guest" --password "MySdZsvn" "http://svn.assembla.com/svn/Tuto-SdZ"). Est ce que quelqu'un connait un moyen de faire quelques exemple sur un autre site?