ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。
記事のバージョン: Enterprise Server 2.14

このバージョンの GitHub Enterprise はこの日付をもって終了となります: このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2019-07-12. 重大なセキュリティ上の問題があっても、パッチはリリースされなくなります。優れたパフォーマンス、改善されたセキュリティ、そして新しい機能のために、GitHub Enterprise の最新バージョンにアップグレードしてください。 アップグレードに関するヘルプについては、GitHub Enterprise Support に連絡してください。

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

移行データをインポートする前に、コンフリクトを解決するために修正をしたり、入力レコードの名前を変えたり、入力レコードを既存のレコードにマップしたりできます。

コンフリクトを解決したり、移行にカスタムマッピングを追加したりするために、以下のステップが利用できます。

コンフリクトの解決

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.csvtarget_urlmonalisaを指すように変更できます。

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_urlocto-org/amazing-widgetsに、recommend_actionrenameに変更してください。

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 状態
ユーザ 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がまだコンフリクトがあると報告してきたなら、移行のコンフリクト解決のプロセスをもう一度行ってください。

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください