GitLab から GitHub にリポジトリを移行する

試用版の実行を実行し、リポジトリを GitLab から GitHub に移行します。

Run your migration

7 件中 6 件目
次へ:フォローアップ タスク

この記事で

Prerequisites

  • このガイドの前のすべてのフェーズを完了している必要があります。
  • GitLab プロジェクトはエクスポートに対して有効にする必要があります。 GitLab ドキュメントのインポートについては、「プロジェクトのエクスポートと Sidekiq の構成を有効にする」を参照してください。
  • 移行されるデータと、Importer の既知のサポート制限事項を理解していることを確認します。 詳細については、 AUTOTITLE を参照してください。
  • 必須ではありませんが、運用環境の移行の間は作業を停止することをお勧めします。 Importer は差分移行をサポートしていないため、移行中に発生した変更は移行されません。 運用環境の移行の間に作業を停止しない場合は、これらの変更を手動で移行する必要があります。

試用版の実行

企業固有の問題を明らかにするために、移行の試用を実行することを強くお勧めします。 試用版の実行では、次の内容について学習します。

  • 特定のリポジトリの移行が正常に完了できるかどうか。
  • 移行されたリポジトリを実行可能な状態に戻すことができるかどうか。
  • 移行の実行にかかる時間。

試用版の実行はいつでも実行でき、移行中に作業を停止する必要はありません。 試験的移行の完了にかかる時間を短縮するには、試験的実行のバッチを連続してスケジュールできます。 それらのリポジトリのユーザーは、都合のよいときに結果を検証できます。

  1. 試用版の移行のテスト用 Organization を作成します。

    すべての試験的実行に 1 つの Organization を使うことも、目的の移行先 Organization ごとに 1 つのテスト Organization を作成することもできます。 Organization が移行検証のみを目的としており、運用環境向けではないことを明確にするために、Organization 名の末尾に -sandbox を含めることを検討してください。 終わったら、テスト Organization を削除してかまいません。

  2. 試験的移行を実行します。

  3. フォローアップ タスク でフォローアップ タスクを完了できることを確認します。

  4. 移行の結果を検証するようにユーザーに依頼します。

  5. 試験的移行によって明らかになった問題を解決します。

  6. 必要に応じて、テスト用の Organization を削除します。

1 つのリポジトリの移行

1 つのリポジトリを移行するには、 gh gl2gh migrate-repo コマンドを使用します。

Shell
gh gl2gh migrate-repo \
  --gitlab-server-url GITLAB_SERVER_URL \
  --gitlab-group SOURCE_GROUP \
  --gitlab-project SOURCE_PROJECT \
  --github-org DESTINATION \
  --github-repo NEW_REPO_NAME \
  --use-github-storage

上のコマンドのプレースホルダーを次の値に置き換えます。

プレースホルダー価値
GITLAB_SERVER_URL
https://gitlab.comやhttps://gitlab.example.comなど、GitLab インスタンスの完全な URL。
SOURCE_GROUPプロジェクトを含むグループまたは名前空間の完全なパス。 入れ子になったサブグループの場合は、 parent-group/subgroupなどの完全なパスを使用します。
SOURCE_PROJECT移行する GitLab プロジェクト。
先
GitHubの宛先組織。
NEW_REPO_NAME
GitHub上のリポジトリの名前。

GitHub-owned blob storageを使用していない場合は、「AUTOTITLE」を参照してください。

追加の引数

引数Description
--target-repo-visibility新しいリポジトリの可視性を public、 private、または internalに設定します。 既定値は private です。
--target-api-url TARGET-API-URLGHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。
--target-uploads-url TARGET-UPLOADS-URLGHE.comに移行し、GitHub-owned blob storageを使用している場合は、--target-uploads-url TARGET-UPLOADS-URLも追加します。ここで、TARGET-UPLOADS-URL は、企業のサブドメインのベース アップロード API URL です。 たとえば、 https://uploads.octocorp.ghe.comと指定します。 既定値は https://uploads.github.com です。
--no-ssl-verify
GL2GH extensionが GitLab インスタンスと通信するときに SSL 検証を無効にします。 これは、GitLab インスタンスで自己署名証明書が使用されている場合にのみ使用します。 その他のすべての手順では、引き続き SSL が確認されます。
--archive-url URLGitLab からプロジェクトを再度エクスポートするのではなく、以前にエクスポートしたアーカイブを URL からインポートします。
--archive-path PATHGitLab からプロジェクトを再度エクスポートするのではなく、以前にエクスポートしたアーカイブをローカル ファイル パスからインポートします。
--keep-archiveアップロードが成功した後に削除するのではなく、エクスポート アーカイブをローカルに保持します。

移行スクリプトの生成

複数のリポジトリを一度に GitHub Enterprise Cloud に移行する場合は、 GitHub CLI を使用して移行スクリプトを生成します。 結果のスクリプトには、リポジトリごとに 1 つの migrate-repo コマンドが含まれています。

移行スクリプトを生成するには、gh gl2gh generate-script コマンドを実行します。

Shell
gh gl2gh generate-script \
  --gitlab-server-url GITLAB_SERVER_URL \
  --github-org DESTINATION \
  --output FILENAME \
  --use-github-storage

上のコマンドのプレースホルダーを次の値に置き換えます。

プレースホルダー価値
GITLAB_SERVER_URL
https://gitlab.comやhttps://gitlab.example.comなど、GitLab インスタンスの完全な URL。
先
GitHubの宛先組織。
FILENAME結果の移行スクリプトのファイル名

ターミナルを使っている場合は、生成されたスクリプトの実行に PowerShell が必要なので、.ps1 ファイル拡張子を使います。 Mac 用または Linux 用の PowerShell をインストールできます。

既定では、スクリプトにはトークンがアクセスできるすべてのプロジェクトが含まれます。 スクリプトのスコープを設定するには、1 つのプロジェクトの --gitlab-group GROUPまたは --gitlab-group GROUP --gitlab-project PROJECT を追加します。

GitHub-owned blob storageを使用していない場合は、「BLOB ストレージを構成する」を参照してください。

追加の引数

引数Description
--target-api-url TARGET-API-URLGHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。
--target-uploads-url TARGET-UPLOADS-URLGHE.comに移行し、GitHub-owned blob storageを使用している場合は、--target-uploads-url TARGET-UPLOADS-URLも追加します。ここで、TARGET-UPLOADS-URL は、企業のサブドメインのベース アップロード API URL です。 たとえば、 https://uploads.octocorp.ghe.comと指定します。 既定値は https://uploads.github.com です。

移行スクリプトの確認

スクリプトを生成したら、ファイルを確認し、必要に応じてスクリプトを編集します。

  • 移行したくないリポジトリがある場合は、対応する行を削除するかコメントにします。
  • 移行先の Organization でリポジトリに別の名前を使う場合は、対応する --github-repo フラグの値を更新します。
  • 新しいリポジトリの可視性を変更する場合は、対応する --target-repo-visibility フラグを追加または更新します。

リポジトリを移行する

試用の実行が成功し、フォローアップ タスクを完了できた場合は、実際の移行に進むことができます。

警告

移行するリポジトリの作業は停止することをお勧めします。 移行中または移行後に行われた変更は、手動で移行する必要があります。

生成したスクリプトを実行します。 次のコマンドの FILENAME を、スクリプトの生成時に指定したファイル名に置き換えます。

  • ターミナルを使っている場合は、./ を使います。

    Shell
    ./FILENAME

  • PowerShell を使っている場合は、.\ を使います。

    Shell
    .\FILENAME