Užitečné skripty 5: zálohujeme SVN repositář

28.3.2007 21:21 | Přečteno: 1644× | Linux

V dnešním díle zvedneme kvalitu seriálu zpátky na rozumnou úroveň a ukážeme si skript na zálohování SVN repositáře. Pokud si svoje textové výtvory skladujete v SVN, jistě oceňujete to, že si můžete zjistit všechny verze a změny, které jste kdy napsali. Je však potřeba myslet na katastrofickou situaci, když se nějak pokazí repositář. Potom se hodí záloha repositáře. Pokud máte repositářů víc, jistě se hodí skript, který celou akci zautomatizuje.

Abstrakt

Své texty (opravdové texty, skripty, konfiguráky apod.) si ukládám do SVN. Používám více repositářů, protože věci, které spolu opravdu nesouvisejí, raději dávám zvlášť. Abyste věděli předem, co od skriptu očekávat, tady je stručný přehled:

• Všechny repositáře jsou uloženy v jednom adresáři.
• Záloha se ukládá na externí disk, který může být namountovaný na dvou různých místech
• Skript si ukládá informaci o tom, kterou revizi repositáře naposledy zálohoval
• Pokud skript najde informaci o předchozí zálohované revizi, udělá inkrementální zálohu
• Pokud skript nenajde informaci o předchozí zálohované revizi, udělá plnou zálohu

Samotný skript

Základem skriptu je kód zveřejněný v jedné internetové diskusi, viz [1]. Skript je trochu delší.

Soubor backup.sh

#!/bin/sh
#Skript na zalohovani SVN
#Use: $0 <what to backup>

#based on http://snippets.dzone.com/posts/show/2635
call_exit(){
echo -n "Error code $1 - "
case "$1" in
    1)
        echo "Cannot find place for backup, exitting"
        ;;

    2)
        echo "Backup dir is not present, exitting"
        ;;
    3)
        echo "Backup dir is not writable, exitting"
        ;;

esac
exit $1
}
#Setup
infoDir=${HOME}/.backup #directory, where information about stored revisions is kept
svnRepository=${HOME}/SVN #repository location
externalBackupMountPoint1='/mnt/mp3' #first mountpoint to try
externalBackupMountPoint2='/mnt/local/mp3' #second mountpoint to try
externalBackupDir='backup' #path in the mounted disc (asume the disc can be mounted on two locations)

defaultBackup='phd' #what to backup, if nothing is given on commandline
#End of setup
#Find a location for the backup
if [ `mount | grep $externalBackupMountPoint1 | wc -l` -eq 1 ]
then
    backupDir="$externalBackupMountPoint1/$externalBackupDir"
elif [ `mount | grep $externalBackupMountPoint2 | wc -l` -eq 1 ]
then

    backupDir="$externalBackupMountPoint2/$externalBackupDir"
else
    call_exit 1
fi

[ -d $backupDir ] || call_exit 2

[ -w $backupDir ] || call_exit 3


echo =============================================
echo ============ Backup utility =================
echo =============================================
echo
echo Using $backupDir for the backup

timeStamp=`date +%F-%H-%M-%S`

#function to dump SVN repository
dumpDir(){

    dir=$1  #what repository to backup
    dirBaseName=`basename $dir` #basename of the repository to backup
    echo Processing $dir
	youngest=`svnlook youngest $dir` #last (youngest) revision in the repository
	if [ -r $infoDir/$dirBaseName ]; then   #if we have information about the last backupped revision
		latest=`cat $infoDir/$dirBaseName`  #last revision

		if [ $latest -lt $youngest ]; then  #if the last backuped revision is older than the youngest
                    cil=${backupDir}/`basename $dir`_$latest_$youngest_$timeStamp.gz #file name where to backup
		    echo Running incremental backup from revision $latest to revision $youngest
		    echo Target is $cil
		    svnadmin dump $dir --incremental -r $latest:$youngest | gzip > $cil # the command itself
		    cp $infoDir/$dirBaseName $infoDir/$dirBaseName.old #backup the old setting

		    echo $youngest > $infoDir/$dirBaseName #write the information about the backup
		else #no change since the last backup
		    echo No need to backup
		fi
	else #if we have no info about last backup, run full backup
            cil=${backupDir}/`basename $dir`_0_$youngest_$timeStamp.gz

	    echo Runnig full backup up to revision $youngest
	    echo Target is $cil
	    svnadmin dump $dir | gzip >  $cil #the command itself
	    [ -d $infoDir ] || mkdir $infoDir
	    echo $youngest > $infoDir/$dirBaseName #write the information about the backup
	fi

    echo Done
}

#if nothing is given on commandline, $defaultBackup is backed up
what=$1
if [ "x$1" = "x" ]
then
    what=$defaultBackup

fi

case "$what" in
    all)
        for dir in $svnRepository/*
        do
            dumpDir $dir

        done
        ;;
    *)
        dir=${svnRepository}/${what}
        if [ -d $dir ]
        then

            dumpDir $dir
        else
            echo $dir is not a valid SVN repository
	    exit 2
	fi
        ;;

esac

echo All Done

Lehké vysvětlení:

• řádky 5--19: funkce, která se volá, pokud je něco špatně. Vyplivne chybovou hlášku a vyskočí ze skriptu.
• řádky 20--27: nastavení základních proměnných. Význam je jasný z komentářů. Všimněte si, že se definují dva adresáře, kam se může disk namountovat. Potřeboval jsem to, když mi blblo NFS na routeru a připojoval jsem disk na přímo.
• řádky 28--37: Vyzkouší, jestli je namountovaný disk a inicializuje proměnnou $backupDir, která se používá dál, případně se zavolá exit.
• řádky 39--41: Zkontroluje, že cílový adresář opravu existuje a dá se do něj psát.
• řádky 51--78: Pomocná funkce, která se postará o vlastní zálohu repositáře. Komentáře napoví, co to vlastně dělá. Všimněte si, že se rozhoduje mezi plnou a inkrementální zálohou
• řádky 65 a 75: tady je duplicitní kód. Záměrem je, aby se informaco o poslední záloze přepisovala, jen pokud se opravdu něco zálohuje (aby se u informace zachovalo datum u souboru)
• řádky 60--85: rozhoduje se, co se vlastně bude zálohovat
• řádky 87--104:odsud se pouští zálohy. Jak je z kódu patrné, hodnota all znamená, že se zazálohují všechny repositáře. Proto není vhodné mít repositář tohoto jména. Protože si uživatel může na příkazovém řádku napsat, co chce, musí se zkontrolovat, že zadal správný název repositáře (řádek 96).

Obnovení ze zálohy

Pro nedostatek času toto téma vynechávám, můžete se vyřádit v diskusi.

Odkazy

1. http://snippets.dzone.com/posts/show/2635

Místa k vylepšení, otázky

1. Zlepšit reakci na vzniklé chyby, například, když dump repositáře nefunguje, jak má (řádky 62 a 72)

       

Komentáře

[David Watzke]

what=$1

if [ "x$1" = "x" ]
then
	what=$defaultBackup
fi

lze nahradit za

what=${1:-$defaultBackup}

P.S.: s/exitting/exiting/g