Skip to main content
Perforce の depot を、履歴を含めて新しい Diversion リポジトリにインポートできます。 インポートはお客様が用意するマシン(インポート用マシン)上で実行され、そのマシンは Perforce サーバーにネットワーク接続できる必要があります。 Perforce のパスワードはインポート用マシンに残り、Diversion に送られることはありません。 Diversion アプリがリポジトリと API トークンを作成し、インポート用マシンに必要な設定ファイルを生成します。 その後、インポート用マシン上のスクリプトが Docker でインポートを実行し、5 分ごとに Diversion と通信します。

インポート用マシンの要件

  • 次のいずれか:
    • Linux またはその他の Unix: bash、cron、および Docker Engine 20.10 以降と Docker Compose プラグイン 2.17 以降。任意: curl と AWS CLI。ない場合、スクリプトはコンテナイメージから実行します。
    • Windows 10 または 11 と WSL 2 (Windows Subsystem for Linux)。管理者が一度セットアップする必要があります。セットアップ手順で WSL 内に Docker をインストールするため、Docker Desktop は不要です。仮想マシンでは、WSL 2 に入れ子になった仮想化 (nested virtualization) が必要です。
  • Perforce サーバー、および HTTPS で Diversion へのネットワーク接続

Diversion アプリでインポートを設定する

1

Perforce インポートページを開く

ダッシュボード にアクセスし、Import from Perforce を選択します。表示されていない場合は、右上の New repository をクリックし、Import from P4 を選択します。左上のリポジトリセレクタードロップダウンのフッターから Import from Perforce を選択することもできます (Create new repository および Import Git repository と並んでいます)。
セルフホスト環境では、これらのオプションをクリックすると代わりにリクエストフォームが開き、Diversion チームがインポートを代行します。
2

インポートスクリプトをダウンロードする

インポート用マシンのオペレーティングシステムのタブを選び、そのスクリプトをダウンロードします:
  • Linux / Unix: Download p4_import_bootstrap.sh をクリックします。
  • Windows: Download install_windows_task.ps1 をクリックします。このスクリプトは WSL 内にインポートをセットアップし、Linux 用のスクリプトをそこにダウンロードします。スクリプトファイルのため、保存前にブラウザーが警告を表示することがあります。Keep を選択してください。
スクリプトはすべてのインポートで共通で、このページからいつでもダウンロードできます。
3

新しいリポジトリに名前を付ける

リポジトリ名は depot 名から自動入力されます。必要に応じて変更してください。 リポジトリは組織に属している必要があります。組織がまだない場合は、ここで作成できます。
4

インポート設定を入力する

各欄の意味は下のインポート設定を参照してください。
5

「Create repository and import files」をクリックする

Diversion がリポジトリ、API トークン、インポート設定を作成します。
6

local.env をダウンロードする

Download local.env をクリックします。このファイルには API トークン、リポジトリ ID、Linux・Unix・Windows 用のセットアップ手順が含まれています。
この API トークンは一度しか表示されません。ページを離れる前に local.env をダウンロードしてください。ダウンロードせずに離れてしまった場合は、新しいトークンとファイルを作成できます。失った local.env を復元するを参照してください。

インポート設定

local.env を保護する

local.env には、Diversion アカウントへの管理者権限を持つ API トークンが含まれています。 パスワードと同じように扱ってください:
  • インポート用マシンだけに置き、インポートを実行するユーザーだけが読めるようにします(下の手順の chmod 600 local.env)。Windows では、セットアップスクリプトがファイルを WSL 内にコピーし、そのコピーを root だけが読めるようにして、ダウンロードフォルダーにあるファイルを削除します。
  • バージョン管理にコミットしたり、チャットやメールで共有したり、他のマシンにコピーしたりしないでください。

インポート用マシンでインポートを実行する

以下の手順は、インポートを実行するユーザー(Docker を使えるユーザー)で行ってください。sudo は使わないでください。root の crontab にスケジュールが登録されてしまいます。
1

両方のファイルを同じディレクトリに置く

p4_import_bootstrap.sh と local.env をインポート用マシンの同じディレクトリ(例: /opt/dv-p4-import)にコピーし、そのディレクトリに cd します。
2

スクリプトを実行可能にする

3

Perforce の設定を入力する

local.env を開き、ファイル末尾の Perforce 接続情報を入力します:
API_DOMAIN、API_TOKEN、REPO_ID は生成されたままにしてください。
4

local.env を保護する

5

スクリプトを一度実行して設定を確認する

初回の実行が成功すると、インポート設定をダウンロードし、Diversion のインポートイメージを取得して起動します。 出力には Remote env changed -- recreating: ... のような行が表示され、docker ps でインポートコンテナが動作していることを確認できます。 初回はイメージのダウンロードのため数分かかることがあります。
6

インポートをスケジュールする

このディレクトリからスクリプトを 5 分ごとに実行し、出力を bootstrap.log に追記する crontab エントリを追加します。 実行のたびに、停止したインポートを再起動し、設定の変更を反映します。

Perforce の設定を変更する

