GitMigrationRequest の履歴(No.9)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• GitMigrationRequest へ行く。
  • 1 (2013-09-07 (土) 16:18:55)
  • 2 (2013-09-07 (土) 16:24:38)
  • 3 (2013-09-07 (土) 20:34:00)
  • 4 (2013-09-09 (月) 18:46:59)
  • 5 (2013-09-10 (火) 15:05:12)
  • 6 (2013-09-14 (土) 11:20:05)
  • 7 (2013-09-16 (月) 11:31:59)
  • 8 (2013-09-16 (月) 14:45:34)
  • 9 (2013-09-16 (月) 18:12:26)
  • 10 (2013-09-18 (水) 14:27:26)
  • 11 (2013-09-19 (木) 08:25:43)
  • 12 (2013-09-19 (木) 12:33:28)
  • 13 (2013-09-20 (金) 07:52:42)
  • 14 (2013-09-20 (金) 11:53:40)
  • 15 (2013-09-21 (土) 11:05:57)
  • 16 (2013-09-21 (土) 16:58:36)
  • 17 (2013-09-21 (土) 22:56:01)
  • 18 (2013-09-23 (月) 13:09:30)
  • 19 (2013-09-23 (月) 13:35:55)
  • 20 (2013-09-23 (月) 20:38:13)
  • 21 (2013-09-23 (月) 23:44:12)
  • 22 (2013-09-24 (火) 00:32:38)
  • 23 (2013-09-24 (火) 12:40:23)
  • 24 (2013-09-24 (火) 16:37:05)
  • 25 (2013-09-24 (火) 20:47:17)
  • 26 (2013-09-25 (水) 00:29:37)
  • 27 (2013-09-25 (水) 06:54:45)
  • 28 (2013-09-25 (水) 12:08:30)
  • 29 (2013-09-25 (水) 16:53:45)
  • 30 (2013-09-25 (水) 22:55:12)
  • 31 (2013-09-26 (木) 07:28:50)
  • 32 (2013-09-26 (木) 19:44:25)
  • 33 (2013-09-26 (木) 21:03:30)
  • 34 (2013-09-27 (金) 09:57:19)
  • 35 (2013-09-27 (金) 16:45:39)
  • 36 (2013-09-28 (土) 10:54:56)
  • 37 (2013-09-28 (土) 16:39:38)
  • 38 (2013-09-28 (土) 16:48:34)
  • 39 (2013-09-29 (日) 00:35:56)
  • 40 (2013-09-29 (日) 12:53:33)
  • 41 (2013-09-29 (日) 17:45:03)
  • 42 (2013-09-29 (日) 22:41:44)
  • 43 (2013-09-30 (月) 05:56:51)
  • 44 (2013-09-30 (月) 10:25:33)
  • 45 (2013-09-30 (月) 19:15:38)
  • 46 (2013-09-30 (月) 22:54:47)
  • 47 (2013-10-01 (火) 09:54:53)
  • 48 (2013-10-02 (水) 01:09:30)
  • 49 (2013-10-04 (金) 11:21:36)
  • 50 (2013-10-07 (月) 23:39:54)
  • 51 (2013-10-09 (水) 14:28:17)
  • 52 (2013-10-13 (日) 11:13:52)
  • 53 (2013-10-13 (日) 15:41:12)

---

プロジェクト単位: Git リポジトリレイアウトの移行要望†

Git リポジトリレイアウトの移行要望ページです。Subversion と Git ではリポジトリレイアウトの標準構成・特性が異なるため、変換作業が必要になります。

この内容に関して質問や足りない内容があれば、Seasar Committer ML までメールをお送りください。(ふたがわ (jfut))

移行作業要望†

要望期限: 2013-09-30(月)

移行作業を要望をされた場合、2013-10-07 (予定) 以降の移行期間に要望に応じてリポジトリを移行します。

移行期間中に記入していただいた内容は、随時テストリポジトリを作成し、Seasar Committer ML へ作成した旨のメールを送ります。テストリポジトリの結果が気に入らない場合は再度、要望の内容を修正してください。

フォーマット†

下記のフォーマットで記載してください。 このフォーマットで表現しきれない、こういう風にしたいけどどうしたら良い判らない場合は、Seasar Committer ML に相談してください。

3, 4 のフォーマットを指定していただいた場合は、変換スクリプト(移行準備期間に作成して公開します)で処理します。

1. プロジェクトコミッタ本人が自分で移行するフォーマット†

自分で移行する場合のフォーマットは次のとおりです。

