From Fedora Project Wiki

< User:Ke4qqq

Revision as of 15:28, 8 December 2010 by Tmz (talk | contribs) (Update svn-to-git-authors script to catch unknown users)


Migrated hosted repositories to that of another type.

Contact Information

Owner: Fedora Infrastructure Team

Contact: #fedora-admin, sysadmin-hosted

Location: Serverbeach

Servers: hosted1, hosted2

Purpose: Migrate hosted SCM repositories to that of another SCM.

Description

fedorahosted.org can be used to host open source projects. Occasionally those projects want to change the SCM they utilize. This document provides documentation for doing so.


  1. An scm for maintaining the code. The currently supported scm's include Mercurial, Git, Bazaar, or SVN. Note: There is no cvs
  2. A trac instance, which provides a mini-wiki for hosting information and also provides a ticketing system.
  3. A mailing list



Important.png
This page is for administrators only. People wishing to request a hosted project should use the Ticketing System ; see the
new project request template
. (Requires Fedora Account)

SVN to GIT migration

{{Admon/note | Currently you must manually generate $PROJECTNAME-users.txt by grabbing a list of people in the FAS group - and recording them in th following format

 $fasusername = FirstName LastName <$emailaddress> 

This is error prone, and will stop the git-svn fetch below if an author appears that doesn't exist in the list of users.

 svn log --quiet | awk '/^r/ {print $3}' | sort -u 

The above will generate a list of users in the svn repo.

If all users are FAS users you can use the following script to create a users file (written by tmz (Todd Zullinger)

#!/bin/bash

if [ -z "$1" ]; then
    echo "usage: $0 <svn repo>" >&2
    exit 1
fi

svnurl=file:///svn/$1

if ! svn info $svnurl &>/dev/null; then
    echo "$1 is not a valid svn repo." >&2
fi

svn log -q $svnurl | awk '/^r[0-9]+/ {print $3}' | sort -u | while read user; do
    name=$( (getent passwd $user 2>/dev/null | awk -F: '{print $5}') || '' )
    [ -z "$name" ] && name=$user
    email="$user@fedoraproject.org"
    echo "$user=$name <$email>"
done
  1. Log into hosted1
  2. Make a temporary directory to convert the repos in
    $ sudo mkdir /tmp/tmp-$PROJECTNAME.git
    $ ce /tmp/tmp-$PROJECTNAME.git
  3. Create an git repo ready to receive migrated SVN data
    $ sudo git-svn init http://svn.fedorahosted.org/svn/$PROJECTNAME --no-metadata 
  4. Tell git to fetch and convert the repository:
    $ git svn fetch 
Note.png
This creation of a temporary repository is necessary because SVN leaves a number of items floating around that git can ignore, and we want those essentially ignored.

From here, you'll wanted to follow Creating a new git repo as if cloning an existing git repository to Fedorahosted.

After that process is done - kindly remove the temporary repo that was created

$ sudo rm -rf /tmp/tmp-$PROJECTNAME.git 

Questions left to be answered with this SOP

  • Obviously we need to have requestor review the migration and confirm it's ok.
  • Do we then delete the old SCM contents?
  • Do we need to change the FAS-group type to grant them access to pull/push from it?