インポート用マシンの要件
- 次のいずれか:
- 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) が必要です。
- Linux またはその他の Unix:
- 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 用のセットアップ手順が含まれています。
インポート設定
local.env を保護する
local.env には、Diversion アカウントへの管理者権限を持つ API トークンが含まれています。
パスワードと同じように扱ってください:
- インポート用マシンだけに置き、インポートを実行するユーザーだけが読めるようにします(下の手順の
chmod 600 local.env)。Windows では、セットアップスクリプトがファイルを WSL 内にコピーし、そのコピーを root だけが読めるようにして、ダウンロードフォルダーにあるファイルを削除します。 - バージョン管理にコミットしたり、チャットやメールで共有したり、他のマシンにコピーしたりしないでください。
インポート用マシンでインポートを実行する
- Linux / Unix
- Windows
以下の手順は、インポートを実行するユーザー(Docker を使えるユーザー)で行ってください。初回の実行が成功すると、インポート設定をダウンロードし、Diversion のインポートイメージを取得して起動します。
出力には このディレクトリからスクリプトを 5 分ごとに実行し、出力を
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
スクリプトを一度実行して設定を確認する
Remote env changed -- recreating: ... のような行が表示され、docker ps でインポートコンテナが動作していることを確認できます。
初回はイメージのダウンロードのため数分かかることがあります。6
インポートをスケジュールする
bootstrap.log に追記する crontab エントリを追加します。
実行のたびに、停止したインポートを再起動し、設定の変更を反映します。Perforce の設定を変更する
セットアップ時の確認では Perforce への接続はテストされません。設定が間違っている場合、インポートは停止し、docker logs に Perforce のログインエラーが表示されます。
- Linux / Unix
- Windows
インポート用ディレクトリの
local.env を編集します。5 分以内の次回の実行で変更が反映されます。インポートの進行状況を確認する
Diversion で新しいリポジトリを開きます。インポートが完了するまで、リポジトリページに Reading history、Preparing history、Uploading files の 3 段階で進行状況が表示されます。 履歴の準備ができると、コミット、ブランチ、ファイルが表示されます。ファイルは内容のアップロード後に開けます。 大きな depot のインポートには時間がかかります。完了するまで、インポート用マシンを起動したまま接続しておいてください。インポートを停止・削除する
スケジュールを削除するまで、インポートは動作し続けます。初回インポートの後も Perforce からの継続的なインポートや Perforce へのエクスポートが必要な場合は、スケジュールを削除しないでください。継続的なインポート・エクスポートを有効にするにはサポートにお問い合わせください。
- Linux / Unix
- Windows
crontab -eを実行し、p4_import_bootstrap.shを含む行を削除します。- インポート用マシンから
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 サポートに送信してください。インポート用ディレクトリで次を実行します: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 ページを離れてしまった場合は、新しいインポートを始めないでください。リポジトリとインポート設定は既に作成されています。代わりにファイルを作り直してください。
インポートが開始されるまでは、リポジトリページで新しいファイルを作成できます:
- Diversion で新しいリポジトリを開きます。
- Lost your local.env file? の下にある Create a new local.env をクリックします。これにより新しい API トークンも作成されます。
- ファイルをダウンロードし、インポート用マシンでインポートを実行するに進みます。
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 に貼り付けます。コピーしていない場合は、新しいトークンを生成します:- 右上のアバターをクリックし、メニューから Integrations を選択します。
- Generate a new API token をクリックし、名前を入力して Generate token をクリックします。トークンがリポジトリへの管理者権限を持つよう、リポジトリを作成したユーザーでサインインした状態で生成してください。
- トークンをコピーし、
API_TOKENに貼り付けます。トークンは一度しか表示されません。
4
セットアップを続ける
インポート用マシンでインポートを実行するを最初から行ってください。Windows では、Perforce の設定を入力する から始めます。ディストリビューションに既に
local.env がある場合は、置き換えるかどうかをセットアップスクリプトに尋ねられたときに y と答えます。
