Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/m-tmatma/ttssh2migrate
ttssh2 SVN(=https://ja.osdn.net/projects/ttssh2/scm/svn/) git convertion scripts
https://github.com/m-tmatma/ttssh2migrate
Last synced: about 10 hours ago
JSON representation
ttssh2 SVN(=https://ja.osdn.net/projects/ttssh2/scm/svn/) git convertion scripts
- Host: GitHub
- URL: https://github.com/m-tmatma/ttssh2migrate
- Owner: m-tmatma
- Created: 2022-11-04T22:37:12.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-22T00:13:07.000Z (almost 2 years ago)
- Last Synced: 2023-08-04T08:24:56.242Z (over 1 year ago)
- Language: Shell
- Homepage:
- Size: 278 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# This repository contains scripts to migrate [ttssh2 SVN](http://svn.osdn.net/svnroot/ttssh2)
[](https://github.com/m-tmatma/ttssh2migrate/actions/workflows/run.yml)
[ttssh2 SVN](http://svn.osdn.net/svnroot/ttssh2) を git に変換するためのスクリプト、設定ファイル群
- [This repository contains scripts to migrate ttssh2 SVN](#this-repository-contains-scripts-to-migrate-ttssh2-svn)
- [変換手順](#変換手順)
- [仕組み](#仕組み)
- [svn-all-fast-export](#svn-all-fast-export)
- [変換手順詳細](#変換手順詳細)
- [svn sync](#svn-sync)
- [svndumpfilter](#svndumpfilter)
- [svn log](#svn-log)
- [svn-all-fast-export](#svn-all-fast-export-1)
- [git repack](#git-repack)
- [制限事項](#制限事項)
- [リビジョングラフ](#リビジョングラフ)
- [成果物](#成果物)
- [成果物のダウンロード](#成果物のダウンロード)
- [GitHub CLI](#github-cli)
- [準備](#準備)
- [workflow の列挙](#workflow--の列挙)
- [該当リポジトリと同じディレクトリで実行する場合](#該当リポジトリと同じディレクトリで実行する場合)
- [該当リポジトリと異なるディレクトリで実行する場合](#該当リポジトリと異なるディレクトリで実行する場合)
- [成果物のダウンロード](#成果物のダウンロード-1)
- [ダウンロードの進捗表示](#ダウンロードの進捗表示)
- [具体例: `ID 3556843090` の成果物をダウンロードする場合](#具体例-id-3556843090-の成果物をダウンロードする場合)
- [具体例: `ID 3556843090` で名前に `GIT` を含む成果物をダウンロードする場合](#具体例-id-3556843090-で名前に-git-を含む成果物をダウンロードする場合)
- [具体例: `ID 3556843090` で名前に `GIT` を含む成果物を指定したディレクトリ(`artifacts-3556843090`) にダウンロードする場合](#具体例-id-3556843090-で名前に-git-を含む成果物を指定したディレクトリartifacts-3556843090-にダウンロードする場合)
- [成果物のgitリポジトリをGitHubにpush](#成果物のgitリポジトリをgithubにpush)
- [GITリポジトリを展開](#gitリポジトリを展開)
- [push 先のリポジトリを用意](#push-先のリポジトリを用意)
- [GITリポジトリをすべて push](#gitリポジトリをすべて-push)
- [具体例: (Push先のURL の部分が https://github.com/m-tmatma/ttssh2-work.git)](#具体例-push先のurl-の部分が--httpsgithubcomm-tmatmattssh2-workgit)
# 変換手順
```
./0.build-svn2git.sh
./1.mirror-ttssh2.sh
./2.filter-svndmp.sh
./3.svnlog.sh
./4.migrate.sh
./5.git-repack.sh
```
# 仕組み
https://github.com/svn-all-fast-export/svn2git を利用して、svn から git への変換を行う。
## svn-all-fast-export
[svn-all-fast-export](https://manpages.ubuntu.com/manpages/trusty/man1/svn-all-fast-export.1.html) はカスタマイズ版を自前ビルドする。
`svn-all-fast-export` を利用するためには Linux が必要。Ubuntu を想定。
# 変換手順詳細
## svn sync
`svn sync` を利用してリモートにあるリポジトリをローカルに取得する。
[1.mirror-ttssh2.sh](1.mirror-ttssh2.sh) を使う。
## svndumpfilter
* `svnadmin dump` でダンプファイルを出力する。
* パイプでつないで、`svndumpfilter` で不要なファイルをフィルタリングする。
* パイプでつないで、`svnadmin load` で別のリポジトリにコミットする。
[2.filter-svndmp.sh](2.filter-svndmp.sh) を使う。
## svn log
オリジナルとフィルタリングした SVN のログを取得する。
[3.svnlog.sh](3.svnlog.sh) を使う。
## svn-all-fast-export
* ルールファイル [input.rules](input.rules) を指定して `svn-all-fast-export` で変換する。
* [convert-svn-log.py](convert-svn-log.py) でログを修正する (revision, issue をリンクに変換して追記)
[4.migrate.sh](4.migrate.sh) を使う。
## git repack
* `git repack` で git リポジトリサイズを減らす
[5.git-repack.sh](5.git-repack.sh) を使う。
https://techbase.kde.org/Projects/MoveToGit/UsingSvn2Git#Checking_for_proper_history_in_the_new_git_repository
# 制限事項
* ([svn-all-fast-export](https://manpages.ubuntu.com/manpages/trusty/man1/svn-all-fast-export.1.html) で仮の値として [user-list.csv](user-list.csv) をもとに [make-identity-map.py](make-identity-map.py) で `identity-map` (svn ユーザー名と git の committer の対応関係) を生成して を渡して変換している。
# リビジョングラフ
[TortoiseGitによるリビジョングラフ](ttssh2.svg)
リンクを押したあと RAW を選ぶ。
グラフが巨大なのでスクロールして確認したところに移動する。
# 成果物
| 説明 | パス | GitHub Actions の artifacts でダウンロード |
| ---- | ---- | ---- |
| svnリポジトリ(オリジナル) | `workdir/ttssh2.org` | × (省略) |
| svnリポジトリ(フィルター後) | `workdir/ttssh2` | 〇 |
| `svn log` (オリジナル) | `workdir/svn-org.log` | 〇 |
| `svn log` (フィルター後) | `workdir/svn.log` | 〇 |
| gitリポジトリ | `workdir/gitdir/ttssh2` | 〇 |
## 成果物のダウンロード
* ブラウザでも [GitHub CLI](https://cli.github.com/) でもダウンロードできる。
* [GitHub CLI](https://cli.github.com/) を使うとコマンドラインで成果物をダウンロードできる。
* コマンドで workflow の列挙ができる。
* Tera Term 4.106 で Linux などに接続して gh を実行する場合 `⢿` や `✓ ` は文字化けして `?` のように表示される。
* [Tera Term 5.0 alpha1](https://osdn.net/projects/ttssh2/releases/77170) の場合は文字化けしない。
## GitHub CLI
[GitHub CLI](https://cli.github.com/) (=`gh` コマンド) を利用すると GitHub に関する様々な操作をコマンドで実行することができる。
参考
* https://cli.github.com/
* https://snowsystem.net/cloud/github/github-cli-install/
### 準備
* [GitHub CLI](https://cli.github.com/) からダウンロードしてインストールする。(Windows, Linux どちらでも OK)
* [gh auth login](https://cli.github.com/manual/gh_auth_login) で GitHub にログインする
```
gh auth login
```
### workflow の列挙
[gh run list](https://cli.github.com/manual/gh_run_list) で最近の workflow を列挙する。
この中で、ダウンロードしたいビルドの `ID` をメモる。
#### 該当リポジトリと同じディレクトリで実行する場合
```
gh run list
```
#### 該当リポジトリと異なるディレクトリで実行する場合
```
gh -R m-tmatma/ttssh2migrate run list
```
具体例
```
$ gh -R m-tmatma/ttssh2migrate run list
STATUS TITLE WORKFLOW BRANCH EVENT ID ELAPSED AGE
✓ Run Run main schedule 3556843090 9m30s 52m
...
```
### 成果物のダウンロード
* [gh run download](https://cli.github.com/manual/gh_run_download) コマンドで成果物をダウンロードできる。
### ダウンロードの進捗表示
* gh で成果物をダウンロードする場合、`⢿` のような文字で進捗表示される。(処理が終わると消える。)
* Tera Term 4.106 で接続して gh を実行する場合は`⢿` のように表示されず `?` のように表示される。
* [Tera Term 5.0 alpha1](https://osdn.net/projects/ttssh2/releases/77170) の場合は文字化けしない。
#### 具体例: `ID 3556843090` の成果物をダウンロードする場合
```
gh run download 3556843090
```
#### 具体例: `ID 3556843090` で名前に `GIT` を含む成果物をダウンロードする場合
```
gh run download 3556843090 -p "*GIT*"
```
#### 具体例: `ID 3556843090` で名前に `GIT` を含む成果物を指定したディレクトリ(`artifacts-3556843090`) にダウンロードする場合
```
gh run -D artifacts-3556843090 download 3556843090 -p "*GIT*"
```
## 成果物のgitリポジトリをGitHubにpush
ブラウザでも gh コマンドでもいいので変換したGITリポジトリをダウンロードする
### GITリポジトリを展開
```
tar xf ttssh2-git.tar.bz2
```
### push 先のリポジトリを用意
ブラウザでも gh コマンドでもいいので、push 先のリポジトリを作成する。
gh コマンドの場合は以下コマンド
```
gh repo create
```
https://cli.github.com/manual/gh_repo_create
### GITリポジトリをすべて push
```
cd ttssh2
git push --mirror Push先のURL
```
#### 具体例: (Push先のURL の部分が https://github.com/m-tmatma/ttssh2-work.git)
```
cd ttssh2
git push --mirror https://github.com/m-tmatma/ttssh2-work.git
```