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.

Nom

svnsync initialize (init) — Initialiser un dépôt miroir pour une synchronisation à partir d'un dépôt source.

Synopsis

svnsync initialize URL_MIROIR URL_SOURCE

Description

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.

Options

Exemples

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.
$