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

このバージョンの GitHub Enterprise はこの日付をもって終了となります: このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2020-05-23. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

記事のバージョン: Enterprise Server 2.17

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

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

ここには以下の内容があります:

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

コンフリクトの解決

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

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

model_namesource_urltarget_urlrecommended_action
ユーザhttps://example-gh.source/octocathttps://example-gh.target/octocatmap

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

model_namesource_urltarget_urlrecommended_action
ユーザhttps://example-gh.source/octocathttps://example-gh.target/monalisamap

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

model_namesource_urltarget_urlrecommended_action
リポジトリhttps://example-gh.source/octo-org/widgetshttps://example-gh.target/octo-org/amazing-widgetsrename

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

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

ソースのユーザ名のリストとターゲットのユーザー名のリストがあれば、カスタムマッピングの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_namesource_urltarget_url状態
ユーザhttps://example-gh.source/octocathttps://example-gh.target/monalisarename

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

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

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

担当者にお尋ねください

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

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