GitHub Organization間でRepositoryを移譲（Transfer）した際の情報の引き継ぎを確認してみた

若槻龍太

2020.06.12

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

こんにちは、CX事業本部の若槻です。

GitHubでは、Repositoryを別のUserやOrganizationアカウントに移譲（Transfer）することが可能です。次の公式ドキュメントを読む限りでは移譲機能を使えばRepository上の情報はほぼ全てをよしなに引き継いでくれるとのことです。

Transferring a repository | GitHub Help

そこで今回は、GitHub Organization間でRepositoryを移譲（Transfer）した際に本当にRepository上の情報がちゃんと引き継がれるのか？を確認してみました。

事前準備

移譲実施前に次の準備を行いました。

移譲先Orgに移譲元Orgのメンバーを所属させておく。
移譲作業用アカウントを移譲先・移譲元OrgのOwnerにしておく。

引き継ぎ動作を確認するための情報の仕込み

Repositoryが移譲された際の引き継ぎ動作を確認するために、次の情報を移譲前のRepositoryに対して仕込みました。

commit、branch、Pull request
pacakge
release
Issue
Project
Secret
アクセス権限（有料プランのユーザー数が足りなかったため2回に分けて検証した）
- ユーザーに直接付与されたアクセス権限
- Teamを介して付与されたアクセス権限
Actionsの実行履歴
連携しているCircleのプロジェクト、CI実行履歴
連携しているTravisCIのCI実行履歴
連携しているBitriseのApp、CI実行履歴

移譲の実施

GitHubのコンソールから先ほど情報を仕込んだRepositoryの移譲を実施します。

移譲元のOrganizationでRepositoryの[Settings]タブ - [Options] - [Danger Zone]欄にて[Transfer]をクリック。

移譲先のOrganization名と移譲するRepository名を入力し、[I understand, transfer this repository.]をクリック。

※上記画面では移譲元のアカウントが有料プランなので、移譲先アカウントがFreeプランの場合に失われる情報についての警告が移譲ダイアログ内に記載されています。一方で移譲元のアカウントがFreeプランの場合は、移譲先アカウントのプランがFreeまたは有料であるかによらず失われる情報がないため、下記画面のように警告は記載されないダイアログとなります。

移譲先のOrganizationにTeamが作成されている場合は、移譲後にRead権限を自動で付与するTeamを任意で指定可能です。[Transfer]をクリックして移譲を開始します。

「Moving repository to <移譲先Org名>/<Repository名>. This may take a few minutes.」とメッセージが表示されるので移譲が完了するまで待ちます。

移譲元OrgからRepositoryが削除され、移譲先OrgでRepositoryにアクセス可能となれば移譲は完了です。

仕込んだ情報が引き継がれているかの確認

移譲先のOrganizationで移譲前にRepositoryに対して仕込んだ情報が移譲後にも引き継がれているかを確認してみます。

commit、branch、Pull request

引き継がれました。移譲後にPull RequestのMergeも実施できました。

package

引き継がれました。

release

引き継がれました。

Issue

引き継がれました。

Project

引き継がれました。ボード上のリスト、カード、Issue、Assigneesもちゃんと引き継がれていました。

Secret

引き継がれました。

Actionsの実行履歴

引き継がれました。引き継ぎ後に実行されたCIも元の実行履歴に対する新しい履歴として追加されました。

アクセス権限
- ユーザーに直接付与されたアクセス権限：引き継がれました。
- Teamを介して付与されたアクセス権限：引き継がれませんでした。（これは想定通りでした）
Circleのプロジェクト、CI実行履歴

プロジェクトは、移譲元のOrganizationの一覧からは消えており、

移譲先のOrganizationの一覧に自動で追加されていました。

移譲前のCI実行履歴は移譲後のRepositoryのプロジェクトに再紐付けされていました。また、移譲後にGitHub側で実行されたCIも元の実行履歴に対する新しい履歴として追加されました。

TravisCIのCI実行履歴

移譲元のOrganizationのRepository一覧からは消えていました。

移譲先のOrganizationのRepository一覧には追加されていました。

移譲前のCI実行履歴は移譲後のRepositoryのものに再紐付けされていました。また、移譲後にGitHub側で実行されたCIも元の実行履歴に対する新しい履歴として追加されました。

BitriseのApp、CI実行履歴

移譲されたRepositoryに紐づくAppとCI実行履歴は移譲後も同じBitrise Organizationに残ったままとなりました。移譲後にGitHub側で実行されたCIも元の実行履歴に対する新しい履歴として追加されました。

移譲後のURLリダイレクトの動作を確認してみる

Repositoryを移譲した後も仕様としてはRepositoryの旧URLへのアクセスは新URLへリダイレクトされる動作となりますが、GitHubとしてはURLを更新することを強く勧めているようです。

What's transferred with a repository? | GitHub Help

All links to the previous repository location are automatically redirected to the new location. When you use git clone, git fetch, or git push on a transferred repository, these commands will redirect to the new repository location or URL. However, to avoid confusion, we strongly recommend updating any existing local clones to point to the new repository URL.

ここでは、ドキュメントどおりに移譲後のURLリダイレクトがちゃんと動作するのかを確認してみます。

CLIでのpull、push操作

ローカルRepositoryのGitHubに対するリモートURLは移譲元Organizationのもののままの状態です。

$ git remote -v
origin  https://github.com/<移譲元Organization>/test-python-prj.git (fetch)
origin  https://github.com/<移譲元Organization>/test-python-prj.git (push)

pull操作を実施できました。

$ git pull origin master
remote: Enumerating objects: 1, done.
remote: Counting objects: 100% (1/1), done.
remote: Total 1 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (1/1), done.
From https://github.com/<移譲元Organization>/test-python-prj
 * branch            master     -> FETCH_HEAD
   9622c84..59eb0e5  master     -> origin/master
Updating 9622c84..59eb0e5
Fast-forward

push操作を実施できました。

$ git push origin fix-config
Counting objects: 3, done.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 294 bytes | 294.00 KiB/s, done.
Total 3 (delta 2), reused 0 (delta 0)
remote: Resolving deltas: 100% (2/2), completed with 2 local objects.
remote: This repository moved. Please use the new location:
remote:   https://github.com/<移譲先Organization>/test-python-prj.git
remote: 
remote: Create a pull request for 'fix-config' on GitHub by visiting:
remote:      https://github.com/<移譲先Organization>/test-python-prj/pull/new/fix-config
remote: 
To https://github.com/<移譲元Organization>/test-python-prj.git
 * [new branch]      fix-config -> fix-config