TeamCity On-Premises 2026.2 Help

Subversion

この記事には、VCS ルートを設定するときに使用できる Subversion 固有のフィールドとオプションの説明が含まれています。

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

SVN 接続設定

オプション

説明

URL

プロジェクトソースを指す SVN URL を指定します。

ユーザー名

SVN ユーザー名を指定します。

パスワード

SVN パスワードを指定してください。

外部サポート

次のオプションのいずれかを選択して、SVN 外部処理を制御します。

  • フルサポート (変更の読み込みとチェックアウト): TeamCity は構成のすべてのソース (外部のソースを含む) をチェックアウトし、外部の変更に関する情報を収集して 変更 タブに表示します。 このオプションを有効にすると リビジョンにタイムスタンプが追加される(英語)ため、 バージョン設定が影響を受ける可能性があることに注意してください。

  • チェックアウトするが、変更を無視: TeamCity は外部からソースをチェックアウトしますが、外部のソースファイルでの変更は収集されず、 変更 タブに表示されません。 複数の SVN 外部があり、外部のソースファイルに加えられた変更に関する情報を取得したくない場合は、このオプションを使用できます。

  • 外部を無視: TeamCity は構成済みの svn:外部 プロパティを無視するため、変更のチェックや SVN 外部からのソースファイルのチェックアウトは行いません。

HTTPS 接続: 信頼できない SSL 証明書を受け入れる

有効にすると、TeamCity は適切に署名された SSL 証明書がなくても SVN サーバーに接続できます。

SSH 設定

オプション

説明

秘密鍵ファイルのパス

OpenSSH 形式の秘密鍵が含まれるファイルへの完全パスを指定します。

TeamCity にアップロードされた SSH 鍵も指定できます

秘密鍵ファイルのパスワード

SSH 秘密鍵のパスワードを入力してください。

SSH ポート

SSH が使用するポートを指定してください。

キーでは OpenSSH 形式のみがサポートされています。 TeamCity でサポートされていないフォーマットの鍵は、OpenSSH フォーマットに変換する必要があります (たとえば、Putty 秘密鍵 (*.ppk) は PuTTYgen.exe を使用して変換できます: 変換 | OpenSSH キーをエクスポート を参照してください)。

エージェントでのチェックアウト設定

オプション

説明

作業コピーの形式

作業コピーのフォーマットを選択します。 このオプションで使用できる値は 1.4 から 1.8 (現在のデフォルト) までです。
このオプションは、 エージェントでのチェックアウトモードを使用する場合に、 .svn ディレクトリ内にある Subversion ファイルのフォーマットバージョンを定義します。 指定したフォーマットは、次の 2 つの場合に重要です:

  • TeamCity によってチェックアウトされたファイルに対してコマンドラインの svn コマンドを実行する場合。 例: 作業コピーのバージョンが 1.5 の場合、Subversion 1.4 バイナリを使用して作業コピーを使用することはできません。

  • 新しい Subversion 機能を使用する場合、たとえば、Subversion 1.6 で追加されたファイルベースの外部などです。 作業コピー形式を 1.6 に設定しない限り、ファイルベースの外部は エージェントでチェックアウト では使用できません。

更新前に元に戻す

オプションが選択されている場合、TeamCity はソースを更新する前に常に svn 元に戻す コマンドを実行します。つまり、チェックアウトディレクトリ内のバージョン管理されたファイルのすべての変更を元に戻します。 オプションが無効で、更新プロセス中にローカル変更が検出されると、TeamCity は更新後に svn 元に戻す を実行します。
TeamCity は、元に戻す処理中に作業ディレクトリ内のバージョン管理されていないファイルを削除しません。 バージョン管理されていないファイルを削除するには、 Swabra の使用を検討してください。

ラベル付け設定

オプション

説明

ラベル付け規則

リポジトリの構造を定義する、改行で区切られた一連のルールを指定します。 詳細については、 詳細な形式の説明を参照してください。

