Dernière modification le 13/01/2009 à 23:14.
L’objectif de cette page est de détailler l’installation d’un serveur Subversion [1].
Ce document a été rédigé en LaTeX en utilisant l’excellent Vim sous Debian GNU/Linux. Il est disponible aux formats XHTML et PDF. Les sources LaTeX sont disponibles ici : LATEX
Copyright ©2009 Matthieu VOGELWEITH <matthieu@vogelweith.com>.
Vous avez le droit de copier, distribuer et/ou modifier ce document selon les termes de la GNU Free Documentation License, Version 1.3 ou ultérieure publiée par la Free Software Foundation ; avec aucune section inaltérable, aucun texte de première page de couverture, et aucun texte de dernière page de couverture. Une copie de la licence est disponible dans la page GNU Free Documentation License.
- principe
- avantages
- différences par rapport aux autres
Subversion (SVN) est un système de contrôle des versions OpenSource distribué sous une licence compatible Apache/BSD. Cet outil en développement depuis quelques années propose un grand nombre de nouveautés par rapport à son aîné vieillissant qu’est CVS :
Subversion semble donc plus adapté que CVS, notamment au niveau de l’authentification (Apache donc PAM, NIS, ...) et de la gestion des versions sur l’arborescence du dépot.
# aptitude install subversion libapache2-svn subversion-tools
- Version standalone et version module d’apache
- Plutot en module d’apache, car
– permet de bénéficier des méthodes d’authentification et de sécurité d’apache
– evite d’ouvrir un port supplémentaire sur le firewall
- création du dépot
- fonctionnement des branches et des tags
- cycle de developpement habituel
Les dépots doivent être créés, obligatoirement dans le système de fichier local, avec les commandes suivantes :
# mkdir /var/lib/svn # svnadmin create /var/lib/svn/projet1 # chown -R www-data:www-data /var/lib/svn # chmod -R 700 /var/lib/svn
Dans l’exemple ci-dessus, un dépot a été créé : projet1. Il est important de bien donner les droits à l’utilisateur virtuel d’Apache (www-data) pour que le depot puisse être accéssible par le Web.
Attention, maintenant que les dépots sont créés, aucun fichier ne doit être créé, modifié ou supprimé manuellement dans le dépot. Tout doit se faire avec les commandes fournies par Subversion.
Respect de l’architecture préconisée : trunk, tags, branches.
# rm -rf /tmp/projet1 # mkdir -p /tmp/projet1/trunk # mkdir -p /tmp/projet1/tags # mkdir -p /tmp/projet1/branches # svn import /tmp/projet1/ file:///var/lib/svn/projet1 -m "Creation initiale de l'arborescence"
Comme indiqué précédemment il est possible de configurer le dépot subversion en tant que module apache, ce qui permettra notamment de s’appuyer sur les mechanismes d’authentification offerts par ce dernier. La configuration décrite ci-dessous utilise un authentification LDAP mais il est tout a fait possible d’utiliser les autres mechanismes d’authentification d’Apache.
Pour créer le VirtualHost, enregistrer les informations suivantes dans le fichier /etc/apache2/sites-available/svn :
# Virtual host pour la gestion du depot SVN
<VirtualHost example.org>
# Config generale du Vhost
Servername svn.example.org
ServerAdmin webmaster@example.org
# Droits d'acces au repertoire
<Directory /var/lib/svn/>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>
# Acces URL
<Location />
DAV svn
# SVN root path
SVNParentPath /var/lib/svn
# LDAP authentication
AuthBasicProvider ldap
AuthType Basic
AuthzLDAPAuthoritative off
AuthName "Subversion Repository"
AuthLDAPURL ldap://ldap.example.org/ou=Users,dc=example,dc=org
AuthLDAPGroupAttribute memberUid
AuthLDAPGroupAttributeIsDN off
Require ldap-group cn=svn,ou=Groups,dc=example,dc=org
# Change stylesheet
# SVNIndexXSLT "/styles/svnindex.xsl"
# Use default ErrorDocument
ErrorDocument 404 default
</Location>
ErrorLog /var/log/apache2/svn_error.log
CustomLog /var/log/apache2/svn_access.log combined
</VirtualHost>
Pour que le vhost soit actif, il faut enfin l’activer puis recharger Apache avec les commmandes suivantes :
# a2ensite svn # /etc/init.d/apache2 reload
Si tout ce passe correctement, le dépot SVN est maintenant disponible. Par exemple, si le dépot projet1 a été créé comme indiqué dans le paragraphe 3.1, l’arborescence doit être visible via un navigateur web à l’adresse http://svn.example.org/projet1.
- Visualisation du dépot
# aptitude install websvn
- indiquer le chemin du répertoire parent des dépots lors de la configuration.
- supprimer le lien de /var/www/websvn.
- Ajouter l’alias qui va bien - éditer la config dans le fichier /etc/websvn/config.inc
Plusieurs clients SVN sont disponibles sur les plateformes UNIX et Windows. Dans les deux cas, il est toujours possible de visualiser le contenu du dépot ainsi que les modifications et les commentaires de chaque fichier/dossier via un navigateur Web.
Ce chapitre décrit rapidement le fonctionnement de Subversion pour une utilisation de tous les jours.
$ svn update
http://serveur_de_test/ma_page.php
Lorsque les tests sont réussi, en fin de journée ou lorsque les modifications sont validées et considérée comme correctes, on peut mettre a jour le code sur le serveur Subversion. Cette opération est réalisée simplement par la commande commit :
$ svn commit
Maintenant que les modifications sont effectives sur le serveur Subversion, on peut facilement visualiser l’historique des modifications via un navigateur Web :
http://serveur_subversion/svn/nom_du_depot
