TeamCity オンプレミス 2025.11 ヘルプ

StarTeam

この記事では、StarTeam を使用して VCS ルートを設定するときに使用できるフィールドとオプションについて説明します。

一般的な VCS ルートプロパティについては、ここで説明します。

StarTeam 接続設定

オプション

説明

URL

必要なソースを指す StarTeam URL を指定します

ユーザー名

StarTeam サーバーのログインを入力してください

パスワード

上のフィールドで指定されたユーザーに対応するパスワードを入力します

EOL 変換

テキストファイルの EOL(行末)シンボル変換規則を定義します。次のいずれかを選択します。

  • リポジトリに保存されている — EOL シンボルは、リポジトリに保存されるときに保持されます。変換は行われません。

  • エージェントのプラットフォームのデフォルト — リポジトリ内の特定のファイルで使用されている EOL シンボルは、ビルドエージェントに渡されるときにプラットフォーム固有の改行コード文字に変換されます。結果の EOL シンボルは、エージェントのプラットフォームにのみ依存します。

ディレクトリの命名

ローカルディレクトリの命名モードを定義します。次のいずれかを選択します。

  • 作業フォルダーを使用する — StarTeam フォルダーには「作業フォルダー」プロパティがあります。これは、どのローカルパスが StarTeam フォルダーに対応するかを定義します (デフォルトでは、作業フォルダーはフォルダーの名前と同じです)。このモードでは、TeamCity はローカルディレクトリに「作業フォルダー」プロパティに保存されている名前を与えます。StarTeam では作業フォルダーとして絶対パスを使用できますが、TeamCity は相対パスのみをサポートし、絶対パスの存在を検出しないことに注意してください。

  • StarTeam フォルダー名の使用 — このモードでは、ローカルディレクトリは対応する StarTeam フォルダーの名前にちなんで命名されます。このモードは、作業ディレクトリ構造をリポジトリ内のプロジェクト構造と同じに保ち、制御不能に変更される可能性があるため「作業フォルダー」プロパティに依存したくないユーザーに適しています。

チェックアウトモード

ファイルは、現在の (チップ) リビジョン、ラベル、プロモーション状態によって取得できます。ラベルまたはプロモーション状態によるチェックアウトを選択した場合、この VCS ルートの変更検出は実行できないことに注意してください。その結果、ラベルが移動されたり、プロモーション状態が別のラベルに切り替えられたりすると、ビルドをトリガーできなくなります。ビルドを最新の状態に保つ唯一の方法は、スケジュールベースのトリガーを使用することです。これを可能にするために、ラベルまたはプロモーション状態によるチェックアウトオプションを選択した場合は、常に完全なチェックアウトが実行されます。

ディレクトリの命名規則に関する注意

ソースをチェックアウトするとき、TeamCity は (StarTeam ネイティブクライアントと同様に) 単なるフォルダー名ではなく作業フォルダー名を使用してローカルディレクトリ構造を形成します。デフォルトでは、特定の StarTeam フォルダーの作業フォルダー名はフォルダー名と同じです。例: プロジェクトに「A」という名前のフォルダーがあり、サブフォルダーに「B」という名前があります。デフォルトでは、それらの作業フォルダーはそれぞれ「A」と「B」であり、ローカルディレクトリ構造は <checkout dir>/A/B のようになります。ただし、フォルダー「A」の作業フォルダーが別のフォルダー (たとえば、Foo) に設定されている場合、ディレクトリ構造も <checkout dir>/Foo/B のように異なります。

StarTeam では、絶対パスを作業フォルダーとして指定できます。ただし、TeamCity は相対作業フォルダーのみをサポートします。これは設計により行われます。ソース管理から取得したすべてのファイルは、チェックアウトディレクトリに存在する必要があります。TeamCity が絶対作業フォルダーの存在を検出した場合、ビルドは失敗します。

VCS ルートのすべてのフォルダーに相対的な作業フォルダー名があることを確認する必要があります。

2025 年 4 月 07 日