Git 変換：SVN から Git への移行の一歩

ここで、＜svn-repo＞ はマイグレーション対象の SVN リポジトリの URI、＜project＞ はインポートするプロジェクトの名前、＜git-repo-name＞ は新しい Git リポジトリのディレクトリ名です。

例えば、https://svn.atlassian.comでホストされているConfluenceという名称のプロジェクトの移行を行う場合、次のコマンドを実行します:

SVNリポジトリのレイアウトが非標準的な場合、--trunk、--branches、--tagsコマンドラインオプションを使用して、トランク、ブランチ、タグの場所を指定する必要があります。例えば、ブランチが /branchesディレクトリと/bugfixesディレクトリに保存されている場合、次のコマンドを実行します:

git svn clone の処理 (これには時間がかかる場合があります) が完了すると、~/GitMigration に という新しいディレクトリが作成されます。これが変換後の Git リポジトリです。ここから に移動すれば、標準的な Git コマンドを実行して、プロジェクトの内容を確認できます。

ブランチとタグが新しいGitリポジトリにインポートされる方法には留意する必要があります。SVNブランチはgit branchコマンドの出力には表示されず、またSVNタグはgit tagコマンドの出力に表示されません。しかし、git branch -rを実行するとSVNリポジトリのすべてのブランチとタグが表示されます。git svn cloneコマンドを実行すると、SVNブランチはリモートブランチとしてインポートされ、SVNタグはtags/というプレフィックスが付いたリモートブランチとしてインポートされます。

この動作により、一部の双方向同期の手順が簡易化されますが、一方向のマイグレーションGitを試みる場合は混乱が生じる場合があります。このため、次にこれらのリモートブランチをローカルブランチと実際のGitタグに変換する作業が必要となります。

svn-migration-scripts.jar内にあるclean-gitスクリプトを使用して、SVNブランチをローカルのGitブランチに、 SVN タグを完全なGitタグに変換します。この処理は「不可逆的」であり、GitリポジトリからSVNリポジトリにコミットを戻すことはできなくなることに留意してください。

このマイグレーションガイドの通りに作業しているのであれば、同期はSVNからGitへの一方向であり (マイグレーションステップの完了まではGitリポジトリはリードオンリーで使用します)、これが問題になることはありません。ただし、マイグレーション処理中にGitリポジトリにコミットを行なう予定があり、かつSVNリポジトリに反映させる必要がある場合は、下に示すコマンドを実行してはなりません。この操作は上級者向けであり、通常のプロジェクトにおいてはその使用を推奨しません。

クリーンアップスクリプトの処理内容を確認するには、~/GitMigration/において次のコマンドを実行します:

このスクリプトを実行するとすべての変換処理内容が表示されますが、実際には変換は実行されません。変換を実行する場合は --forceオプションを使用して次のようにします:

このスクリプト処理が完了すると、git branchの出力にはすべての SVN ブランチが表示され、git tagの出力にはすべての SVN タグが表示されるようになります。これらが表示された場合、それはSVN リポジトリから Git リポジトリへの変換が成功したことを意味します。

このステップでは、git svn cloneコマンドを使用して SVN リポジトリを新たな Git リポジトリにクローンする方法、および svn-migration-scripts.jarを使用してその結果生成されるリポジトリをクリーンアップする方法について説明しました。次のステップでは、SVN リポジトリにコミットが追加された場合に、新たな Git リポジトリを SVN リポジトリに同期させる方法について学習します。このプロセスは「変換」の場合と似ていますが、移行期間中においてはワークフロー上の重要な問題を考慮する必要があります。