Prendre un Café - Tag - subversion

Eclipse PDT, Subclipse et Subversion 1.5.2 sont dans un bateau

NiKo — Mon, 22 Sep 2008 12:02:00 +0200

Le package complet pour la version stable d’Eclipse PDT fournit Subclipse^[1] en version 1.2 par défaut.

Cette version de Subclipse est incapable de gérer la dernière version du client Subversion, la 1.5.2. La moindre tentative d’update devrait vous afficher ce message laconique : The version of this client is too old^[2].

Et bien entendu, il est au premier abord impossible de désinstaller le plugin Subclipse en version 1.2 fournit par PDT.

Aussi, voici l’astuce permettant de mettre à jour votre version de Subclipse au sein de votre environnement Exclipse/PDT :

Dans le menu Software updates, choisissez Manage configuration
Dépliez l’arborescence des dépendances pour le module PDT, et sélectionnez Subclipse
Cliquez sur Disable, puis relancez Eclipse
Dans Software Updates, choisissez Find and Install et ajoutez un nouveau dépôt distant^[3], et renseignez le comme ci-dessous :
- Name : Subclipse 1.4.x
- URL : http://subclipse.tigris.org/update_1.4.x
Sélectionnez ce dépôt, puis lancer la recherche de packages
Sélectionnez les modules Subclipse et SVNKit
Redémarrez Eclipse

Après ces manipulations, vos devriez retrouver vos fonctionnalités préférées.

Notes

[1] Subclipse est un plugin intégrant Subversion à Eclipse

[2] Et c’est pas la première fois que ça arrive…

[3] Chez Eclipse, on appelle ça un Update site

Ce billet intitulé Eclipse PDT, Subclipse et Subversion 1.5.2 sont dans un bateau a été rédigé par Nicolas Perriault et publié sur le blog Prendre un Café sous licence Creative Commons BY-NC-SA.

Une version récente de Subversion sous Mac OS X

NiKo — Mon, 29 Oct 2007 10:18:00 +0100

Utilisateurs d'Eclipse et de Subclipse, vous avez peut-être déjà pesté devant l'incompatibilité de version qui existe avec celle disponible en ligne de commande sous Mac OS X (via MacPorts, Fink, etc.)

Généralement, vous vous prenez un message d'erreur du style :

The version of this client is too old.

Pour régler le problème, vous pouvez installer le package Subversion de Martin Ott en version 1.4.4.

Ce billet intitulé Une version récente de Subversion sous Mac OS X a été rédigé par Nicolas Perriault et publié sur le blog Prendre un Café sous licence Creative Commons BY-NC-SA.

Créer un projet Symfony à partir des dépôts Subversion sous Ubuntu

NiKo — Wed, 07 Feb 2007 08:02:00 +0100

Un des gros avantages du framework Symfony, c'est qu'il est régulièrement mis à jour. En ce sens, l'utilisation de liaisons externes Subversion permet de s'affranchir des opérations récurrentes de mise à jour manuelles du code du framework.

Seul prérequis pour mettre en oeuvre la technique décrite ci-après, avoir accès à un dépôt Subversion pour y stocker son propre projet personnel.

Voyons donc comment créer un projet Symfony from scratch à partir des sources du dépôt officiel, sous Ubuntu par exemple...

Conventions

Nous admettrons que nous avons mis en place un dépôt Subversion et que celui-ci est accessible à l'URL http://trac.mondomaine.tld/svn/monprojet.

Création du projet subversion

$ mkdir monprojet  && cd monprojet

On versionne notre projet nouvellement créé dans Subversion et on en fait un checkout en suivant :

$ echo "Mon projet README" > README
$ svn import -m "Initial import" . http://trac.mondomaine.tld/svn/monprojet
$ rm README && svn co http://trac.mondomaine.tld/svn/monprojet .

Liaison des sources de Symfony

On récupère le contenu intégral du trunk de Symfony dans un répertoire virtuel vendor/symfony, grâce à un svn:externals :

$ mkdir vendor && svn add vendor
$ svn propset svn:externals "symfony http://svn.symfony-project.com/trunk/" vendor

On commite :

$ svn commit -m "Added svn:externals to sf trunk in vendor/" vendor/

On oublie pas d'updater :

$ svn up

L'intégralité du trunk de Symfony est alors téléchargé en local (cela peut prendre un peu de temps).

Création du projet Symfony

Pour bien utiliser les capacités de Subversion par la suite, on créé un répertoire trunk dans lequel nous allons initialiser notre projet Symfony :

$ mkdir trunk && cd trunk
$ ../vendor/symfony/data/bin/symfony init-project monprojet

De même, on crée en même temps les traditionnels répertoires branches et tags :

$ cd ..
$ mkdir branches tags

Pour l'heure, un ls -l nous donne à la racine du projet subversion :

