安装和配置 GitHub Enterprise Importer

步骤 1：安装 GL2GH extension of the GitHub CLI

GitHub Enterprise Importer 是扩展 GitHub CLI的集合。 如果这是你的第一次迁移，则需要安装 GitHub CLI 和 GL2GH extension。

1. 安装 GitHub CLI。

   • 有关 GitHub CLI 的安装说明，请参阅 GitHub CLI 存储库。
   • 如果已安装 GitHub CLI ，请运行 gh --version 以确保运行版本 2.4.0 或更高版本。 如果有较旧版本，请访问 GitHub CLI 存储库 以获取升级说明。

2. 安装 GL2GH extension。

   Shell

   gh extension install github/gh-gl2gh
   

3. 更新 GL2GH extension of the GitHub CLI 频率。 为了确保使用的是最新版本，请更新扩展。

   Shell

   gh extension upgrade github/gh-gl2gh
   

步骤 2：设置环境变量

必须先创建GL2GH extension可以访问源和目标的 S，然后将其设置为GitHub Enterprise Cloud环境变量，然后才能使用personal access token迁移到personal access token该源和目标。

1. 确保已准备好 personal access token两者 GitHub ，并准备好 GitLab。 如果尚未创建令牌，请参阅 管理从 GitLab 迁移到 GitHub的访问 。

2. 为personal access token设置环境变量，将以下命令中的 TOKEN 替换为之前创建的personal access token。 用于 GH_PAT 目标组织和 GITLAB_PAT 源 GitLab 实例。

   • 如果使用终端，请使用 export 命令。

     Shell

     export GH_PAT="TOKEN"
     export GITLAB_PAT="TOKEN"
     

   • 如果使用 PowerShell，请使用 $env 命令。

     Shell

     $env:GH_PAT="TOKEN"
     $env:GITLAB_PAT="TOKEN"
     

3. 如果要迁移到 带有数据驻留权的 GitHub Enterprise Cloud，为方便起见，请为企业 的基本 API URL 设置环境变量。

   确保将 SUBDOMAIN 替换为您企业的子域。 例如，如果企业的子域为 acme，则 TARGET_API_URL 值为 https://api.acme.ghe.com。

   • 如果使用终端，请使用 export 命令。

     Shell

     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   • 如果使用 PowerShell，请使用 $env 命令。

     Shell

     $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   你将将此变量与在命令中运行--target-api-url的选项一起使用GitHub CLI。