やること

稼働中のGitBucketの全グループ、プロジェクト(リポジトリ)を新規に構築したGitLab(Community Edition)へ移行します。

基本的に他のGitリポジトリホスティングサービスでも概ね使えるんじゃないかと思いますが、

移行先がGitLabでない場合には、GitLab CLIの部分を適宜置き換える必要があります。

環境、条件等

移行元

OS: CentOS6
GitBucket: 3.0

移行先(新規構築)

OS: CentOS7
GitLab: 8.15.4

作業の流れ

GitLabサーバの構築
1. CentOS7をInstall
2. GitLabをインストール
3. GitLabCLIをインストール
リポジトリ群の移行
1. GitBucket側でグループとリポジトリのリストを取得
2. 取得したリストをもとにGitLab CLI でグループ群を作成
3. 取得したリストをもとにGitLab CLI でプロジェクト群を作成
4. 全プロジェクトをgitコマンドでGitBucketからCloneしてGitLabへPush
5. 各自のremoteをGitLabへ変更

GitLabサーバの構築

CentOS7をInstall
GitLabをインストール
1. インストール手順はオフィシャルを参照
GitLabCLIをインストール
1. オフィシャルにあるNarkoz's Ruby wrapper & CLIを使用する
2. インストール前に必要なパッケージをインストール
```
yum install -y gcc ruby-devel gem
gem install gitlab
```
3. README.mdに従ってインストール
```
gem install gitlab
```
4. GitLabでAccessTokenを発行する
5. 設定ファイルを修正
```
vi /usr/local/share/gems/gems/gitlab-3.7.0/lib/gitlab/configuration.rb
```
  configuration.rb
```
  :
def reset
  self.endpoint       = 'http://changeIt/api/v3'
  self.private_token  = 'AccessToken'
    :
end
  :
```
6. コマンドを実行して結果が得られることを確認
```
gitlab
gitlab users
gitlab groups
```

リポジトリ群の移行

リポジトリ移行時の注意

当初、適当なGitClientからCloneしてPushすればOKでしょ。と思っていたがこれはダメ。

何がダメかというと

Clone,Pushしたブランチしか移行できない
Tagが移行できない

下記の手順ですべての管理情報を含む移行ができる。

GitBucket上のSample/Appを、GitLabへ移行する場合の例

git clone --mirror https://gitbucket/Sample/App.git
cd App.git
git push --mirror https://gitlab/Sample/App.git

GitBucketもGitLabもWikiページをリポジトリとして管理するのでこれも同様に移行可能

git clone --mirror https://gitbucket/Sample/App.wiki.git
cd App.wiki.git
git push --mirror https://gitlab/Sample/App.wiki.git

これを踏まえ実際に移行作業へ。

手順詳細

GitBucket側でグループとリポジトリのリストを取得
1. どんな方法でもいいけど今回は locate で抽出しました。
```
locate *.git > gitList.txt
```
  1. find . -type d でも tree でも。職人さんは手作業でもいいかも。
    find /var/opt/gitbucket/git-data/repositories -type d -name *.git > gitList.txt tree -L 2 /var/opt/gitbucket/git-data/repositories > gitList.txt
取得したリストをもとにGitLab CLI でグループ群を作成

下記のグループ作成コマンドでloopして作成します。

全グループのみを抽出したテキストファイルgroups.txtをもとに処理する場合。とりあえずPublicで作成。
```
cat groups.txt | while read GROUP; do
    gitlab create_group ''${GROUP}'' ''${GROUP}'' "{ description: '${GROUP}', visibility_level: 20 }"
done
```
詳細は下記の通り。

gitlabコマンドのヘルプ
```
gitlab help
gitlab help Groups
gitlab help create_group
gitlab help add_group_memer
```
グループ作成コマンド

例:Sampleグループ
```
gitlab create_group 'Sample' 'Sample' "{ description: 'Sample', visibility_level: 0 }"
```
visibility_levelは3種類

visibility_level Group's visibility

0 private

10 internal

20 public

visibility_level を private に設定した場合その後メンバーを追加する必要があります。

メンバーの追加は、git add_group_memberで。

例: Hoge(id:1)をSampleグループ(id:9)にaccessLevel30(Developer)で追加
```
gitlab add_group_memer 3 1 30
```
accessLevelは5種類

accessLevel 定義

10 Guest

20 Reporter

30 Developer

40 Master

50 Owner
取得したリストをもとにGitLab CLI でプロジェクト群を作成

下記のプロジェクト作成コマンドでloopして作成します。

下記のような全プロジェクトと対応するグループIDを抽出したテキストファイルprojects.txtをもとに処理する。
projects.txt
```
SampleHoge,2
SamplPiyo,2
SampleFuga,3
```
コマンド
```
cat projects.txt | while read LINE; do
    PROJECT=`echo ${LINE} | cut -d',' -f 1`
    GROUPID=`echo ${LINE} | cut -d',' -f 2`
    gitlab create_project ''${PROJECT}'' "{ description: '${PROJECT}', namespace_id: '${GROUPID}' }"
done
```
詳細は下記の通り。

gitlabコマンドのヘルプ
```
gitlab help
gitlab help Projects
gitlab help create_project
```

visibility_level	Group's visibility
0	private
10	internal
20	public

accessLevel	定義
10	Guest
20	Reporter
30	Developer
40	Master
50	Owner

全プロジェクトをgitコマンドでGitBucketからCloneしてGitLabへPush

下記のようなGitBucketとGitLabのリポジトリのリストrepos.txtをもとに処理する。

repos.txt

https://gitbucket/SampleHoge/App.git,https://gitlab/SampleHoge/App.git
https://gitbucket/SampleHoge/App.wiki.git,https://gitlab/SampleHoge/App.wiki.git
https://gitbucket/SamplePiyo/App.git,https://gitlab/SamplePiyo/App.git
https://gitbucket/SamplePiyo/App.wiki.git,https://gitlab/SamplePiyo/App.wiki.git
https://gitbucket/SampleFuga/App.git,https://gitlab/SampleFuga/App.git
https://gitbucket/SampleFuga/App.wiki.git,https://gitlab/SampleFuga/App.wiki.git

コマンド

cat repos.txt | while read LINE; do
    if [ 0 -eq `echo ${LINE} | grep -c '.git'` ]; then
        continue
    fi
    SRC=`echo ${LINE} | cut -d',' -f 1`
    DST=`echo ${LINE} | cut -d',' -f 2`
    DIR=`echo ${SRC} | awk -F / '{print $NF}'`
    git clone --mirror ${SRC}
    cd ${DIR}
    git push --mirror ${DST}
    cd ..
done

各自のremoteをGitLabへ変更

可能であれば移行前にすべて変更をCommit&Pushしておいてもらい、移行後にGitLabからcloneし直してもらうのが良い。

が、それが困難な場合には既存のremoteのURLを更新します。
```
git remote set-url origin https://gitlab/SampleHoge/App.git
```

GitBucketからGitLabへの移行