SVN 外部の認証

TeamCity では、ユーザーインターフェースで SVN 外部の認証パラメーターを明示的に指定することはできません。 SVN 外部サーバーで認証するために、以下のアプローチが使用されます。

  • メインリポジトリと同じ認証情報(ユーザー名 / パスワード)を使用して認証する

  • 明示的なユーザー名 / パスワードなしで認証します。 この場合、認証情報はすでに svn プロセスで利用可能であるべきです(通常、それらは subversion 構成ディレクトリに保存されています)。 そのため、 SVN 接続設定で正しい "構成ディレクトリ" または "デフォルト構成ディレクトリ" オプションを設定する必要があります

TeamCity が SVN 外部に接続する必要がある場合、次の順序を使用します:

  • SVN 外部 URL がメインリポジトリと同じプレフィックスを持つ場合 (一致が > 20 文字ある場合)、TeamCity はまずメインリポジトリの資格情報を試し、失敗した場合はユーザー名/パスワードなしで接続を試みます (そのため、SVN 構成ディレクトリから取得されます)

  • SVN 外部 URL がメインリポジトリと著しく異なる場合、TeamCity はユーザー名/パスワードなしで接続を試み、失敗した場合はメインリポジトリの資格情報を使用してみます

タイムアウト

リモート SVN サーバーに対する SVN チェックアウト操作は、 svn: E175002: サーバーの応答待ち中にタイムアウトしました のようなエラーで失敗することがあります。 通常、これはネットワークの遅延や SVN サーバーの過負荷が原因で発生することがあります。接続と読み取り操作のタイムアウト値を構成できます。

接続タイムアウト

接続タイムアウトは、TeamCity が SVN サーバーへの接続を作成するときに適用されます。 この操作のデフォルトのタイムアウトは 60 秒 であり、 TeamCity SVN 接続タイムアウト プロパティを介して秒単位で指定できます。

プロパティの値は、サーバー側のチェックアウトとエージェント側のチェックアウトで異なる方法で設定されます。

読み取りタイムアウト

読み取りタイムアウトは、SVN サーバーとの接続が確立され、TeamCity がサーバーからのデータを待機しているときに使用されます。 タイムアウトの値は SVN サーバーアクセスプロトコルによって異なります。

HTTP/HTTPS 経由の Subversion サーバーアクセス (サーバー/エージェントの両方)

HTTP 読み取りタイムアウトでは、TeamCity は Subversion 構成ディレクトリ内の サーバー ファイルで指定された HTTP タイムアウト 設定を使用します。 Win32 システムでは、このディレクトリは通常、ユーザーのプロファイルディレクトリのアプリケーションデータ領域にあります。 Unix/Mac では、TeamCity サーバー/エージェントを実行するユーザーアカウントの場合、このディレクトリは通常 $HOME/.subversion という名前です。

指定しない場合、タイムアウトのデフォルト値は 1 時間です。

svn:// または svn+ssh:// 経由の Subversion サーバーアクセス。Subversion サーバーアクセス via svn:// または svn+ssh://???

この場合、読み取りタイムアウトは TeamCity の TeamCity SVN 読み取りタイムアウト 内部プロパティを介して秒単位で指定できます。 デフォルト値は 30 分です。

プロパティの値は、サーバー側のチェックアウトとエージェント側のチェックアウトで異なる方法で設定されます。

無視される変更

TeamCity は svn:マージ情報 プロパティの変更を無視し、特定のコミットでこれらのプロパティのみが変更された場合、ディレクトリが 変更済み であるとは見なしません。

TeamCity の 内部プロパティTeamCity SVN 無視可能なプロパティ を使用して、無視される SVN プロパティのリストを変更できます。 このプロパティの値はカンマ区切りの SVN プロパティのリストです。デフォルト値は svn:マージ情報 です。

2026 年 9 月 11 日