committer-name: あなたの Seasar.org のアカウント名 (https://www.seasar.org/members/committer/)
自分で移行します。

この場合、現在のコミッタ情報に応じてプロジェクトのチームメンバーを作成し、仮にリポジトリを 1 つ作成してチームに管理権限を付与します。このリポジトリに対して現在の Subversion リポジトリの内容を移行してください。複数リポジトリを利用したい場合は別途リポジトリを作成できますので、作成して移行してください。

他のプロジェクトのリポジトリと混同しないよう、「プロジェクト名-用途名」といった命名規則でリポジトリ名を作成するようにご協力ください。

2. 移行作業者に任せる要望フォーマット†

移行作業者にすべてを任せる場合のフォーマットは次のとおりです。 どのような移行結果でも良い、もしくは、どのように移行するのが適切か判らない場合はこの指定で構いません。

committer-name: あなたの Seasar.org のアカウント名 (https://www.seasar.org/members/committer/)
おまかせ

テストリポジトリを作成しますので必ずその内容で良いか確認してください。

おまかせにした場合、シンプルな例をベースにリポジトリに合った構成で移行します。おまかせしつつ、例えば、ファイルを除外したいなどの要望があれば、その旨を文章で書いていただいて構いません。

3. 典型的な要望フォーマット†

典型的な要望フォーマットは次のとおりです。

committer-name: yourname
name: projectname
svnroot: https://www.seasar.org/svn/projectname/
trunk: trunk
tags: tags
branches: branches
ignore-paths: '^trunk/www/'

この指定は次の内容になります。

• 最小フォーマットによる移行結果
  • GitHub に projectname という名前のリポジトリを作成します。
  • SVN の移行元は https://www.seasar.org/svn/projectname/ です。
  • SVN の trunk が Git の master になります。
  • SVN の branches が Git の branches になります。
  • SVN の tags が Git の branches になります。
  • SVN へコミットしたすべてのファイルを Git へ移行します。除外するファイルは何もありません。
  • Git へ移行時にコミットログに自動的に付与される SVN のコミット ID を削除しません。
    • コミットID の例: git-svn-id: https://www.seasar.org/svn/teeda/branches/teeda-1.0.13@4313 e0972215-f904-0410-97d3-99f68b247671
  • SVN に空のコミットメッセージがあった場合、そのまま移行し、文字列の置換処理をしません。
  • SVN に設定されていた svn:ignore の内容を .gitignore ファイルを作成して置き換えます。このファイルはプロジェクトリーダの Author 情報で移行した Git へコミットします。
  • SVN 特有の tags のスタイルを Git に適した tags のスタイルに変換します。
  • 変更点がない空のコミットがあった場合にそのコミットを取り除きます。

4. すべてのオプションを指定したフォーマット†

すべてのオプションを指定したフォーマットです。移行準備期間中の要望に応じて項目が増える場合があります。

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.migrate-branches: name-1.x,name-2.x
option.no-convert-ignore-file: 1
option.no-convert-empty-directory: 1
option.no-convert-git-style-tag: 1
option.no-prune-empty: 1
option.no-migrate-branches: 1
option.no-migrate-tags: 1

各項目の意味は次のとおりです。

要望記入例と実行例†

要望記入例と実行例です。

シンプルな例†

この例は最もシンプルな例です。

• ソース用リポジトリ
  • 実行結果 (準備中)

ソース用リポジトリから使用していないサイトコンテンツを除外するために、ignore-paths を指定しています。

committer-name: jfut
name: doma
svnroot: https://www.seasar.org/svn/doma/
trunk: trunk
tags: tags
branches: branches
ignore-paths: '^trunk/www/'

例にした Doma プロジェクトでは、プロジェクトサイトを trunk/www にコミットせず、Maven を利用してデプロイしているため、SVN リポジトリ内に zip や jar ファイルのリリースファイルがありません。Git では git clone すると過去のリリースファイルもすべてダウンロードするため、trunk/www でサイトコンテンツを管理していた場合、別リポジトリに分けた方が良いケースもあります。これは好みの問題でもあるため、自由に選択してください。

• 参考: プロジェクトサイトの管理方法

tags の扱いが特殊な例†

この例は、tags の扱いが特殊な例です。 また、ソース用リポジトリとサイト用リポジトリを分けています。

• ソース用リポジトリ
  • 実行結果

SVN での tags の付与の仕方が s2directory, s2directory-tiger といったディレクトリの下にバージョンのディレクトリを作成してしまっていたため、そのままでは Git のタグに移行できません。そこで、s2directory 配下のバージョンのみを tag として扱うように指定しています。なお、s2directory-tiger 以下にあったタグ情報は使わずに無視しています。

また、ignore-paths に trunk/www に加えて、拡張子 .jar .war. .zip のファイルを除外するように指定しています。 この指定は、例えば過去に lib フォルダに依存ライブラリを置いていたものの、現在では Maven を利用するようになりそれらのファイルを使っていない場合に、過去のコミットからも依存ファイルを削除することで移行後のリポジトリサイズを小さくすることができます。

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

特定の branch を master にする例†

この例は、SVN の trunk ではなく、特定の branch を Git の master にして移行する例です。 また、ソース用リポジトリとサイト用リポジトリを分けています。

• ソース用リポジトリ
  • 実行結果

この例は、branches/teeda-1.0.13 を git の master にする例です。 過去に trunk/www でサイトコンテンツを管理していましたが、現在では Maven で管理しているためサイト用リポジトリは作成せず、また、過去のサイトコンテンツも移行しない指定をしています。

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.migrate-branches: teeda-1.0.11,teeda-1.0.12
option.no-migrate-tags: 1

[記入欄] プロジェクト単位: Git リポジトリレイアウト要望 (要望期限: 2013-09-30(月))†

このページを直接「編集」して、ここにプロジェクトごとの移行作業要望を書いてください。記入後、順次、テストリポジトリを作成しますので確認してください。

S2Directory†

• ソース用リポジトリ

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

Doma†

• ソース用リポジトリ

committer-name: taedium
name: doma
svnroot: https://www.seasar.org/svn/doma/
ignore-paths: '(^(?!branches/.*|trunk/doma/.*|trunk/doma-it/.*)|(\.jar|\.war|\.zip)$)'

2013-09-16 jfut: テストリポジトリ作成: https://github.com/seasarorg/test-doma3

committer-name: taedium
name: doma-gen
svnroot: https://www.seasar.org/svn/doma/
ignore-paths: '(^(?!branches/.*|trunk/doma-gen/.*|trunk/doma-gen-it/.*)|(\.jar|\.war|\.zip)$)'

2013-09-16 jfut: テストリポジトリ作成: https://github.com/seasarorg/test-doma-gen3

committer-name: taedium
name: doma-samples
svnroot: https://www.seasar.org/svn/doma/
ignore-paths: '(^(?!branches/.*|trunk/doma-tutorial/.*|trunk/doma-jpetstore/.*)|(\.jar|\.war|\.zip)$)'

2013-09-16 jfut: テストリポジトリ作成: https://github.com/seasarorg/test-doma-samples3

committer-name: taedium
name: doma-tools
svnroot: https://www.seasar.org/svn/doma/
ignore-paths: '(^(?!branches/.*|trunk/org.seasar.doma.extension.domax/.*|trunk/org.seasar.doma.extension.feature/.*|trunk/org.seasar.doma.extension.updatesite/.*)|(\.jar|\.war|\.zip)$)'

2013-09-16 jfut: テストリポジトリ作成: https://github.com/seasarorg/test-doma-tools3

Mayaa†

• ソース

 committer-name: suga
 name: mayaa
 svnroot: https://www.seasar.org/svn/mayaa
 trunk: trunk/mayaa
 tags: tags/mayaa \
 option.no-migrate-branches: 1

• サイト

 committer-name: suga
 name: mayaa-www
 svnroot: https://www.seasar.org/svn/mayaa
 trunk: trunk/www
 option.no-migrate-tags: 1
 option.no-migrate-branches: 1

• matatabi

 committer-name: suga
 name: mayaa-matatabi
 svnroot: https://www.seasar.org/svn/mayaa
 trunk: trunk/matatabi
 option.no-migrate-tags: 1
 option.no-migrate-branches: 1
 ignore-paths: '(\.war|\.zip)$'

• webwork2

 committer-name: suga
 name: mayaa-webwork2
 svnroot: https://www.seasar.org/svn/mayaa
 trunk: trunk/mayaa-webwork2
 option.no-migrate-tags: 1
 option.no-migrate-branches: 1

• struts2

 committer-name: suga
 name: mayaa-struts2
 svnroot: https://www.seasar.org/svn/mayaa
 trunk: trunk/struts2-mayaa-plugin
 option.no-migrate-tags: 1
 option.no-migrate-branches: 1

※テスト、サンプルは移行後にmayaaにコミットする想定

関連ページ†

• GitMigration
• Git