$ ls -l
total 20
drwxr-xr-x  2 niko niko 4096 2007-02-07 17:02 branches
-rw-r--r--  1 niko niko   95 2007-02-07 16:47 README
drwxr-xr-x  2 niko niko 4096 2007-02-07 17:02 tags
drwxr-xr-x 13 niko niko 4096 2007-02-07 16:59 trunk
drwxr-xr-x  4 niko niko 4096 2007-02-07 16:56 vendor

Configuration du projet Symfony

Il faut maintenant configurer le projet Symfony pour qu'il sâche trouver les librairies de base que nous avons précédemment récupéré - et surtout que le projet soit portable -, en éditant le fichier trunk/config/config.php :

$sf_symfony_lib_dir  = dirname(__FILE__).'/../../vendor/symfony/lib';
$sf_symfony_data_dir = dirname(__FILE__).'/../../vendor/symfony/data';

On teste l'installation en lançant la commande ./symfony -T depuis la racine du projet Symfony :

$ cd trunk
$ ./symfony -T

Si ça marche, on ajoute tout ce qui est nouveau fichier, et on commite en suivant :

$ cd ..
$ svn stat | grep ? | awk '{ print $2 }' | xargs svn add
$ svn commit -m "File structure created, sf project initialized" .

On pourra également faire un lien symbolique vers le répertoire web/sf, ou bien le définir en tant qu'alias dans le vhost apache :

<VirtualHost toto.monprojet.tld>
  (...)
  alias /sf /path/to/vendor/data/web/sf
  (...)
</VirtualHost>

Conclusion

L'avantage de toutes ces manipulations est que désormais, un svn up mettra à jour non seulement les fichiers de notre application, mais également le framework en lui-même. Les éternels grincheux crieront au loup quand au danger de lier une version de développement (trunk), je leur répondrai qu'un svn:externals peut tout aussi bien pointer vers une révision ou un tag particulier.

Par exemple, si vous désirez éviter de lier le trunk de Symfony, vous pouvez lier la version 1.0RC2 en spécifiant son url dans votre svn:externals :

$ svn propset svn:externals "symfony http://svn.symfony-project.com/tags/RELEASE_1_0_0_rc2/" vendor

Pour la suite, je vous renvoie à la documentation officielle de Symfony

Ce billet intitulé Créer un projet Symfony à partir des dépôts Subversion sous Ubuntu a été rédigé par Nicolas Perriault et publié sur le blog Prendre un Café sous licence Creative Commons BY-NC-SA.

Installer et configurer Apache2, Trac et Subversion sur Ubuntu

NiKo — Tue, 05 Sep 2006 00:01:00 +0000

J'avais besoin d'un outil simple et complet pour gérer mes projets de développement hébergés sur ma nouvelle Dédibouate flambant neuve et fraîchement équipée d'une distribution linux Ubuntu Dapper Drake LTS. Naturellement, Trac et son copain Subversion se sont imposés comme une évidence, d'autant que je les utilisent déjà au quotidien dans mon travail.

Je me mis alors en quête d'informations sur la procédure d'installation de ces outils sur Ubuntu avec mon copain Google. Je suis tombé sur moult liens interessants mais pas toujours tout à fait complets ni exhaustifs ; aussi je décidai humblement de rédiger le présent billet faisant la synthèse de la procédure que j'ai utilisée et qui marche chez moi ^[1]

Prérequis

Avant toute chose, il est bien entendu impératif de disposer d'une distribution Ubuntu 6.06 LTS Dapper Drake et d'un accès root sur la machine.

Installation

Tout d'abord, activez les dépôts universe d'Ubuntu. Ceci fait, voici la liste des paquets à installer :

$ sudo apt-get update
$ sudo apt-get install subversion libapache2-svn libapache2-mod-python2.4 trac

La version de Trac fournie par les dépôts Ubuntu est la 0.9.3 ^[2]. On crée le répertoire système pour les instances de Trac, par exemple dans /var/trac ^[3] sans oublier le de rendre accessible en écriture par apache:

$ sudo mkdir /var/trac
$ sudo chown www-data:www-data /var/trac

Création d'une instance Trac pour votre projet

Il nous faut maintenant importer un projet dans Subversion. Pour l'exemple, nous créerons un projet nommé monzouliprojet. Pour cela, rien de plus simple... sauf pour les feignants. En étant moi-même un des plus féroces, j'ai pensé à mes compatriotes et leur ai créé un script qui leur permettra d'importer automatiquement leurs projets dans Subversion et de les rendre ainsi facilement accessibles à l'instance de Trac que nous créerons par la suite. Vous trouverez le code ici (certainement très perfectible, contributions bienvenues.)

Vous pouvez sauvegarder ce script dans un fichier create_svn_repo.sh par exemple, sans oublier de le rendre executable :

$ chmod +x create_svn_repo.sh

