インポートしたデータを GitHub Enterprise Server に適用する
データを GitHub Enterprise Server に移行するには、事前にデータを準備し、競合を解決する必要があります。 詳しくは、「GitHub Enterprise Server へのデータ移行の準備」を参照してください。
データを準備して競合を解決したら、インポートしたデータを GitHub Enterprise Cloud に適用できます。
ssh -p 122 admin@HOSTNAME
-
ghe-migrator import
コマンドを使用して、インポート プロセスを開始します。 必要なものは次のとおりです。- 移行 GUID。 詳しくは、「GitHub Enterprise Server へのデータ移行の準備」を参照してください。
- 認証のための personal access token。 使う personal access token はサイト管理者としての認証専用です。特定のスコープまたはアクセス許可は必要ありません。 詳しくは、「個人用アクセス トークンを管理する」を参照してください。
$ ghe-migrator import /home/admin/MIGRATION-GUID.tar.gz -g MIGRATION-GUID -u USERNAME -p TOKEN > Starting GitHub::Migrator > Import 100% complete /
- 移行ファイルをステージングする場所を指定するには、
--staging-path=/full/staging/path
を使用してコマンドを追加します。 既定値は/data/user/tmp
です。
移行データのレビュー
既定では、ghe-migrator audit
はすべてのレコードを返します。 また、以下の条件でレコードをフィルタリングすることもできます。
- レコードのタイプ。
- レコードの状態。
レコードの種類は、移行されたデータで見つかったものと一致します。
レコードタイプのフィルタ
レコード タイプ | フィルター名 |
---|---|
ユーザー | user |
組織 | organization |
リポジトリ | repository |
Teams | team |
マイルストーン | milestone |
プロジェクトボード | project |
発行 | issue |
Issueのコメント | issue_comment |
Pull Request | pull_request |
プルリクエストのレビュー | pull_request_review |
コミットのコメント | commit_comment |
プルリクエストのレビューのコメント | pull_request_review_comment |
リリース | release |
プルリクエストあるいはIssueに対して行われたアクション | issue_event |
保護されたブランチ | protected_branch |
レコードの状態フィルタ
レコードの状態 | 説明 |
---|---|
export | レコードはエクスポートされます。 |
import | レコードはインポートされます。 |
map | レコードはマップされます。 |
rename | レコードの名前が変更されます。 |
merge | レコードはマージされます。 |
exported | レコードはエクスポートに成功しました。 |
imported | レコードはインポートに成功しました。 |
mapped | レコードはマップに成功しました。 |
renamed | レコードの名前の変更に成功しました。 |
merged | レコードはマージに成功しました。 |
failed_export | レコードはエクスポートに失敗しました。 |
failed_import | レコードはインポートに失敗しました。 |
failed_map | レコードはマップに失敗しました。 |
failed_rename | レコードの名前の変更に失敗しました。 |
failed_merge | レコードはマージに失敗しました。 |
監査されたレコードのフィルタリング
ghe-migrator audit
コマンドを使用すると、-m
フラグを使用してレコードの種類に基づいてフィルター処理できます。 同様に、-s
フラグを使用してインポート状態をフィルター処理できます。 次のようなコマンドです。
ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION-GUID
たとえば、インポートに成功したすべてのOrganizationとチームを見るには以下のようにします。
$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION-GUID
> model_name,source_url,target_url,state
> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed
失敗したすべてのインポートを監査することを強くお勧めします。 これを行うには、次のように入力します。
$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION-GUID
> model_name,source_url,target_url,state
> user,https://gh.source/octocat,https://gh.target/octocat,failed
> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed
失敗したインポートに関する懸念があるなら、GitHub Enterprise サポートに連絡してください。
GitHub Enterprise Server でインポートを完了する
ターゲットインスタンスへの移行が適用され、その内容を確認したら、リポジトリのロックを解除して、ソースから削除します。 ソースデータを削除する前に、すべてが期待どおりに機能していることを確認するため2週間ほど待つことをおすすめします。
ターゲットインスタンス上でのリポジトリのアンロック
-
GitHub.com に SSH で接続します。 インスタンスが複数のノードで構成されている場合は (高可用性や geo レプリケーションが構成されている場合など)、プライマリ ノードに SSH 接続します。 クラスターを使用する場合は、任意のノードに SSH 接続できます。 SSH アクセスについて詳しくは、「管理シェル (SSH) にアクセスする」をご覧ください。
ssh -p 122 admin@HOSTNAME
-
ghe-migrator unlock
コマンドを使用して、インポートされたすべてのリポジトリのロックを解除します。 移行GUIDが必要になります。
$ ghe-migrator unlock -g MIGRATION-GUID
> Unlocked octo-org/octo-project
警告: schedule
トリガーを使用してリポジトリに GitHub Actions ワークフローが含まれている場合、ワークフローはインポート後に自動的に実行されません。 スケジュールされたワークフローをもう一度開始するには、リポジトリにコミットをプッシュします。 詳しくは、「ワークフローをトリガーするイベント」を参照してください。
ソース上でのリポジトリのアンロック
GitHub.com で Organization からリポジトリのロックを解除する
GitHub.com Organization のリポジトリのロックを解除するには、DELETE
要求を移行ロック解除エンドポイントに送信します。 必要なものは次のとおりです。
- 認証のためのアクセストークン
- 移行の一意の
id
- アンロックするリポジトリの名前
curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
-H "Accept: application/vnd.github.wyandotte-preview+json" \
https://api.github.com/orgs/ORG-NAME/migrations/ID/repos/REPO_NAME/lock
GitHub.com で Organization からリポジトリを削除する
GitHub.com Organization のリポジトリのロックを解除した後、リポジトリ削除エンドポイントを使用して以前に移行したすべてのリポジトリを削除する必要があります。 認証のためのアクセストークンが必要になります。
curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
https://api.github.com/repos/ORG-NAME/REPO_NAME
GitHub Enterprise Server インスタンスからリポジトリをアンロックする
-
GitHub.com に SSH で接続します。 インスタンスが複数のノードで構成されている場合は (高可用性や geo レプリケーションが構成されている場合など)、プライマリ ノードに SSH 接続します。 クラスターを使用する場合は、任意のノードに SSH 接続できます。 SSH アクセスについて詳しくは、「管理シェル (SSH) にアクセスする」をご覧ください。
ssh -p 122 admin@HOSTNAME
-
ghe-migrator unlock
コマンドを使用して、インポートされたすべてのリポジトリのロックを解除します。 移行GUIDが必要になります。
$ ghe-migrator unlock -g MIGRATION-GUID
> Unlocked octo-org/octo-project