Install and configure GitHub Enterprise Importer

Install the GL2GH extension of the GitHub CLI and configure your environment for the migration.

Run your migration

7 篇中的第 4 篇
下一步:Configure blob storage

在本文中

Step 1: Install the GL2GH extension of the GitHub CLI

GitHub Enterprise Importer is a collection of extensions for GitHub CLI. If this is your first migration, you'll need to install GitHub CLI and the GL2GH extension.

  1. Install the GitHub CLI.

    • 有关 GitHub CLI 的安装说明，请参阅 GitHub CLI 存储库。
    • If you already have GitHub CLI installed, run gh --version to ensure you're running version 2.4.0 or newer. If you have an older version, visit the GitHub CLI repository for upgrade instructions.

  2. Install the GL2GH extension.

    Shell
    gh extension install github/gh-gl2gh

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

    Shell
    gh extension upgrade github/gh-gl2gh

Step 2: Set environment variables

Before you can use the GL2GH extension to migrate to GitHub Enterprise Cloud, you must create personal access tokens that can access the source and destination, then set the personal access tokens as environment variables.

  1. Make sure you have your personal access tokens for both GitHub and GitLab ready. See Manage access for a migration from GitLab to GitHub if you haven't already created a token.

  2. Set environment variables for the personal access tokens, replacing TOKEN in the commands below with the personal access tokens you previously created. Use GH_PAT for the destination organization and GITLAB_PAT for the source GitLab instance.

    • If you're using Terminal, use the export command.

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

    • If you're using PowerShell, use the $env command.

      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。