Enterprise Live Migrations を使用したリポジトリの移行

ヒント

このガイドに従うと、使用に関する詳細な情報については、AUTOTITLE を参照できます。エラーが発生した場合は、 GitHub Enterprise Server から GHE.com へのライブマイグレーションのトラブルシューティングを参照してください。

前提条件

環境と開発者が移行の準備ができていることを確認します。「GitHub Enterprise Server から GHE.com へのライブマイグレーションの準備」を参照してください。

1. GitHub Enterprise Server を設定する

トークンを作成して移行を実行する前に、 GitHub Enterprise Server インスタンスに何らかの構成を設定する必要があります。これらの構成値は、すべての ELM 移行に適用されます。 GitHub Enterprise Serverの開発者は、新しい構成を適用するときに短いダウンタイムが発生する可能性があります。

SSH 経由で GitHub Enterprise Server 管理シェルにアクセスします。「管理シェル (SSH) にアクセスする」を参照してください。

ghe-configを使用して、次の構成変数を設定します。

例えば： ghe-config app.elm-exporter.enabled true

Variable	これを [...] に設定します。
`app.elm-exporter.enabled`	`true`
`app.elm.internal-webhooks-enabled`	`true`
`app.elm-exporter.webhooks-loopback-address-enabled`	`true`
`secrets.elm-exporter.migration-target-url`	移行先企業の API URL (例: `https://api.octocorp.ghe.com`)。 URL の末尾に末尾のスラッシュを含めないでください。
`secrets.elm-exporter.source-user`	オペレーターの GitHub Enterprise Server トークンに関連付けられているユーザー名。これは GitHub Enterprise Serverのユーザー名にする必要があります。他のユーザーがこのトークンを作成する場合は、ここでの値をユーザー名に設定する必要があります。

ghe-admin ユーザーをお勧めします。 |

構成を適用します。
Shell
```
ghe-config-apply
```
```
ghe-config-apply
```
SSH セッションを終了します。残りのコマンドは、ローカルターミナルセッションで実行します。

2. エンタープライズアクセス権を持つオペレータートークンを作成する

オペレーターは、 personal access token (classic)を使用して、移行元企業と移行先企業の両方に対して認証を行う必要があります。トークンの作成手順については、個人用アクセストークンを管理するを参照してください。

次の手順で必要になりますので、両方のトークンをメモしておいてください。

** GitHub Enterprise Server **で、personal access token (classic)を作成し、必要なスコープを選択します。
- admin:enterprise
このトークンは、ELM CLIを構成するときにソーストークンとして使用します。
** GHE.com **で、personal access token (classic)を作成し、必要なスコープを選択します。
- admin:enterprise
- admin:org
このトークンは、ELM CLIを構成するときにターゲットトークンとして使用します。

3. ELM コマンドラインツールを構成する

GitHub CLIの拡張機能を使用して、ローカルターミナルセッションから移行を実行します。

ローカルコンピューターに GitHub CLI をインストールします。バージョン 2.0 以降を使用している必要があります。

ELM 拡張機能をインストールします。

Shell

gh extension install github/gh-elm

gh extension install github/gh-elm