Il faudra bien sûr le lancer au moyen de sudo afin d'avoir les droits d'écritures dans les répertoires système concernés. Pour importer un nouveau projet Subversion à partir de vos sources existantes, il suffit de lancer le script et de répondre aux questions posées :

niko@nikobox:~$ sudo create_svn_repo.sh  
#######################################
Création d'un nouveau projet Subversion
#######################################

Tapez le nom du nouveau projet :
monzouliprojet
Tapez maintenant le chemin du répertoire source :
(Note: les répertoires trunk, branches et tags seront créés automatiquement)
/home/niko/monzouliprojet/
Création du projet monzouliprojet depuis /home/niko/monzouliprojet/...
Adding         /tmp/svn/monzouliprojet/trunk
Adding         /tmp/svn/monzouliprojet/trunk/test
Adding         /tmp/svn/monzouliprojet/trunk/test/main
...

Committed revision 1.

Projet subversion monzouliprojet créé avec succès !

Note : Vous pouvez éditer le fichier du script pour y spécifier notament le chemin de la racine subversion ^[4] :

SVN_ROOT="/var/svn"

Ensuite, il faut initialiser l'environnement trac pour notre projet recemment importé dans Subversion, ce que l'on fait au moyen de la série de commande suivante ^[5] :

sudo mkdir /var/trac
sudo trac-admin /var/trac/monzouliprojet initenv
sudo chown -R www-data /var/trac/monzouliprojet

Notez encore une fois que je crée la racine trac dans /var/trac mais vous pouvez tout à fait utiliser un autre emplacement.

Créer un ou plusieurs utilisateurs Trac et Subversion, gérer les autorisations

Par défaut, une instance Trac permet à tous les visiteurs anonymes d'en modifier les contenus ; bien évidemment, c'est un comportement de l'application particulièrement risqué, ne serait-ce qu'en regard du spam potentiel que vous pourriez récolter. Nous allons donc successivement créer un utilisateur subversion, puis désactiver les contributions anonymes pour Trac et ajouter un utilisateur possédant les droits d'administration Trac. Notez que nous utiliserons le même fichier de stockage des noms d'utilisateurs et de mots de passe pour Trac et Subversion ; ce fichier sera appelé au niveau de notre fichier de configuration Apache - défini un peu plus bas dans ce tutoriel.

Créons tout d'abord le fichier de stockage des mots de passe Trac/Subversion ^[6] et ajoutons un utilisateur maintener :

$ sudo htpasswd2 -c /etc/apache2/dav_svn.passwd maintener

Attribuez-lui un mot de passe. Bien, cet utilisateur aura par la suite officiellement accès à notre dépôt Subversion. Donnons-lui maintenant les droits d'administration totale de Trac :

$ sudo trac-admin /var/trac/monzouliprojet permission add maintener TRAC_ADMIN

On peut également imaginer la création d'un compte utilisateur développeur, qui peut créer des tickets, en fermer et maintenir le wiki :

$ sudo htpasswd2 -c /etc/apache2/dav_svn.passwd dev
$ sudo trac-admin /var/trac/monzouliprojet permission add dev WIKI_CREATE WIKI_MODIFY TICKET_CREATE TICKET_MODIFY

Il nous reste à desactiver les contributions anonymes :

$ sudo trac-admin /var/trac/monzouliprojet permission remove anonymous WIKI_CREATE WIKI_MODIFY TICKET_CREATE TICKET_MODIFY

Par la suite, vous pourrez effectuer la plupart de ces opérations par le biais du plugin WebAdmin dont nous détaillerons l'installation dans la partie suivante.

Vous trouverez plus d'informations sur les privilèges de Trac sur la page qui lui est consacrée.

Côté Subversion, il nous faut autoriser les checkouts anonymes mais s'assurer que'un utilisateur est authentifié avant d'accepter ses commits. Cela se configure très facilement dans le fichier /var/svn/monzouliprojet/conf/svnserve.conf, dans lequel vous pouvez saisir :

[general]
anon-access = read
auth-access = write
password-db = passwd 
# authz-db = authz
realm = MonZouliProjet Subversion Repository

Installer Trac WebAdmin

Trac WebAdmin est une interface web d'administration de votre ou vos instance(s) Trac offrant un confort appréciable pour administrer vos projets et en gérer les paramètres. Même si nous n'avons pas encore défini de vhost apache, rien ne nous empêche d'installer le plugin, qui passe d'abord par l'installation des setuptools :

$ wget http://peak.telecommunity.com/dist/ez_setup.py
$ sudo python ez_setup.py

Ceci fait, téléchargez le fichier de plugin TracWebAdmin sur le site de Trac, supprimez son extension .zip et installez-le au moyen du programme easy_install précédemment installé, comme suit :

