TeamCity On-Premises 2026.2 Help

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」であり、ローカルディレクトリ構造は <チェックアウトディレクトリ>/A/B のようになります。 ただし、フォルダー「A」の作業フォルダーが別のフォルダー (たとえば、 ほげ) に設定されている場合、ディレクトリ構造も <チェックアウトディレクトリ>/Foo/B のように異なります。

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

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

2026 年 9 月 11 日