This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.
svnsync initialize (init) — Initialiser un dépôt miroir pour une synchronisation à partir d'un dépôt source.
svnsync initialize URL_MIROIR URL_SOURCE
svnsync initialize vérifie que le dépôt répond aux exigences d'un dépôt miroir vierge (il n'y a pas d'historique et la modification des propriétés de révision est autorisée), puis enregistre les informations administratives initiales qui associent le dépôt miroir au dépôt source. C'est la première opération svnsync que vous lancez sur un dépôt miroir « en devenir ».
D'habitude, URL_SOURCE
est l'URL du
dossier racine du dépôt Subversion que vous souhaitez répliquer.
Subversion 1.5 ou ultérieur autorisent svnsync à
ne répliquer qu'une partie du dépôt source, vous devez alors
spécifier pour URL_SOURCE
l'URL du
sous-dossier dans le dépôt source que vous souhaitez
répliquer.
Par défaut, les prérequis déjà mentionnés pour le miroir sont
qu'il doit autoriser les modifications de propriétés de révisions et
qu'il ne doit contenir aucun historique. Cependant, depuis
Subversion 1.7, vous pouvez désactiver la vérification que le serveur
de destination est vide en utilisant l'option
--allow-non-empty
. Bien que l'utilisation de cette
option ne doit pas devenir une habitude (puisqu'elle courtciruite un
dispositif de protection), elle s'avère utile dans un cas très
fréquent : initialiser une copie d'un dépôt en tant que miroir
de l'original. C'est particulièrement pratique lorsque vous mettez
en place des nouveaux miroirs de dépôts qui contiennent des
historiques très volumineux. Plutôt que d'initialiser un nouveau
dépôt vierge comme miroir puis de synchroniser tout l'historique,
les administrateurs gagneront un certain temps à
d'abord faire une copie du dépôt en service (par exemple avec
svnadmin hotcopy), puis à utiliser
svnsync initialize --allow-non-empty pour
initialiser cette copie en tant que miroir, qui reflète déjà le
contenu de l'original.
Tenter d'initialiser un dépôt qui ne peut pas modifier les propriétés de révision :
$ svnsync initialize file:///var/svn/depot-miroir \ http://svn.exemple.com/depot svnsync: E165006: Le dépôt n'est pas configuré pour accepter les modifications de propriétés de révision ; parler à l'administrateur de la procédure automatique (hook) pre-revprop-change $
Initialiser un dépôt en tant que miroir, après avoir créé une
procédure automatique pre-revprop-change
qui
autorise les modifications des propriétés de révision :
$ svnsync initialize file:///var/svn/depot-miroir http://svn.exemple.com/depot Propriétés copiées pour la révision 0. $