TeamCity 2019.1ヘルプ

Team Foundation Server

このページには、VCSルートをセットアップしてMicrosoft Team Foundationサーバーバージョン管理に接続するときに使用できるフィールドとオプションの説明が含まれています。

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

Azure DevOps Gitリポジトリに接続するときは、Type of VCSとしてGitを選択します。

このページで:

クロスプラットフォームTFS統合

TeamCityは、Linux、macOS、およびWindowsプラットフォームで動作するクロスプラットフォームTFS統合(英語)を備えています。追加のソフトウェアをインストールしなくても、TeamCityサーバーとビルドエージェントはTeam Foundation Servers2012以降、およびAzure DevOps Servicesと対話できます。

組み込みのTFSプラグインは、デフォルトとクロスプラットフォームの2つのモードで動作します。作業モードは、チームエクスプローラーの利用可能性(デフォルトモード)に基づいています。存在しない場合、プラグインはデフォルトからクロスプラットフォームモードに戻ります。

チームエクスプローラーのバージョンを検出すると、TeamCityは.NET GAC(英語)と次のパスを確認します。

  • Windows x86: %CommonProgramFiles%Microsoft Shared\Team Foundation Server\%version_number%
  • Windows x64: %CommonProgramFiles(x86)%Microsoft Shared\Team Foundation Server\%version_number%

TeamCityでクロスプラットフォームモードを強制するには、teamcity.tfs.mode=java 内部プロパティーまたはビルド構成パラメータを設定します

TFS設定

オプション

説明

URL

次の形式のTeam FoundationサーバーURL

  • TFS 2010+: http[s]://<host>:<port>/tfs/<collection>

  • TFS 2005/2008: http[s]://<host>:<port>

  • Azure DevOps: https://dev.azure.com/<organization>

  • VSTS: https://<accountname>.visualstudio.com

ルート

次の形式でルートを指定してください: $<project name><project_catalog>

ユーザー名

Team Foundationサーバーにアクセスするためのユーザーを指定してください。これはユーザー名または DOMAIN\UserName ストリングです。
TFSにTeamCityサーバー(またはエージェント側のチェックアウト用のエージェント)の実行に使用されるユーザーアカウントを選択させるには、空白を使用します。

パスワード

上記で入力したユーザーのパスワードを入力してください

Azure DevOpsで認証の詳細を学びましょう。

エージェント側のチェックアウト

agent-sideチェックアウトは、Windows、Linux、およびMacエージェントマシンでサポートされています。

TeamCityは、使用される各チェックアウトディレクトリーに対してTFSワークスペースを自動的に作成します。ワークスペースは、VCSルート設定で指定されているユーザーアカウントに代わって作成されます。

デフォルトでは、作成されたTFSワークスペースはTFSサーバー設定で定義された場所を使用します。 local または serverに設定されたビルド構成パラメータ teamcity.tfs.workspace.location を介して、TeamCityに特定のワークスペースの場所を使用させることができます。

作成されたTFSワークスペースは、teamcity.tfs.workspace.idleTime ビルドエージェントプロパティーでデフォルト値の1209600秒(2週間)に設定されたタイムアウトに基づいて自動的に削除されます。

オプション

説明

すべてのファイルを強制的に上書きする

このオプションを有効にすると、TeamCityはTFSを呼び出してワークスペースを更新し、すべてのファイルを書き換えます。

通常、ビルドごとに強制的にアップデートする必要はありません。ただし、TeamCityがリポジトリから最新バージョンを取得していないと思われる場合は、このオプションを使用できます。

認証に関する注意

Azure DevOpsでは、次の認証オプションを利用できます。

個人アクセストークン

アクセストークンを使用するには、Azure DevOpsアカウントに個人用アクセストークン(英語)を作成する必要があります。ここで、リポジトリにコード アクセススコープを設定し、VCSルートを設定するときに使用する必要があります。

オプション

説明

ユーザー名

TFVCの場合は空白、Gitの場合は任意の値、たとえばusernameのままにします。

パスワード

以前に作成した個人用アクセストークンを入力してください

必要なアクセス範囲

TFSサブシステム

スコープ

TFVC

すべての範囲

Git

バージョン管理設定のコード(読み取り)/コード(読み取りと書き込み)

作業項目

作業項目 (読み取り)

コミット状況

コード (状況)

代替認証資格情報

ログイン/パスワードペア認証を使用するには、Azure DevOpsアカウントで代替資格情報(英語)を有効にする必要があります。このアカウントでは、VCSルートの設定時に使用するセカンダリーユーザー名とパスワードを設定できます。

LinuxおよびmacOS上のNTLM / Kerberos

この認証方法を使用するには、マシンにKerberosライブラリーが含まれていること、および認証が正しく設定されていることを確認してください。課題が発生した場合は、マイクロソフトのドキュメント(英語)に記載されている手順を確認してください。

Team Foundationプロキシ設定

Team Foundationプロキシ(英語)の使用を有効にするには、TeamCityサーバーまたはエージェントを実行するユーザーアカウントに対して TFSPROXY 環境変数を定義し、再起動して変更を適用します。

例:

TFSPROXY=https://tfs-proxy:8081

HTTPプロキシサーバーの設定

デフォルトの.NET作業モード

TFSサーバーと対話するには、TeamCityサーバーまたはエージェントを実行するユーザーアカウントに指定されたプロキシサーバー設定が使用されます。

クロスプラットフォーム作業モード

TeamCityサーバーまたはエージェントに指定されているデフォルトのJavaプロキシサーバー設定は、TFS統合で使用されます。TeamCityサーバーでは、内部プロパティーまたはJavaオプションを使用できます。TeamCityエージェントでは、ビルドエージェント構成またはJavaオプションを使用できます。TeamCity-TFS統合は以下のオプションをサポートします。

http.proxyHost http.proxyPort http.nonProxyHosts https.proxyHost https.proxyPort http.proxyUser http.proxyPassword