![[PukiWiki]](image/seasar.png "[PukiWiki]")
2013-09-09(火) ふたがわ(jfut): 準備中、まだ記入してないでください
Git リポジトリレイアウトの移行要望ページです。Subversion と Git ではリポジトリレイアウトの標準構成・特性が異なるため、変換作業が必要になります。
この内容に関して質問や足りない内容があれば、Seasar Committer ML までメールをお送りください。(ふたがわ (jfut))
要望期限: 2013-09-30(月)
移行作業を要望をされた場合、2013-10-07 (予定) 以降の移行期間に要望に応じてリポジトリを移行します。
移行期間中に記入していただいた内容は、随時テストリポジトリを作成し、Seasar Committer ML へ作成した旨をメールします。テストリポジトリの結果が気に入らない場合は再度、要望の内容を修正してください。
下記のフォーマットで記載してください。 このフォーマットで表現しきれない、こういう風にしたいけどどうしたら良い判らない場合は、Seasar Committer ML に相談してください。
3, 4 のフォーマットを指定していただいた場合は、変換スクリプト(移行準備期間に作成して公開します)で処理します。
自分で移行する場合のフォーマットは次のとおりです。
committer-name: あなたの Seasar.org のアカウント名 (https://www.seasar.org/members/committer/) 自分で移行します。
この場合、現在のコミッタ情報に応じてプロジェクトのチームメンバーを作成し、仮にリポジトリを 1 つ作成してチームに管理権限を付与します。このリポジトリに対して現在の Subversion リポジトリの内容を移行してください。複数リポジトリを利用したい場合は別途リポジトリを作成できますので、作成して移行してください。
他のプロジェクトのリポジトリと混同しないよう、「プロジェクト名-用途名」といった命名規則でリポジトリ名を作成するようにご協力ください。
移行作業者にすべてを任せる場合のフォーマットは次のとおりです。 どのような移行結果でも良い、もしくは、どのように移行するのが適切か判らない場合はこの指定で構いません。
committer-name: あなたの Seasar.org のアカウント名 (https://www.seasar.org/members/committer/) おまかせ
テストリポジトリを作成しますので必ずその内容で良いか確認してください。
おまかせにした場合、シンプルな例をベースにリポジトリに合った構成で移行します。おまかせしつつ、例えば、ファイルを除外したいなどの要望があれば、その旨を文章で書いていただいて構いません。
典型的な要望フォーマットは次のとおりです。
committer-name: yourname name: projectname svnroot: https://www.seasar.org/svn/projectname/ trunk: trunk tags: tags branches: branches ignore-paths: '^trunk/www/'
この指定は次の内容になります。
すべてのオプションを指定したフォーマットです。移行準備期間中の要望に応じて項目が増える場合があります。
committer-name: yourname name: projectname svnroot: https://www.seasar.org/svn/projectname/ trunk: trunk tags: tags branches: branches ignore-paths: '^trunk/www/' option.remove-git-svn-id: 1 option.replace-empty-commit-messages: 1 option.replace-empty-commit-messages.string: '<empty commit message>' option.no-convert-ignore-file: 1 option.no-convert-git-style-tag: 1 option.no-prune-empty: 1 option.no-migrate-branches: 1 option.no-migrate-tags: 1
各項目の意味は次のとおりです。
| 項目名 | 意味 | 必須項目 | デフォルト値 |
| committer-name | あなたの Seasar.org のアカウント名を指定してください。どなたが要望を書いたかを把握するためだけで、移行作業には影響しません。 | Y | |
| name | GitHub に作成する希望リポジトリ名 | Y | |
| svnroot | Git に移行する SVN のルートディレクトリ | Y | |
| trunk | Git の master ブランチ(SVN における trunk)にする svnroot からみたパスを指定します。 | trunk | |
| tags | Git の tag にする svnroot からみた tags があるパスを指定。指定された tag は Git 風のタグに変換します。 | tags | |
| branches | Git の branches にする svnroot からみた branches があるパスを指定します。 | branches | |
| ignore-paths | 移行時に除外したいファイルの正規表現を指定します。 | ||
| option.remove-git-svn-id | 移行時にコミットログに付与される SVN のコミット ID を削除したい場合に指定します。 | 0 | |
| option.replace-empty-commit-messages | 空のコミットメッセージがあった場合、特定の文字列に置換したい場合に指定します。Git では空コミットメッセージは許容されません。option.remove-git-svn-id に 1 を指定しないと空のコミットメッセージはできません。0: 置換しない、1: 置換する。 | 0 | |
| option.replace-empty-commit-messages.string | 空のコミットメッセージがあった場合に置換する文字列を指定します。 | '<empty commit message>' | |
| option.no-convert-ignore-file | svn:ignore から .gitignore ファイルを作成して欲しくない場合に指定します。0: 作成する 1: 作成しない。 | 0 | |
| option.no-convert-git-style-tag | SVN 特有の tags のスタイルを Git に適した tags のスタイルに変換したくない場合に指定します。1 を指定した場合、tag 用のブランチが切られた先に tag が付与されます。 | 0 | |
| option.no-prune-empty | 変更点がない空のコミットを取り除きたくない場合に指定します。ignore-paths の指定により空のコミットが出来ることがあります。 | 0 | |
| option.no-migrate-branches | branches を移行しない(push しない)場合に指定します。0: 移行する 1: 移行しない。 | 0 | |
| option.no-migrate-tags | tags を移行しない(push しない)場合に指定します。0: 移行する 1: 移行しない。 | 0 |
要望記入例と実行例です。
この例は最もシンプルな例です。この例では、ソース用リポジトリとサイト用リポジトリを分けています。
ソース用リポジトリから不要になるサイトコンテンツを除外するために、ignore-paths を指定しています。
committer-name: jfut name: doma svnroot: https://www.seasar.org/svn/doma/ trunk: trunk tags: tags branches: branches ignore-paths: '^trunk/www/'
サイトコンテンツのある trunk/www が Git の master になるように指定しています。 trunk/www に対する SVN の tags も Git に適した tags へ変換します。
committer-name: jfut name: doma-www svnroot: https://www.seasar.org/svn/doma/ trunk: trunk/www tags: tags branches: branches ignore-paths='^(?!branches/.*?/www/.*|tags/.*?/www/.*|trunk/www/.*)'
この例は、tags の扱いが特殊な例です。
SVN での tags の付与の仕方が s2directory, s2directory-tiger といったディレクトリの下にバージョンのディレクトリを作成してしまっていたため、そのままでは Git のタグに移行できません。そこで、s2directory 配下のバージョンのみを tag として扱うように指定しています。
また、ignore-paths に trunk/www に加えて、拡張子 .jar .war. .zip のファイルを除外するように指定しています。
committer-name: jfut name: s2directory svnroot: https://www.seasar.org/svn/sandbox/s2directory/ trunk: trunk tags: tags/s2directory \ branches: branches ignore-paths: '^trunk/www/|\.jar$|\.war$|\.zip$'
trunk/www に対する SVN の tags は存在しないため、単純に trunk/www の中身が入ったリポジトリが作成されます。
committer-name: jfut name: s2directory-www svnroot: https://www.seasar.org/svn/sandbox/s2directory/ trunk: trunk/www
この例は、SVN の trunk ではなく、特定の branch を Git の master にして移行する例です。
この例は、branches/teeda-1.0.13 を git の master にする例です。また、tags は移行しません。
committer-name: jfut name: teeda svnroot: https://www.seasar.org/svn/teeda/ trunk: branches/teeda-1.0.13 tags: tags branches: branches ignore-paths: '^(?!branches/.*|trunk/.*)|^trunk/www/.*|^tags/.*' \ option.no-migrate-tags: 1
この例は、branches, tags は移行しません。
committer-name: jfut name: teeda-www svnroot: https://www.seasar.org/svn/teeda/ trunk: trunk/www option.no-migrate-branches: 1 option.no-migrate-tags: 1
2013-09-09(火) ふたがわ(jfut): 準備中、まだ記入してないでください
ここにプロジェクトごとに移行作業要望を書いてください。記入後、順次、テストリポジトリを作成しますので確認してください。
committer-name: jfut name: s2directory svnroot: https://www.seasar.org/svn/sandbox/s2directory/ trunk: trunk tags: tags/s2directory \ branches: branches ignore-paths: '^trunk/www/'
committer-name: jfut name: s2directory-www svnroot: https://www.seasar.org/svn/sandbox/s2directory/ trunk: trunk/www