インストールウィザードを起動して拡張機能を構成します。
Shell
```
gh elm configure
```
```
gh elm configure
```
インストールウィザードの指示に従って、ソースと宛先の API URL (例: https://api.SUBDOMAIN.ghe.com) と前の手順で作成したトークンを指定します。

これらの値は、任意の gh elm コマンドで CLI フラグとして指定することもできます。これは、構成よりも優先されます。たとえば、 --target-url https://api.SUBDOMAIN.ghe.comと指定します。

このセットアッププロセスでは、オペレーティングシステムの構成ディレクトリ ( gh-elm/config.json) のプラットフォーム固有の構成ファイルに URL が格納されます。アクセストークンは、コンピューターのシークレットストレージに安全に格納されます。

4. ライブマイグレーションシークレットを構成する

エンタープライズアクセス権を持つオペレータートークンに加えて、ソース組織とターゲット組織の personal access token (classic) を作成する必要があります。移行する組織ごとに、これらの手順を繰り返す必要があります。

アクセストークンを作成する

ELM は、移行元と移行先の両方の personal access token (classic) で認証する必要があります。トークンの作成手順については、個人用アクセストークンを管理するを参照してください。

これらのトークンは、次の手順で必要になりますので、必ずメモしておいてください。

personal access token (classic) で次のスコープを持つ GitHub Enterprise Server を作成します。
- repo
- admin:org
- admin:repo_hook
- admin:org_hook
これがソーストークンです。
次のスコープを使用して、personal access token (classic) 上に GHE.com を作成します。
- repo
- workflow
- admin:org
- admin:repo_hook
- admin:enterprise
これがターゲットトークンです。

重要

GHE.comでターゲット組織にシングルサインオンが適用される場合は、SSO のGHE.com トークンを承認する必要があります。

組織の ELM シークレットを構成する

gh elm config コマンドを使用して、ソースとターゲットのアクセストークンを設定します。

ソーストークンを設定します。
Shell
```
gh elm config set-source-pat EXISTING-GHES-ORG
```
```
gh elm config set-source-pat EXISTING-GHES-ORG
```
要求されたら、ソーストークンをターミナルに貼り付けます。
ターゲットトークンを設定します。
Shell
```
gh elm config set-target-pat EXISTING-GHES-ORG
```
```
gh elm config set-target-pat EXISTING-GHES-ORG
```
メッセージが表示されたら、ターゲットトークンをターミナルに貼り付けます。

トークンは、 gh elm config org-tokens EXISTING-GHES-ORGを使用して対話形式で設定することも、 https://GHES_HOSTNAME/organizations/EXISTING-GHES-ORG/settings/secrets/elm-exporter/の組織設定で設定することもできます。

5. マイグレーションを作成する

ソースリポジトリとターゲットリポジトリの詳細を指定して、新しい移行を作成します。

メモ

target-orgは新規でも既存でもかまいません。ターゲット組織がまだ存在しない場合は、移行中に作成されます。ただし、移行元組織の設定は移行されません。

Shell

gh elm migration create \
  --source-org EXISTING-GHES-ORG \
  --source-repo EXISTING-GHES-REPO \
  --target-org GHEC-ORG \
  --target-repo NEW-GHEC-REPO

gh elm migration create \
  --source-org EXISTING-GHES-ORG \
  --source-repo EXISTING-GHES-REPO \
  --target-org GHEC-ORG \
  --target-repo NEW-GHEC-REPO

例えば次が挙げられます。

gh elm migration create \
  --source-org my-ghes-org \
  --source-repo my-ghes-repo \
  --target-org my-dr-org \
  --target-repo my-dr-repo

省略可能なフラグ:

--start: 移行をすぐに開始する準備ができた場合。
--target-visibility: 移行されたリポジトリは、既定で内部可視性を使用して作成されますが、 privateを指定できます。

移行 ID を保存する

次のような応答が表示されます。

{
  "migrationId": "2b5c9eae-b5da-4306-ab04-2a29cc2b7cb9",
  "expiresAt": "2026-02-11T21:49:33.619162159Z"
}

次のコマンドに必要な migrationId を変数としてエクスポートします。例えば次が挙げられます。

export MIGRATION_ID='2b5c9eae-b5da-4306-ab04-2a29cc2b7cb9'

6. 移行を開始する

まだ移行を開始していない場合は、先ほど保存した移行 ID を使用して移行を開始します。

Shell

gh elm migration start --migration-id $MIGRATION_ID

gh elm migration start --migration-id $MIGRATION_ID

これにより、バックフィルとライブ更新プロセスが起動します。 ELM は現在、ソースリポジトリからデータを収集し、サポートされている Webhook イベントをリッスンしています。

7. 移行を監視する

移行が開始されると、 GHE.comに新しいリポジトリが表示されます。移行中は、開発者がソースリポジトリで作業を続ける際に、リポジトリにデータの初期読み込みが入力され、更新プログラムが受信されます。

watch コマンドを使用して、移行の進行状況を対話形式で監視できます。

gh elm migration watch $MIGRATION_ID

これにより、移行状態 API がポーリングされ、現在の進行状況を反映した自己更新テキスト UI が表示されます。

`migration status` を使用したプログラムによるモニタリング

自動化に適した移行状態が必要な場合は、 status コマンドを使用します。

Shell

gh elm migration status --migration-id $MIGRATION_ID

gh elm migration status --migration-id $MIGRATION_ID

応答で最も重要なインジケーターは、 combinedState オブジェクトの状態です。状態が COMBINED_STATUS_READY_FOR_CUTOVERに達すると、次の手順に進む準備が整います。ただし、個々のリソースの移行に失敗した場合は、 displayMessage でアラートが表示されます。調査が必要な場合があります。

例えば次が挙げられます。

  "combinedState":  {
    "status":  "COMBINED_STATUS_READY_FOR_CUTOVER",
    "displayMessage":  "Ready for cutover (1 resources failed)",
    "repositories":  [
      {
        "repositoryNwo":  "new-test-org/my-new-repo",
        "phase":  "REPOSITORY_PHASE_READY_FOR_CUTOVER",
        "displayStatus":  "Ready for cutover (1 failed)"
      }
    ],
    "readyForCutover":  true,
    "cutoverBlockers":  []
  },

ヒント:

複数の移行を実行している場合は、すべての移行の状態を gh elm migration listで確認できます。このコマンドは、既定で進行中の移行を示しますが、 --statusでフィルター処理することもできます。
注意が必要なエラー状態が発生した場合は、 GitHub Enterprise Server から GHE.com へのライブマイグレーションのトラブルシューティングを参照してください。

8. 移行を完了する

カットオーバーに向けて移行準備ができたら、移行を完了できます。カットオーバープロセスによってソースリポジトリがアーカイブされ、リポジトリ管理者がアーカイブを解除しない限り 、完全に読み取り専用 になります。

Shell

gh elm migration cutover --migration-id $MIGRATION_ID

gh elm migration cutover --migration-id $MIGRATION_ID

引き続き移行を監視します。応答の上部に MIGRATION_STATUS_COMPLETED の状態が表示されると、移行は完了しますが、 GitHub Enterprise Serverからユーザーにアクセス権を付与するためのフォローアップタスクがいくつかあります。

次のステップ

ユーザーに新しいリポジトリへのアクセス権を付与し、ユーザーアカウントを使用してアクティビティを調整します。「GitHub Enterprise Server から GHE.com へのライブマイグレーションの完了」を参照してください。

Enterprise Live Migrations を使用したリポジトリの移行

この機能を使用できるユーザーについて

この記事で

前提条件

1. GitHub Enterprise Server を設定する

2. エンタープライズアクセス権を持つオペレータートークンを作成する

3. ELM コマンドラインツールを構成する

4. ライブマイグレーションシークレットを構成する

アクセストークンを作成する

組織の ELM シークレットを構成する

5. マイグレーションを作成する

移行 ID を保存する

6. 移行を開始する

7. 移行を監視する

`migration status` を使用したプログラムによるモニタリング

8. 移行を完了する

次のステップ

このドキュメントは役に立ちましたか?

まだ助けが必要ですか？