Enterprise へのデータ移行の準備

移行したデータを GitHub Enterprise Server にインポートするための準備

1. scp コマンドを使って、ソースインスタンスまたは Organization から生成された移行アーカイブを GitHub Enterprise Server ターゲットにコピーします:

   $ scp -P 122 /path/to/archive/MIGRATION_GUID.tar.gz admin@hostname:/home/admin/

2. サイトアドミンとしてターゲットのGitHub Enterprise ServerインスタンスにSSHでアクセスしてください。

   $ ssh -p 122 admin@HOSTNAME

3. ghe-migrator prepare コマンドを使ってターゲットインスタンスにインポートするためのアーカイブを準備し、次のステップで使用する新たな移行 GUID を生成します。

   ghe-migrator prepare /home/admin/MIGRATION_GUID.tar.gz

   • 新たにインポートを試みるには、再び ghe-migrator prepare を実行して、新しい Migration GUID を取得します。
   • マイグレーションファイルをステージングする場所を指定するには、コマンドの末尾に--staging-path=/full/staging/pathを追加してください。 デフォルトは/data/user/tmpです。

移行のコンフリクトのリストの生成

1. ghe-migrator conflicts コマンドに移行 GUID を付けて実行し、conflicts.csv ファイルを生成します。

   $ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv

   • コンフリクトが報告されなければ、「Enterprise にデータを移行する」のステップに従って安全にデータをインポートできます。
2. コンフリクトがある場合は、scp コマンドを使って conflicts.csv をローカルコンピュータにコピーします。

   $ scp -P 122 admin@hostname:conflicts.csv ~/Desktop

3. 「移行コンフリクトの解決もしくはカスタムマッピングのセットアップ」に進みます。

移行コンフリクトのレビュー

1. テキストエディタもしくはCSV互換のスプレッドシートソフトウェアを使ってconflicts.csvをオープンしてください。
2. 以下の例とリファレンスのガイダンスと共にconflicts.csvファイルをレビューし、インポートの際に適切なアクションが取られることを確認してください。

conflicts.csvファイルには、コンフリクトの移行マップと推奨アクションが含まれています。 移行マップは、ソースから移行されるデータと、そのデータがどのようにターゲットに適用されるかのリストです。

model_name	source_url	target_url	recommended_action
ユーザ	https://example-gh.source/octocat	https://example-gh.target/octocat	map
Organization	https://example-gh.source/octo-org	https://example-gh.target/octo-org	map
リポジトリ	https://example-gh.source/octo-org/widgets	https://example-gh.target/octo-org/widgets	rename
Team	https://example-gh.source/orgs/octo-org/teams/admins	https://example-gh.target/orgs/octo-org/teams/admins	マージ

conflicts.csvの各行には以下の情報があります。

名前	説明
model_name	変更されるデータの種類。
source_url	データのソースURL。
target_url	期待されるデータのターゲットURL。
recommended_action	データをインポートする際にghe-migratorが行う推奨のアクション。

各レコードタイプで可能なマッピング

データの転送時にghe-migratorが行えるマッピングアクションは複数あります。

action	説明	適用可能なモデル
import	（デフォルト）ソースからのデータがターゲットにインポートされます。	すべてのレコードタイプ
map	ソースからのデータがターゲット上の既存のデータで置き換えられます。	Users、organizations、repositories
rename	ソースからのデータは名前が変更されてターゲットにコピーされます。	Users、organizations、repositories
map_or_rename	ターゲットが存在する場合、そのターゲットにマップします。 そうでない場合はインポートされたモデルの名前を変更します。	ユーザ
マージ	ソースからのデータはターゲット上の既存のデータと組み合わされます。	Team

conflicts.csv ファイルを見直し、ghe-migrator audit を使って適切なアクションがとられることを確認するよう強くお勧めします。問題がないようであれば、「Enterprise へのデータの移行」に進むことができます。

移行コンフリクトの解決もしくはカスタムマッピングのセットアップ

ghe-migratorが正しくない変更を行うと考えられるときは、conflicts.csv内でデータを変更することによって修正をかけられます。 conflicts.csv内の任意の行を変更できます。

たとえばソースのoctocatユーザがターゲットのoctocatにマップされていることに気づいたとしましょう。

model_name	source_url	target_url	recommended_action
ユーザ	https://example-gh.source/octocat	https://example-gh.target/octocat	map

このユーザをターゲット上の他のユーザにマップさせることができます。 octocatが実際にはターゲットのmonalisaだということを知っているとしましょう。 conflicts.csvの target_urlをmonalisaを指すように変更できます。

model_name	source_url	target_url	recommended_action
ユーザ	https://example-gh.source/octocat	https://example-gh.target/monalisa	map

もう1つの例として、もしもocto-org/widgetsリポジトリをターゲットインスタンス上ではocto-org/amazing-widgetsに名前を変えたいとすれば、target_urlをocto-org/amazing-widgetsに、recommend_actionをrenameに変更してください。

model_name	source_url	target_url	recommended_action
リポジトリ	https://example-gh.source/octo-org/widgets	https://example-gh.target/octo-org/amazing-widgets	rename

カスタムマッピングの追加

移行における一般的なシナリオは、移行されたユーザがターゲット上ではソース上とは異なるユーザ名を持つことです。

ソースのユーザ名のリストとターゲットのユーザー名のリストがあれば、カスタムマッピングのCSVファイルを構築し、各ユーザのユーザ名とコンテンツが移行の終了時点で正しく割り当てられているようにそのファイルを適用できます。

ghe-migrator auditを使えば、カスタムマッピングを適用するのに必要なCSV形式で、移行されるユーザのCSVを素早く生成できます。

$ ghe-migrator audit -m user -g MIGRATION_GUID > users.csv

これで、このCSVを編集してマップあるいは名前を変更したい各ユーザに新しいURLを入力し、4番目の列をmapあるいはrenameを適切に更新できます。

たとえばユーザoctocatの名前をターゲットhttps://example-gh.target上でmonalisaに変更したいのであれば、以下の内容の行を作成します。

model_name	source_url	target_url	state
ユーザ	https://example-gh.source/octocat	https://example-gh.target/monalisa	rename

同じプロセスは、カスタムマッピングをサポートする各レコードのマッピングを作成するために使うことができます。 詳しい情報についてはレコードに可能なマッピング上のテーブルを参照してください。

修正された移行データの適用

1. 変更を加えた後、修正された conflicts.csv (または適切な形式のその他のマッピング .csv) を scp コマンドを使ってターゲットインスタンスに適用します。

   $ scp -P 122 ~/Desktop/conflicts.csv admin@hostname:/home/admin/

2. 修正された .csv ファイルへのパスと移行 GUID を渡して、ghe-migrator map を使い、移行データを再マップします。

   $ ghe-migrator map -i conflicts.csv  -g MIGRATION_GUID

3. ghe-migrator map -i conflicts.csv -g MIGRATION_GUID がまだコンフリクトがあると報告してきた場合、移行のコンフリクト解決のプロセスをもう一度行ってください。