$ wget http://trac.edgewall.org/attachment/wiki/WebAdmin/TracWebAdmin-0.1.1dev_r2765-py2.4.egg.zip?format=raw
$ mv TracWebAdmin-0.1.1dev_r2765-py2.4.egg.zip\?format\=raw TracWebAdmin.egg
$ sudo easy_install TracWebAdmin.egg

Éditez votre fichier de configuration d'instance Trac :

$ sudo vi /var/trac/monzouliprojet/conf/trac.ini

Et ajoutez-y la section suivante (si elle n'existe pas) :

[components]
webadmin.* = enabled

Enregistrez le fichier et quittez.

Créer un hôte virtuel Apache

Nous devons rendre accessible par le web notre instance de Trac ainsi que le dépôt Subversion associé, par le biais d'un hôte virtuel apache dédié :

$ sudo vi /etc/apache2/sites-available/trac.mondomaine.org

On y écrit les paramètres de notre hôte dédié, en admettant que nous disposons du domaine mondomaine.org nanti d'un sous-domaine trac :

<VirtualHost *>
    ServerAdmin webmaster@mondomaine.org
    ServerName trac.mondomaine.org
    
    DocumentRoot /var/trac/monzouliprojet
    <Location />
        SetHandler mod_python
        PythonHandler trac.web.modpython_frontend
        PythonOption TracEnv /var/trac/monzouliprojet
        PythonOption TracUriRoot /
        PythonPath "sys.path + ['/var/trac/monzouliprojet']"
    </Location>

    ErrorLog  /var/log/apache2/error.trac.domaine.org.log
    CustomLog /var/log/apache2/access.trac.domaine.org.log combined
    
    <Location /svn>
        DAV svn
        SVNPath /var/svn/monzouliprojet
        AuthType Basic
        AuthName "Monzouliprojet Subversion repository"
        AuthUserFile /etc/apache2/dav_svn.passwd
        <LimitExcept GET PROPFIND OPTIONS REPORT> 
            Require valid-user
        </LimitExcept>
    </Location>
    
    <Location "/login">
        AuthType Basic
        AuthName "Trac login"
        AuthUserFile /etc/apache2/dav_svn.passwd
        Require valid-user
    </Location>

</VirtualHost>

Vous devrez bien entendu enregistrer le domaine et le sous domaine dans votre fichier de configuration DNS, voire simplement dans votre fichier /etc/hosts si vous disposez d'un service de gestion DNS décentralisé comme celui que propose la société Gandi. Par exemple :

## Fichier /etc/hosts
127.0.0.1         localhost localhost.localdomain mamachine
123.124.125.126   trac.mondomaine.org

Nous utilisons mod_python (précédemment installé), n'oublions pas de l'activer :

$ sudo a2enmod mod_python

Ceci fait, il nous reste à activer le nouvel hôte apache et à relancer ce dernier :

$ sudo a2ensite trac.mondomaine.org
$ sudo /etc/init.d/apache2 restart

Pour vérifier que tout s'est déroulé correctement, faites pointer votre navigateur préféré vers l'adresse trac.mondomaine.org, vous devriez accéder sans encombres à votre instance nouvellement créée. Vous pouvez vous logguer en cliquant sur le lien Login ^[7] et en fournissant les paramètres d'accès utilisateur que vous avez définis précédemment. Si vous vous logguez en administrateur Trac, vous devriez disposer du menu Admin donnant accès à l'extension WebAdmin où vous pourrez ajuster les paramètres de votre instance aux petits oignons.

Côté subversion, vous pouvez effectuer un checkout de votre projet de cette façon :

$ svn co http://trac.mondomaine.org/svn/trunk/ .

Un commit nécessitera cependant l'authentification ; vous pourrez forcer le nom d'utilisateur à utiliser :

$ svn commit -m "test de commit" main/test/toto.txt --username mainteneur

Sources et références

Notes

[1] Y'a sans doûte mieux, plus simple, plus rapide, plus puissant, blah blah blah... le formulaire d'ajout de commentaire vous attend avec fébrilité.

[2] Ceux qui lorgnent sur la version 0.10 devront l'installer à la main. That's life.

[3] Pensez à remplacer ce chemin par celui que vous préférez dans le reste des exemples de ce tutoriel

[4] Notez que si ce répertoire n'existe pas, le script tentera de le créer pour vous.

[5] Notez également que mon script vous proposera de lancer le script adéquat une fois le projet subversion correctement créé.

[6] Vous pouvez stocker ce fichier sensible où bon vous semble mais par pitié, pas derrière votre racine web et de préférence le rendre accessible en écriture par le seul utilisateur root.

[7] Wow !

Ce billet intitulé Installer et configurer Apache2, Trac et Subversion sur Ubuntu a été rédigé par Nicolas Perriault et publié sur le blog Prendre un Café sous licence Creative Commons BY-NC-SA.