TeamCity アドイン 2024.1 ヘルプ

オンラインドキュメント

TeamCity アドインとは何ですか?

TeamCity 継続的統合サーバーを使用して Visual Studio プロジェクトをビルドおよびテストする場合、TeamCity アドインは、Visual Studio を移動せずに、TeamCity サーバー上のビルドおよびテストにアクセス、実行、分析できます。

中央集中型バージョン管理システム(VCS)(Perforce、Subversion、Team Foundation サーバーなど)で作業する場合、TeamCity アドインを最大限に活用できます。ライト機能ブランチはワークフローの一部ではありません。これらの VCS の場合、TeamCity アドインを使用してパーソナルビルドを実行し、VCS にコミットする前に TeamCity サーバーでローカルの変更をテストできます。

TeamCity アドインは、無料の Visual Studio 拡張機能であり、Visual Studio 2010, 2012, 2013, 2015, 2017, 2019,, 2022 や、ReSharperdotCover などの他の JetBrains.NET ツールとシームレスに統合されます。

インストールと開始

TeamCity アドインは、dotUltimate インストーラーの一部として配布されており、いくつかの方法でダウンロードできます。

  • TeamCity Web インターフェースで、右上隅のユーザー名にある設定とツールを選択します。次に、右側の TeamCity ツールセクションで、Visual Studio アドインのダウンロードリンクをクリックします。

  • ReSharperdotCover などの互換性のある JetBrains.NET 製品のいずれかをダウンロードします。

ダウンロードが完了したら、すべての Visual Studio インスタンスを閉じ、インストーラーを実行し、指示に従ってインストールを完了します。

インストーラーは、必要に応じて、dotUltimate バンドルから他の JetBrains ツールをインストールするか、既存のツールを更新することを提案します。これらの製品の 30 日間無料試用版を TeamCity アドインと一緒にインストールするか、まったくインストールしないかを選択できます。詳細については、dotUltimate インストールガイドを参照してください。

インストール後、TeamCity アドインのコマンドは、Visual Studio の ReSharper | TeamCity メニューで使用できるようになります。

TeamCity サーバーへの接続

TeamCity アドインの使用を開始するには、TeamCity サーバーとの接続を確立する必要があります。具体的には、異なるソリューションを異なる TeamCity サーバー上に構築できるため、作業する各ソリューションを TeamCity サーバーとリンクする必要があります。

メインメニューで ReSharper | TeamCity | ログイン…を選択するか、Visual Studio ステータスバーの右側にあるクラウドアイコン ThemedIcon.NotConnected.Screen.(Gray).png を右クリックしてログインを選択できます。表示されるダイアログで、TeamCity サーバーの URL と資格情報を指定して、OK をクリックします。

TeamCity Add-in: login

接続が確立されるとすぐに、Visual Studio ステータスバーのクラウドアイコンが緑色の ThemedIcon.Connected.Screen.(Gray).png に変わり、変更ウィンドウでコミットと関連ビルドを表示できるようになります。

必要な設定をする

VCS サポートの有効化

パーソナルビルド、リモート実行、事前テスト済みコミットを有効にし、ローカル変更ウィンドウのローカル変更を表示、コミット、元に戻すには、TeamCity アドインオプション(ReSharper | オプション | TeamCity)でソリューションに使用する VCS を選択する必要があります。サポートされる VCS には、Perforce、Subversion、Team Foundation サーバーが含まれます。

変更、外部 diff ビューアー、カスタマイズされた事前テスト済みコミットメッセージから移動するようにファイルシステムブラウザーを構成するには、一般タブ(ReSharper | オプション | TeamCity | 一般)を使用します。

Perforce

  • Perforce サポートボックスをチェックし、使用する Perforce クライアントを指定します。Path 環境変数を介して検出されたクライアントを使用するか、クライアントへのパスを明示的に指定します。

  • 「接続設定」セクションで、必須のサーバーユーザー名およびワークスペース設定、オプションのパスワードおよび charset を指定します。このセクションのチェックアウトパスの詳細を確認してください。接続設定をテストします。

  • VCS 構成を保存します。

Subversion

  • Subversion サポートボックスをチェックし、使用する Subversion クライアントを指定します。Path 環境変数を介して検出されたクライアントを使用するか、クライアントへのパスを明示的に指定します。

  • ログイン設定セクションで、いずれかのオプションを選択します。

  • TeamCity アドインが変更を探すディレクトリを設定します。自動検出されたディレクトリを使用するか、外部を含むディレクトリを明示的に指定します。

  • VCS 構成を保存します。

TFS

TFS サポートボックスをオンにします。設定は自動的に検出されます。

差分ビューアーの構成

ローカル変更ウィンドウのローカル変更の差分を表示できるようにするには、TeamCity アドインオプション(ReSharper | オプション | TeamCity | 一般)で選択した外部差分ツールを構成する必要があります。

関連ページ:

個人ビルド、リモート実行、事前テスト済みコミット

機能ブランチがワークフローの一部ではない集中型バージョン管理システムを使用する場合、通常 2 つのオプションがあります。メインブランチに変更をコミットする前に、ソリューションをビルドし、ローカルでテストを実行します。これにより、リポジトリに問題が発生しないことを確認できますが、ビルドとテストが終了するまでかなりの時間を費やす可能性があります。未テストの変更をリポジトリのメインブランチにコミットしてから、ビルドサーバーでビルドとテストを実行します。これにより、コミット後も作業を続けることができます...

変更ウィンドウ

このウィンドウには、TeamCity アドインオプションで有効になっているソース管理システムにコミットした変更と、個人用ビルドに関する情報が表示されます。変更ペインは、変更が含まれていたビルド(個人または一般)の時間(今日、昨日、それ以前)ごとに変更をグループ化し、各変更はビルドステータスアイコンでマークされます。さらに、変更がソース管理にコミットされている場合、変更セットにはコミットタイプとステータスを表示するラベルが付けられます。特定の変更を選択して、ビルドペインにこの変更に関連するビルドを...

ローカル変更ウィンドウ

このウィンドウには、TeamCity アドインオプションで有効になっているソース管理システムのコミットされていない変更が表示されます。このウィンドウを使用して、個人的なビルドを開始して、コミットする前に変更をテストできます。ツールバーコントロール:パーソナルビルドを構成する選択した変更から個人用ビルドを開始できます。ローカルの変更を再収集するウィンドウの内容を更新して、TeamCity アドインオプションで有効になっているソース管理システムのローカル変更を反映します。すべて展開 / すべて折りたた...

一般

ファイルシステムエクスプローラー:このセクションでは、TeamCity アドインがファイルシステム内のファイルを表示する方法を構成できます。例: ローカル変更ウィンドウのファイルのコンテキストメニューからエクスプローラーで表示を選択した場合。で移動 TeamCity アドインがファイルシステム内のファイルを表示する方法を選択します。Windows エクスプローラー(デフォルトオプション)Windows エクスプローラーをファイルシステムエクスプローラーとして使用するには、このオプションを選択する...

ソリューションによるサーバー変更のフィルタリング

TeamCity アドインを使用すると、TeamCity サーバーの変更(TeamCity アドインオプションで有効になっているソース管理システムにコミットした変更、および個人用ビルド)をフィルタリングできます。これは、変更ウィンドウおよび dotCover スナップショットで確認できます。TeamCity サーバーで作成: 両方とも、現在開いているソリューションでフィルタリングできます。複数のソリューションで同時に作業している場合、ソリューションで変更をフィルタリングすると、変更を簡単に確認で...