やること

稼働中の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

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

手順詳細

全プロジェクトを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
```