セットアップ時の確認では Perforce への接続はテストされません。設定が間違っている場合、インポートは停止し、docker logs に Perforce のログインエラーが表示されます。
インポート用ディレクトリの local.env を編集します。5 分以内の次回の実行で変更が反映されます。

インポートの進行状況を確認する

Diversion で新しいリポジトリを開きます。インポートが完了するまで、リポジトリページに Reading history、Preparing history、Uploading files の 3 段階で進行状況が表示されます。 履歴の準備ができると、コミット、ブランチ、ファイルが表示されます。ファイルは内容のアップロード後に開けます。 大きな depot のインポートには時間がかかります。完了するまで、インポート用マシンを起動したまま接続しておいてください。

インポートを停止・削除する

スケジュールを削除するまで、インポートは動作し続けます。
初回インポートの後も Perforce からの継続的なインポートや Perforce へのエクスポートが必要な場合は、スケジュールを削除しないでください。継続的なインポート・エクスポートを有効にするにはサポートにお問い合わせください。
インポートが完了し、継続する必要がない場合:
  1. crontab -e を実行し、p4_import_bootstrap.sh を含む行を削除します。
  2. インポート用マシンから local.env を削除します。

トラブルシューティング

スクリプトはエラーを出力に書き込み、スケジュール後はインポート用ディレクトリの bootstrap.log にも書き込みます。 Windows では、以下のコマンドをディストリビューション内で実行してください。コマンドの前に wsl -d Ubuntu-24.04 -u root --cd /root/p4-import -- を付けます。例: wsl -d Ubuntu-24.04 -u root --cd /root/p4-import -- tail -n 50 bootstrap.log。

Windows でのトラブルシューティング

ログを Diversion サポートに送信する

インポートが失敗または停止し、原因がわからない場合は、そのログを Diversion サポートに送信してください。インポート用ディレクトリで次を実行します:
Windows では、代わりに PowerShell で次を実行します:
実行中のインポートは停止されません。 local.env に API_TOKEN が設定されていることを確認してください。アップロード時の認証に使用されます。設定されていない場合、アップロードは失敗します。アップロードが失敗した場合 を参照してください。 アップロードが成功すると、出力に Support bundle sent to Diversion と表示され、サポートチームがあなたの説明を受け取ります。 アップロードされるファイルには次の内容が含まれます:
  • 過去 3 日間のインポートログ。長いログは短縮されますが、先頭、末尾、およびすべての警告とエラーは保持されます。
  • インポートコンテナの最近の出力と、bootstrap.log の末尾。
  • local.env とインポート設定の内容。P4PASSWD や API_TOKEN などのシークレット設定の値は、その長さに置き換えられます。
  • インポート用マシンの基本情報: オペレーティングシステム、空きディスク容量、Docker のバージョン。

アップロードが失敗した場合

ファイルのコピーは dv-bootstrap/p4-support-bundle-<time>.tgz に残ります。アップロードが失敗した場合、スクリプトはファイルのパスを出力します。そのファイルを support@diversion.dev にメールで送信してください。

失った local.env を復元する

local.env をダウンロードする前に Import from Perforce ページを離れてしまった場合は、新しいインポートを始めないでください。リポジトリとインポート設定は既に作成されています。代わりにファイルを作り直してください。 インポートが開始されるまでは、リポジトリページで新しいファイルを作成できます:
  1. Diversion で新しいリポジトリを開きます。
  2. Lost your local.env file? の下にある Create a new local.env をクリックします。これにより新しい API トークンも作成されます。
  3. ファイルをダウンロードし、インポート用マシンでインポートを実行するに進みます。
このボタンが表示されるのは、リポジトリの管理者だけです。インポートが開始された後は、手動でファイルを作成してください:
1

local.env を作成する

インポート用マシンで、次の内容で local.env を作成します。Linux または Unix では p4_import_bootstrap.sh と同じディレクトリに、Windows ではダウンロードフォルダーに置きます。
local.env
2

REPO_ID を入力する

Diversion アプリで左上のリポジトリセレクタードロップダウンを開くと、組織内のリポジトリ一覧が表示されます。新しいリポジトリの行にマウスを重ね、表示される Copy repo ID ボタンをクリックします。コピーした ID を REPO_ID に貼り付けます。
3

API_TOKEN を入力する

インポートページでトークンをコピーしていた場合は、API_TOKEN に貼り付けます。コピーしていない場合は、新しいトークンを生成します:
  1. 右上のアバターをクリックし、メニューから Integrations を選択します。
  2. Generate a new API token をクリックし、名前を入力して Generate token をクリックします。トークンがリポジトリへの管理者権限を持つよう、リポジトリを作成したユーザーでサインインした状態で生成してください。
  3. トークンをコピーし、API_TOKEN に貼り付けます。トークンは一度しか表示されません。
4

セットアップを続ける

インポート用マシンでインポートを実行するを最初から行ってください。Windows では、Perforce の設定を入力する から始めます。ディストリビューションに既に local.env がある場合は、置き換えるかどうかをセットアップスクリプトに尋ねられたときに y と答えます。

マネージドインポートを依頼する

上記の要件を満たせない場合は、Diversion がインポートを代行します。Import from Perforce ページ下部の Request a managed import を使うか、support@diversion.dev までお問い合わせください。