Perforce
このページには、Perforceを使ってVCSルートを設定するときに利用できるフィールドとオプションの説明が含まれています。
ここでは一般的なVCSルートプロパティーについて説明します。
このページで:
- P4接続設定
- チェックアウトルールの大文字と小文字の区別なし
- エージェント設定のチェックアウト
- その他の設定
- Perforce Jobsのサポート
- ロギング
- Perforceでのワークスペース処理TeamCity
- Perforce VCSの互換性
- Perforce機能としてのストリームブランチ
P4接続設定
オプション | 説明 |
---|---|
ポート | Perforceサーバーのアドレスを指定します。形式は |
ストリーム | このラジオボタンをクリックして、既存のPerforceストリームを指定します。TeamCityはこのストリームを使用してストリームベースのワークスペースを準備し、そのようなワークスペースからのクライアントマッピングを使用します。 TeamCityはルートデポ内のより深いディレクトリー構造をサポートします。このフィールドで パラメーターがサポートされています。 機能ブランチサポートを有効にする (実験用) - このチェックボックスを選択して、デフォルトのものに加えて変更を監視したいブランチストリームを指定します。改行区切りの規則としてブランチ仕様を入力/編集します。構文は |
クライアント | このラジオボタンをクリックして、クライアントワークスペース名を直接指定します。ワークスペースは、P4VやP4WinなどのPerforceクライアントアプリケーションによってすでに作成されている必要があります。構成されたクライアントワークスペースからのマッピング規則のみが使用されます。クライアント名は無視されます。 |
クライアントマッピング | このラジオボタンをクリックして、デポからクライアントコンピューターへのマッピングを指定します。クライアントマッピングが選択されている場合、TeamCityはビルドが実行されるビルドエージェントのOS /プラットフォームに従ってファイル区切り文字を処理します。すべてのビルドエージェントに特定の行区切り記号を強制するには、クライアントマッピングの代わりにPerforceで 例: //depot/MPS/... //team-city-agent/...
//depot/MPS/lib/tools/... //team-city-agent/tools/...
TeamCity 10.0より前、Perforce VCSルートのクライアントマッピングを編集すると、次のビルドの前にクリーンチェックアウトになりました。回避策(英語)が提供されました。 以下の場合、クライアントマッピングの変更に対するクリーンチェックアウトはエージェント側のチェックアウトには適用されません。
ダイレクトクライアントマッピングが変更された場合、 |
ユーザー名 | ユーザーのログイン名を指定してください。 |
パスワードまたはチケット | パスワードまたはチケットを指定してください。 このフィールドが指定されている場合は、TeamCity
パスワードがまったく指定されていない場合、TeamCityは現在のユーザーの既存のp4チケット( チケットファイルは、TeamCityがこのVCSルート用にビルドされたperforceビルドを実行するすべてのビルドエージェントとTeamCityサーバーに存在する必要があります。(サーバーもperforceコマンドを実行するため) |
チケットベースの認証 | チケットベースの認証を有効にするには、このオプションをオンにします。このオプションはデフォルトで有効になっており、表示されません。 |
チェックアウトルールの大文字と小文字の区別なし
TeamCityでのPerforceサポートは、チェックアウト規則を大文字と小文字を区別して扱うことに注意してください: チェックアウト規則の編集フォームに次のコメントを追加すると、バージョン管理設定ページでPerforceベースのビルド設定の大文字と小文字を区別しないようにすることができます: ##teamcity ignore-case
エージェント設定のチェックアウト
エージェント側のチェックアウトを使用すると、TeamCityは各チェックアウトディレクトリー / VCSルートに対してPerforceワークスペースを作成します。これらのワークスペースは必要に応じて自動的に作成され、アイドル時間が経過すると自動的に削除されます。TeamCityによって生成される名前をカスタマイズすることは可能です:パラメーターページで値に接頭辞を付けて teamcity.perforce.workspace.prefix
設定パラメータを追加してください。
オプション | 説明 |
---|---|
ワークスペース・オプション | 必要に応じて、p4クライアント(英語)コマンドに |
非ストリームワークスペースを作成する | (TeamCity 2018.2以降)このオプションは、接続設定で「ストリーム」が選択されている場合にのみ使用可能です。ストリーム仕様に基づいて、ストリーム以外のワークスペースを使用してチェックアウトできるようにするには、このオプションを有効にします。これにより、チェックアウト規則を使用できますが、ビルド内でストリームにコミットすることは不可能になります。 |
クリーンアップのために 'p4 clean'を実行してください | ビルドの前に余分なファイルからワークスペースをクリーンアップするには、このオプションを有効にします(p4 2014.1以降)。有効にすると、 |
所有リストの更新をスキップする | 同期中にPerforceサーバー上のファイルを追跡しないようにするには、このオプションを有効にします(常にすべてのファイルをエージェントp4同期-p(英語)に転送します)。 |
追加同期オプション | |
Perforceワークスペースパラメータ
エージェントのチェックアウトでは、TeamCityはチェックアウトプロセス中に作成されたPerforceワークスペースを記述する環境変数を提供します。
チェックアウトに複数のPerforce VCSルートが使用されている場合、変数は最初のVCSルートに対して作成されます。変数は以下のとおりです。
Perforceプロキシ設定
エージェント側のチェックアウトでPerforceプロキシーを使用できるようにするには、ビルド・エージェントで env.TEAMCITY_P4PORT
環境変数を指定すると、エージェントはこの値を P4PORT
値として使用します。
その他の設定
ビルドエージェント上のP4パス | Perforceコマンドラインクライアントの このフィールドは、エージェント側のチェックアウトではエージェント側でのみ機能します(TeamCity 2017.2.2より前このパスはサーバー側のチェックアウトとエージェント側のチェックアウトの両方に使用されていました)。サーバーの場合、p4バイナリがPATHに含まれている必要があります。TeamCityサーバーの場合、または 以前の動作に戻すには、 |
同期するラベル/変更リスト | 最新のリビジョンではなく、特定のPerforceラベル(選択的な変更を含む)でソースをチェックアウトする必要がある場合は、ここでこのラベルを指定できます。たとえば、これはマイルストーン/リリースビルド、または再現ビルドを作成できます。このフィールドを空白のままにすると、最新の変更リストが同期に使用されます。 |
文字セット | クライアントコンピューターで使用されている文字セットを選択します。 |
UTF-16エンコーディングをサポート | プロジェクトにUTF-16ファイルが デポでサーバー側のチェックアウトと |
Perforce Jobsのサポート
1つ以上の関連ジョブでチェックインされた変更リストの場合、TeamCityにはレンチアイコン が表示され、クリックまたはホバーしたときにジョブの詳細を表示できます。
ロギング
すべてのPerforceプラグイン操作は、カテゴリjetbrains.buildServer.VCS.P4のteamcity-vcs.logファイルに記録されます(操作コンテキストに応じて、エージェントまたはサーバー上)。詳細なロギングはTeamCityサーバーログで有効にできます。
Perforceでのワークスペース処理TeamCity
別ページを参照してください。
Perforce VCSの互換性
別ページを参照してください。
関連ページ:

TeamCityサーバー起動プロパティーの設定
TeamCityサーバーの起動時に渡される設定オプションによって、TeamCityの動作のさまざまな側面をカスタマイズできます。これらのオプションは2つのカテゴリに分類されます。JavaVirtual Machine(JVM)への影響とTeamCityの動作への影響です。TeamCityサポートチー...

Perforce機能としてのストリームブランチ
このページで:有効にする方法、タスクストリーム、remote run、有効にする方法:VCSルートページで、親ストリーム名の後にあるチェックボックス「機能ブランチサポートを有効にする」を選択します。その後、指定されたメインストリームを親として持つすべてのストリームが、フィーチャブランチに含まれます。...