La Bnbox !

Créateur de sourires...

Mon compte

S'inscrire

Recherche

Vous êtes ici : Accueil » Atelier Webmaster » Tutoriel SVN » Comment gérer SVN de manière simple

Atelier Webmaster



Sommaire du cours

Tutoriel SVN : Comment gérer SVN de manière simple


Prendre les fichiers du dépôt


Avant de faire n'importe quelle commande, il faut prendre la version courante du projet qui est stockée sur le serveur via SVN :
Code :
svn checkout svn://adresse_du_svn.fr

Cette commande va chercher tous les fichiers à l'adresse adresse_du_svn.fr (que vous avez préalablement remplacé par votre propre url) et les placent dans le dossier courant de votre poste de travail (d'où l'utilité de créer un dossier de travail : tous les fichiers seront dans ce dossier) et seront « sous contrôle SVN ».
Comment ça, qu'est-ce que ça veut dire ? Attendez, laissez moi le temps de m'expliquer un peu ! Lisez un peu plus...
SVN a donc maintenant téléchargé (ça reste légal hein !)  les fichiers du serveur en local et en même temps, il a indexé les fichiers qu'il a téléchargé. C'est à dire que SVN se souvient des fichiers présents sur le serveur (et heureusement !) et que vous ne devez (surtout) pas les déplacer via vos explorateurs de fichiers ou via les commandes cp et mv. On verra comment les déplacer dans les sections un peu plus loin.
       
Mais attention ! Ne faites ça qu'une fois ! Pour la suite, vous n'aurez pas à refaire cette manip', il vous suffira de vous placer dans votre dossier de travail et de taper cette commande :
Code :
svn update // met à jour la version locale en se basant sur la dernière version du serveur

Si tout se passe bien (c'est à dire si vous n'avez pas modifier localement les fichiers qui ont changé sur le serveur), vous aurez mis à jour les fichiers sur votre ordi.
Pour remettre à jour vos fichiers (et vous feriez mieux de le faire souvent), vous taperez dorénavant cette commande.

Mettre à jour un fichier


Vous pouvez maintenant jouer avec vos fichiers sur votre machine. Une fois qu'un fichier quelconque que nous appellerons « fichier_x » a été modifié, vous voudrez sans doute que le reste de votre groupe de travail puisse voir son excellence. Pour cela, vous allez utiliser la commande :
Code :
svn commit [fichier_x] -m "Raison du commit" // si fichier_x n'est pas présent, alors tous les fichiers qui ont été modifiés vont être mis sur le serveur

Et ce fichier sera mis à jour sur le serveur (à supposer que ce dit fichier n'ait pas été modifié par quelqu'un d'autre, mais ça, on le verra dans le chapitre 2). La commande suivante met à jour tous les fichiers modifiés par vos soins :
Code :
svn commit -m "Raison du commit"

Vous l'avez deviné, la chaine "Raison du commit" est à remplacer par la raison qui vous a poussé à modifier fichier_x ou les autres fichiers.

Si vous avez fait la commande présentée en introduction avec l'export de SVN_EDITOR, ou si vous aviez déjà un programme associé à SVN_EDITOR, l'option -m \"Raison du commit\" est superflue et vim va s'ouvrir. Pour l'utilisation de vim, je vous laisse vous débrouiller, il y a une foultitude d'aide sur internet.


À partir de maintenant, je vais considérer que la variable d'environnement SVN_EDITOR est correctement configurée, je ne mettrai donc plus -m \"Raison du commit\" qui flood plus qu'autre chose.

Ajouter un fichier


Si vous avez bien suivi, et je suis sur que vous avez bien lu tout ce que j'ai écrit avant, vous ne savez pas encore rajouter un fichier (reprenons fichier_x !) sur le serveur géré par SVN. Qu'à celà ne tienne, il suffit d'enchaîner deux commandes pour le faire :
Code :
svn add fichier_x // dit à svn d'indexer fichier_x sur le dépôt local
svn commit fichier_x // exporte le fichier sur le serveur

Et voilà, vous savez comment gérer les versions de fichier avec SVN mini_bn

Déplacer, renommer, créer des fichiers/dossiers


Maintenant que vous savez mettre à jour un fichier, il serait bon que vous sachiez aussi comment organiser un minimum votre dépôt en le fragmentant en différents dossiers, puis à bouger tel ou tel fichier dans tel ou tel dossier.
Pour celà, comme svn indexe les différents fichiers et dossiers (et que vous ne devez surtout pas toucher à ces derniers via un explorateur de fichiers ou via les commandes cp et mv), vous devez les déplacer, renommer ou créer via svn pour qu'il puisse ré-indexer ces fichiers/dossiers.
SVN met à votre disposition les commandes suivantes :
Code :
svn mkdir toto // créé un dossier nommé toto dans le répertoire courant
svn mv fichier dest // déplace fichier vers le répertoire dest

La dernière ligne de commande renomme fichier si dest n'est pas un nom de répertoire, mais un autre nom de fichier (ou un répertoire qui n'existe pas). C'est aussi pourquoi il faut faire attention puisque si le nouveau nom de fichier est un fichier existant déjà, ce dernier sera remplacé, sans récupération possible en local.
Lorsque je parle ici de fichier, vous pouvez aussi déplacer/renommer un dossier de la même manière. Il y a de plus une autre manière de renommer un fichier :
Code :
svn rename lulu albert // renomme lulu en albert (le changement de sexe, tout ça...)



