Perforce

ポート

Perforce サーバーアドレスを host:port として定義します。

特定の環境では、P4Host 環境変数は、あらゆる型のチェックアウトについて、以下のワークスペースオプションで設定できます。

ストリーム / クライアント / クライアントマッピング

接続モードを選択します。以下の詳細を参照してください。

ユーザー名

ユーザーのログイン名を指定してください。

パスワードまたはチケット

オプションで、パスワードまたはチケットを指定します。

値を入力すると、TeamCity は次のようになります。

• Perforce コマンドを実行するための P4PASSWD 環境変数として設定するか

• Perforce サーバーでパスワードベースの認証が無効になっている場合は、p4 login コマンドのチケットとして使用してください。

フィールドを空のままにすると、TeamCity は現在のユーザー (p4ticket.txt) の既存の P4 チケットに依存します。チケットがこのファイルに存在しないが、Perforce による認証に必要な場合は、失敗が発生します。
チケットファイルは、TeamCity サーバーマシンと、この VCS ルートに対して TeamCity が Perforce ビルドを実行するすべてのビルドエージェントに存在する必要があります。

チケットベースの認証

チケットベースの認証を有効にするには、このオプションをオンにします。このオプションはデフォルトで有効になっており、表示されません。

ワークスペースオプション

必要に応じて、 p4 client (英語) コマンドに次のオプションを設定します: Options、SubmitOptions、LineEnd

特定の環境では、P4Host を定義します（あらゆる型のチェックアウトでサポートされます）。以下のワークスペースパラメーターの詳細を参照してください。

非ストリームワークスペースを作成する

Stream でのみ使用可能

ストリーム仕様に基づいて、非ストリームワークスペースを使用してソースをチェックアウトできるようにします。これにより、チェックアウトルールを使用できますが、ビルド内でストリームにコミットすることはできなくなります。

クリーンアップのために「p4 clean」を実行します

このオプションを有効にすると、ビルド前に余分なファイルからワークスペースがクリーンアップされます。有効にすると、p4 sync -f または p4 sync -p が使用されていない限り、p4 clean コマンドは p4 sync の前に実行されます。コマンドリファレンス(英語)を参照してください。

所有リストの更新をスキップする

このオプションを有効にすると、同期時に Perforce サーバー上のファイルを追跡しません (常にすべてのファイルをエージェント p4 sync -p (英語) に転送します)。無効にすると、TeamCity は p4 have を使用してリストを最新の状態に保ちます。

追加同期オプション

追加の p4 sync オプションを指定します。

sync コマンドの後に宣言するオプションのリストを指定する必要がある場合は、このコマンドの名前を省略します。例:

• --parallel=threads=5 と入力して、p4 sync --parallel=threads=5 コマンドを実行します。

sync コマンドの前後の両方で宣言する必要があるオプションを指定するには、この追加オプションのリストにコマンド名を含めます。例:

• -r3 sync と入力して、p4 -r3 sync コマンドを実行します。

• -r4 sync --parallel=threads=5 と入力して、p4 -r4 sync --parallel=threads=5 コマンドを実行します。

詳細については、 command reference (英語) を参照してください。

Perforce ワークスペースを自動的に削除する

この設定がオンの場合、TeamCity は各 clean-up 上の非アクティブなエージェントワークスペースを削除します。

詳細についてはこの記事を参照してください: ワークスペースの削除

ビルドエージェント上の P4 パス

Perforce コマンドラインクライアント（p4.exe）へのパスを指定します。

これはエージェント側のチェックアウトに対してのみ機能します。エージェント側では、このパラメーターの値は、TEAMCITY_P4_PATH 環境変数が buildAgent.properties ファイルで設定されているか、ビルドパラメーターから取得されている場合、その変数によって上書きされる可能性があります。

サーバーの場合、p4 バイナリは TeamCity サーバーマシンの PATH 環境変数に存在する必要があります。または、teamcity.perforce.customP4Path 内部プロパティを介して指定できます。

同期するラベル / 変更リスト

最新のリビジョンではなく、特定の Perforce ラベル (選択的な変更を含む) でソースをチェックアウトする場合は、ラベルを指定します。たとえば、これはマイルストーン / リリースビルドを作成するときに役立ちます。このフィールドが空の場合、最新の変更リストが同期に使用されます。TeamCity がラベルを使用してソースを同期する場合、リビジョン番号が vcsRoot.{externalId}.changelist パラメーターに書き込まれます。

文字セット

クライアントマシンで使用されている文字セットを選択します。

UTF-16 エンコーディングをサポート

プロジェクトに utf16 Perforce ファイルタイプ(英語)として UTF-16 ファイルが保存されている場合は、このオプションを有効にします。

ディポでサーバー側のチェックアウトと utf16 のファイルがあります Perforce ファイルタイプ(英語)を使用する場合は、このオプションを有効にしてください。チェックアウトされたファイルで UTF-16 エンコーディングを維持するには、このオプションを有効にしてください。そうしないと、チェックアウト時にそのようなファイルが UTF-8 に変換される可能性があります。

UTF-16 ファイルを binary Perforce ファイルタイプ(英語)として保存すると、それらは常に「そのまま」チェックアウトされ、変換は実行されません。

P4 トラスト

プロジェクトの VCS ルートが SSL 経由で Perforce に接続する場合、TeamCity はそれへの信頼できる接続を自動的に確立します。p4 trust コマンドは、Perforce 接続をテストするか、ビルドエージェントが Perforce からソースをチェックアウトするたびに送信されます。

Perforce サーバーの SSL 証明書が更新された場合、特別なパラメーターを使用して、この新しい証明書を信頼するようにエージェントを構成する必要があります。セキュリティ上の理由から、すべてのエージェントがソースをチェックアウトした後、このパラメーターを削除する必要があります。teamcity.internal.perforce.forceTrust=true 構成パラメーターを関連するプロジェクトまたはビルド構成に設定します。