先人の知恵・知見に感謝
Qiitaの 'GitHubでFork/cloneしたリポジトリを本家リポジトリに追従する' という記事をもとにした。
やりたいこと
要約
上記掲載の記事を参考とし、Tagへの追従が必要だったので以下手順を作成した。
このエントリーはよりよい方法が確立でき次第更新する。
- 他に作成されているGit repoをもとにする
- 独自のpatchなどを適用したい
- conflictする/元ソースへの影響を出したくないなどの理由によりpull requestなどは行う予定がない
- 将来的にもとのGit repoが更新された際にも追従したい
- 参照元repoのbranchやtagについて指定を行う必要がある
現物
実際にやりたかったことは以下の通り。
- https://github.com/df8oe/UHSDR の安定版における最新リリース(tagで指定出来る)を取得
- 日本のバンドプランに合わせた調整(5MHz送出禁止/7MHz調整など)
- 調整したソースコードをbuild
- 新しいリリースが出た際には随時追従
ToDo
継続的に参照元からのpullと手許masterでの継続的作業の検証。
全体を見通す
git clone git@github.com:${MYNAME}/${MYREPO}.git
cd ${MYREPO}
git remote add upstream https://github.com/${YOURNAME}/${YOURREPO}.git
git ls-remote --tags upstream
git pull upstream tag ${YOURTAG} --allow-unrelated-histories
(edit)
git add -A
git tag ${YOURTAG}
git commit -m "${MYCOMMITMSG}"
git push origin ${YOURTAG}JA
事前準備
自分のrepoを準備する
下記例にてすでに存在するGitHub repoのclone方法を示す。
Repo自体の作成方法はここでは扱わない。
git clone git@github.com:${MYNAME}/${MYREPO}.git
cd ${MYREPO}
参照したいrepoを登録する
下記例にて参照したいGit repoを upstream にて扱う方法を示す。
git remote add upstream https://github.com/${YOURNAME}/${YOURREPO}.git
継続的適用
pullしたいtagを確認する
upstream のタグ一覧を取得する。
git ls-remote --tags upstream
Tagを指定した上でpullする
upstream の中から必要とするtagを指定し master (すでに指定しているbranch)へのmergeを行う。
git pull upstream tag ${YOURTAG} --allow-unrelated-histories
修正(patch等)を実施する
vi/emacs/sed/patchなど好みの手法で実施する
編集内容をcommit/pushする
自分自身が持つrepoへのcommit/pushを行う。
タグは揃える。
git add -A
git tag ${YOURTAG}
git commit -m "${MYCOMMITMSG}"
git push origin ${YOURTAG}JA