手順 1: ADO2GH extension of the GitHub CLIをインストールしてください。
GitHub Enterprise Importer は、GitHub CLI の拡張機能のコレクションです。 これが最初の移行である場合は、 GitHub CLI と ADO2GH extensionをインストールする必要があります。
-
GitHub CLIをインストールします。- GitHub CLI のインストール手順については、GitHub CLI リポジトリを参照してください。
-
GitHub CLIが既にインストールされている場合は、`gh --version`を実行して、バージョン 2.4.0 以降を実行していることを確認します。 古いバージョンをお持ちの場合は、 [GitHub CLI リポジトリ](https://github.com/cli/cli#installation) にアクセスしてアップグレード手順を確認してください。
-
ADO2GH extensionをインストールします。Shell gh extension install github/gh-ado2gh
gh extension install github/gh-ado2gh -
ADO2GH extension of the GitHub CLIは毎週更新されます。 最新バージョンを確実に使うため、拡張機能を更新してください。Shell gh extension upgrade github/gh-ado2gh
gh extension upgrade github/gh-ado2gh
ADO2GH extension に関するヘルプが必要なときはいつでも、コマンドで --help フラグを使用できます。 たとえば、gh ado2gh --help とすると使用可能なすべてのコマンドの一覧が表示され、gh ado2gh migrate-repo --help とすると migrate-repo コマンドで使用できるすべてのオプションの一覧が表示されます。
手順 2: 環境変数を設定する
ADO2GH extensionを使用してGitHub Enterprise Cloudに移行するには、移行元と移行先の組織にアクセスできるpersonal access tokenを作成してから、personal access tokenを環境変数として設定する必要があります。
1.
personal access tokenがGitHubとAzure DevOpsの両方に対して用意されていることを確認します。 トークンをまだ作成していない場合は、 アクセスの管理 を参照してください。
1.
personal access tokenの環境変数を設定します。次のコマンドの TOKEN は、前に作成したpersonal access tokenに置き換えます。 移行先の Organization には GH_PAT を使い、移行元の Organization には ADO_PAT を使います。
-
ターミナルを使っている場合は、
exportコマンドを使います。Shell export GH_PAT="TOKEN" export ADO_PAT="TOKEN"
export GH_PAT="TOKEN" export ADO_PAT="TOKEN" -
PowerShell を使っている場合は、
$envコマンドを使います。Shell $env:GH_PAT="TOKEN" $env:ADO_PAT="TOKEN"
$env:GH_PAT="TOKEN" $env:ADO_PAT="TOKEN"
-
データ所在地付き 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"
export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com" -
PowerShell を使っている場合は、
$envコマンドを使います。Shell $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
$env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
この変数は、
--target-api-urlで実行するコマンドの GitHub CLI オプションと共に使用します。 -