서브버전 저장소(subversion repository)를 git 으로 이관하기

svn2git 을 사용하여 svn 저장소를 git(gitlab) 으로 이관하기.

TODO

사전 준비

ruby 로 개발되었으므로 루비 인터프리터와 gem 설치가 필요

git 으로 이관할 프로젝트 디렉터리 생성(Ex: from-svn)
생성한 프로젝트 디렉터리로 이동
```
cd from-svn
```
svn 프로젝트의 URL 확인 (Ex: https://svn.example.com/svn/myproject)
작업자 정보 이관을 위한 authors 파일 생성 (아래의 Authros 항목 참고)
```
mkdir ~/.svn2git
vi ~/.svn2git/authors
```
svn2git 명령어로 svn 프로젝트를 git 으로 이관 (하단의 사용법과 옵션 항목 참고)
```
svn2git https://svn.example.com/svn/myproject
```

생성한 로컬 git 프로젝트를 remote 에 푸시

git remote add origin git@gitlab.example.com:group/myproject.git
git push -u origin master

svn2git SVN_URL [options]

option	의미	기본값
--trunk TRUNK_PATH	trunk 디렉터리 이름	trunk
--branches BRANCHES_PATH	branch 디렉터리 이름	branches
--tags TAGS_PATH	tags 이름	tags
--rootistrunk	svn root 가 trunk 이고 tags, branches 가 따로 없는 경우(trunk 만 있는 경우가 자주 있음)
--notrunk	trunk import 안 함
--nobranches	branches import 안 함
--revision START_REV[:END_REV]	특정 리비전부터 이관 시작. 종료 리비전이 필요할 경우 : 뒤에 기술. 다음은 30 부터 215까지 이관 --revision 30:215
--notags	tags import 안 함
--exclude REGEX	제외할 파일이 있을 경우 Perl 의 정규식 패턴으로 기술하면 git 에 포함되지 않음. --exclude 옵션은 여러 번 기술 가능
--authors AUTHORS_FILE	svn-to-git authors mapping 파일의 경로	~/.svn2git/authors
-v, --verbose	이관시 자세한 정보 출력(디버깅으로 유용)

git 으로 이관중 수정자의 id 도 git 에 등록된 id 로 변환할 수 있도록 ~/.svn2git/authors 파일을 만들고 다음과 같이 매핑 파일을 작성

좌측에는 svn 의 id 를 적고 우측은 git 의 계정 정보를 기록 (이름과 email 을 적어야 에러가 발생하지 않음)

jcoglan = James Coglan <jcoglan@never-you-mind.com>
stnick = Santa Claus <nicholas@lapland.com>

svn 에서 커밋한 작업자 id 목록을 미리 알아내어 authors 에 추가하여 이관 도중에 없는 id라고 중지하지 않는다.

다음 스크립트를 구동하면 커밋한 id 내역을 출력한다.

svn log|grep "^r[0-9]"|awk -F\| '{print $2}'| sed -e 's/^[ \t]*//'|sort|uniq

으로 되어 있을 경우 다음과 같이 svn 저장소의 URL 을 입력

svn2git http://svn.example.com/path/to/repo

yes 명령어뒤에 svn 로그인 암호를 넣고 명령어 실행

yes svn-password | svn2git --username lesstif http://svn.example.com/path/to/repo

svn2git http://svn.example.com/path/to/repo --trunk dev --tags rel --nobranches

project 명이 my-proj 이고 trunk, tag, branch 가 다른 레벨의 경로에 있을 경우

다음과 같이 각각 경로를 직접 지정

svn2git http://svn.example.com/path/to/repo --trunk trunk/my-proj --tags tags/my-proj --branches branches/my-proj

svn2git http://svn.example.com/path/to/repo --rootistrunk

위 옵션을 사용하면 다음과 같은 에러가 발생하고 제대로 동작하지 않음

 E: 'https:/my.svnserver.com/svn/easy/' is not a complete URL  and a separate URL is not specified  command failed:

다음과 같은 트릭 사용

svn2git http://svn.example.com/path/to/repo --trunk / --nobranches --notags

--exclude 옵션은 제대로 동작하지 않는 것 같음. 확인 필요

svn2git http://svn.example.com/path/to/repo --exclude doc --exclude '.*~$'