À partir d'ici, les commandes s'utilisent plus rarement, soit parce que le cas d'utilisation de la commande est plus rare, soit parce qu'il existe d'autres moyens de faire la commande, des moyens que vous utilisiez avant.

Déconnexion pendant le traitement d'une commande ?


Et oui, ça peut arriver ! La situation : Vous faites un svn update, mais comme toute connexion à internet a ses défauts, paf ! Votre connexion plante, ou votre frangin(e) joue trop à WoW et a bouffé toute la bande passante, ce qui a entrainé un minicrash de SVN.
Heureusement, SVN a une commande pour tout réparer (parce que oui, quand une synchronisation est en cours et que le serveur et votre ordi ne se synchronisent pas complètement, c'est bel et bien cassé) :
Code :
svn cleanup

Elle est bien sûr à effectuer lorsque vous avez repris votre connexion. Si par malheur votre commande n'arrive toujours pas à son terme, il vous ait toujours possible de refaire cette commande et ce autant de fois que vous voulez ! (Ou bien vous changez de connexion, ou encore vous tuer votre frangin(e)).

Voir l'historique


Et oui, ça peut être utile pour voir qui a fait quoi à quel moment, qui a fait de la *bip*, qui a super bien fait de faire ça.
Code :
svn log [fichier_x] // avec fichier_x, seulement l'historique de fichier_x est affiché, et sans, tout l'historique est affiché

Et là, vous avez plein de lignes qui s'affichent, c'est la folie, vous avez la flemme de les lire... Mais non ! On va les regarder ensemble ces lignes. Tout d'abord, vous remarquez que c'est souvent le même type de ligne qui apparait.
Comment ça non ? M'enfin regardez, des tirets - qui reviennent en bande ! Ceux-ci servent à délimiter les versions de mise à jour. En effet, pour chaque commit qu'un utilisateur fait, la version courante (la première étant r1 pour révision 1) est incrémentée de 1 (on obtient donc r2, r3, ...).

Tiens, j'en vois un lever la main ! Oui, t'as l'oeil toi, ce sont les « numéros » qui sont affichés au début d'une ligne, celle qui suit immédiatement une ligne pleine de tirets -. Restons sur cette ligne, il n'y a quand même pas que ça d'intéressant dessus. Les | servent à séparer les différentes informations de la ligne. On remarque que la ligne commence par le « numéro » de version, puis il y a le nom d'utilisateur qui a fait le commit, ensuite vient la date du commit et enfin on a le nombre de lignes de commentaire laissé par l'utilisateur en question.
Et oui monsieur oeil-de-lynx, c'est bien le commentaire en question qui vient dans la prochaine ligne !

Bien, vous savez maintenant lire les logs (ou historique) de SVN.

Voir un fichier/dossier via SVN


Pour finir ce chapitre, il reste une commande qui n'est pas forcément utile, mais dont vous pourriez avoir besoin un jour :
Code :
svn cat fichier_x // affiche le contenu du fichier nommé fichier_x
svn ls dossier_x // affiche la liste des fichiers du dossier nommé dossier_x


svn cat fichier_x | less permet de mettre la sortie de la commande SVN dans less, très utile lorsque le fichier est long.


Ailleurs sur la Bnbox

Ailleurs sur la Toile

Mini-tchat

?

qsdfghjklm* chuchote : Resume du livre naissance du fa Hier, 17h43 via Recherche

yo proclame : Yo yo Le 17 février, 20h54 via Résumé - Le Médecin Malgrè ...

eva scribouille : Qu el qu un a un resume sur le voyage de mr perrichon ? Le 11 février, 18h38 via Fiches sur les personnages ...

evalol déclare : 1a2z Le 11 février, 18h36 via Résumé - Les Fourberies De ...

sysy s'exclame : Quelqun a un resume des evenements importants ds bel ami? Le 11 février, 1h38 via Fiches sur les personnages ...

jojolerigolo tergiverse : Qui est a Léon Blum Le 10 février, 18h00 via Politique d'accessibilité

tom s'exclame : Bonjour Le 09 février, 13h39 via Résumé scène par scène - Le...

dams chuchote : Et dams lithopedion Le 02 février, 11h08 via Résumé scène par scène - Le...

dams écrit : Qui et votre rapeure prefere ou chanteure moi DAMSO DAMSO DAMSO DAMSO DAMSO c'est cqfd !! Le 02 février, 11h07 via Résumé scène par scène - Le...

dams dit : Bonjour Le 02 février, 11h05 via Résumé scène par scène - Le...

dams déclame : Elle et bien mais c'est notre prof de francais quoi qui nous demande de la faire Le 02 février, 11h05 via Résumé scène par scène - Le...

Laura.lly gribouille : BONJOUR Le 01 février, 21h00 via Résumé scène par scène - Le...

juliaaaaaa griffonne : HEYYYY!!Vous allez bien? Le 31 janvier, 18h47 via Résumé scène par scène - Le...

maelys griffonne : Le cid en soit n est pas si mal c'est juste qu il est compliqué a comprendre j ai un oral a faire devant toute ma classe et j ai a peux pres compris Le 31 janvier, 16h11 via Résumé scène par scène - Le...

leane écrit : Et le je travail sur le cid je comprend rien sa me soule Le 30 janvier, 14h51 via Résumé scène par scène - Le...

leane dit : Moi jai fait les fourberie de scapin lannee derniere quand jetais en 5eme Le 30 janvier, 14h51 via Résumé scène par scène - Le...

Charlienette déclare : Nan .. je hurle la Le 30 janvier, 9h58 via Résumé - Les Fourberies De ...

Charlienette chuchote : Je murmure pas ! Le 30 janvier, 9h58 via Résumé - Les Fourberies De ...

Charlienette murmure : JE l'ai demain Le 30 janvier, 9h58 via Résumé - Les Fourberies De ...

Charlienette griffonne : Vous avez déjà fait un cibtrole sur les fourberies de scapin acte 2 ? Le 30 janvier, 9h58 via Résumé - Les Fourberies De ...

Charlienette déclame : Coucou Le 30 janvier, 9h57 via Résumé - Les Fourberies De ...

lkjhgfds chuchote : Coucou Le 28 janvier, 20h43 via Résumé - Le Médecin Malgrè ...

kikoudu73 écrit : Octogone Le 28 janvier, 14h30 via Fiches sur les personnages ...

kikoudu73 tergiverse : Avec ta region perdue Le 28 janvier, 14h29 via Fiches sur les personnages ...

bobby dit : Mairci bocou se cour de francé ma biain édé.2 + javé pa lu le livreu Le 28 janvier, 13h12 via Fiches sur les personnages ...

hghyfrfde scribouille : Lkjugtrdf Le 27 janvier, 12h16 via Résumé - Les Fourberies De ...

youyou déclare : Champs requis Le 06 janvier, 20h33 via Français

Samantha déclare : C'est tres simple Le 06 janvier, 17h51 via Résumé scène par scène - Le...

Samantha dit : CC Le 06 janvier, 17h51 via Résumé scène par scène - Le...

bande de ouff déclare : Ou vous étè vivant Le 06 janvier, 16h38 via Résumé : Le Tartuffe de Mol...

bande de ouff chuchote : Yo bande de ouff Le 06 janvier, 16h35 via Résumé : Le Tartuffe de Mol...

LE BG griffonne : HELLO MA MAN Le 04 janvier, 7h18 via Résumé scène par scène - Le...

. gribouille : ; Le 02 janvier, 19h37 via Résumé : Le Mariage de Figa...

loo griffonne : Looo Le 02 janvier, 19h18 via Les avantages et les risque...

aaaaa murmure : Cacas Le 02 janvier, 13h25 via Les avantages et les risque...

lu proclame : Que tal? Le 01 janvier, 17h06 via Les avantages et les risque...

lu écrit : Hey Le 01 janvier, 17h06 via Les avantages et les risque...

ribou proclame : Coucou Le 30 décembre 2018, 11h52 via Fiches sur les personnages ...

aziz proclame : Toutoutoutou Le 28 décembre 2018, 15h30 via Comment fonctionne le mini-...

aziz chuchote : Waw made in china Le 28 décembre 2018, 15h29 via Comment fonctionne le mini-...

aziz murmure : Je suis hiybjgujh Le 28 décembre 2018, 15h29 via Résumé - La Chèvre De M. Se...

Moi s'exclame : Nb k Le 18 décembre 2018, 23h12 via Résumé scène par scène - Le...

yuiooyo tergiverse : Jouon ensemble Le 17 décembre 2018, 21h19 via Résumé scène par scène - Le...

Tom déclare : Ça va Le 17 décembre 2018, 10h25 via Résumé - Les Fourberies De ...

Carla proclame : Caca Le 17 décembre 2018, 10h22 via Résumé - Les Fourberies De ...

Moi écrit : Génial ? Le 17 décembre 2018, 10h21 via Résumé - Les Fourberies De ...

yi déclare : Ipmuo Le 16 décembre 2018, 17h45 via Résumé scène par scène - Le...

Moi chuchote : Bvvgvv Le 16 décembre 2018, 15h22 via Résumé scène par scène - Le...

Moi tergiverse : Bbcgd Le 16 décembre 2018, 15h22 via Résumé scène par scène - Le...

)à)ào$ bafouille : Jiojiij Le 16 décembre 2018, 13h22 via Résumé scène par scène - Le...

Publicité



©Bnbox (Infos) - Cahier de l'élèves - Atelier webmaster - Boîte à Nuts - Bar à Nougat - Plus ou moins valide XHTML 1.0, CSS 2, RSS 2.0
Flux RSS