TeamCity と Jira の統合
TeamCity と Jira(英語) の統合により、次のことが可能になります。
TeamCity UI での Jira の問題へのリンクの表示 — 自己管理型 Jira（データセンターおよびサーバー 4.4 以降）および Jira クラウドに適用可能。
TeamCity ビルドステータスを Jira クラウドに報告します。
この記事では、Jira と統合した場合の TeamCity の動作について説明し、統合を有効にして構成する方法について説明します。
TeamCity UI での Jira 問題へのリンクの表示
Jira との統合が有効になっている場合、TeamCity は、VCS コミットのコメントに記載されている Jira 発行キーを自動的に検出(英語)します。これらのキーを Jira の対応する問題へのリンクに変換し、UI で TeamCity ユーザーに表示します。
TeamCity UI で問題の基本的な詳細を表示するには、関連するビルドの結果の変更タブを開き、問題キーの横にあるアイコンにカーソルを合わせます。
ビルドで修正された問題は、ビルド結果の課題タブで確認できます。
ビルド構成全体に関連する問題 (個々のビルドだけでなく) を表示するには、ビルド構成ホームページの問題のログタブを使用します。リストを特定の範囲のビルドにフィルター処理したり、解決された問題のみを表示オプションを有効にしてビルドで修正された問題のみを表示したりできます。
Jira 統合から最大の利益を得るには、次の推奨事項に従ってください。
バージョン管理に変更をコミットするときは、コミットのコメントに修正に関連する問題キーを必ず記載してください。
修正された問題を Jira で解決済みとしてマークすると、TeamCity ログに修正済みステータスとともに表示されます (解決の時間は重要ではありません)。
TeamCity は、ビルドに対して 10 分ごとに、または新しいコミットが検出されたときに表示される Jira 問題のステータスを更新します。
Jira への接続の構成
統合を有効にするには、プロジェクト設定 |Issue Trackers ページで Jira への接続を作成し、次の設定を指定します。
設定 | 説明 |
|---|---|
接続タイプ | リストから Jira を選択します。 |
表示名 | 接続名を指定して、他の接続と区別します。 |
サーバー URL | Jira インスタンスまたはサーバーのベース URL を入力します。Jira クラウドの場合、これは |
ログイン | 自己管理 Jira のユーザー名（Jira ユーザープロファイルで指定）または Jira クラウドのメール。 |
パスワード /API トークン | 自己管理型 Jira のパスワードまたは Jira クラウドの API トークン(英語)。 |
プロジェクトキー | Jira 内の課題への参照として認識される文字列を指定するには、スペースで区切られたプロジェクトキーのリストを入力します。例: プロジェクトキーが すべてのプロジェクトキーを自動的にロードすることもできます。すべての Jira プロジェクトを自動的に使用するを有効にして、Jira サーバーへの接続をテストします。接続が成功すると、プロジェクトキーフィールドが自動的に入力されます。TeamCity は、Jira で新しく作成されたプロジェクトを検出し、プロジェクトキーのリストを自動的に同期します。 |
Jira への接続で指定されたユーザーは、Jira の問題を表示するための十分な権限を持っている必要があることに注意してください。これにより、TeamCity は問題に関する情報を取得し、UI に表示できるようになります。
TeamCity ビルドステータスの Jira クラウドへの報告
TeamCity は、ビルドステータスを Jira クラウドにリアルタイムで報告できます。VCS コミットメッセージで Jira 発行キーについてメンションしている場合、TeamCity は、このコミットを含むビルドを実行するときにこのメッセージを検出します。ビルドステータスは Jira クラウドに送信され、Jira タスクの詳細に表示されます。
ステータスをクリックすると、ビルド (通常および複合ビルドの場合) またはデプロイ ( デプロイビルドの場合) タブで詳細を確認できます。
機能の有効化
TeamCity にビルド / デプロイ情報を Jira クラウドに送信させるには:
Jira Cloud への接続を構成するときは、Jira クラウドクライアント ID およびサーバーシークレット設定を指定します。
Jira クラウド統合 ビルド機能をビルド構成に追加し、Jira クラウドへの事前構成された接続を選択します。
デプロイビルド構成の場合は、環境タイプ ( テストや本番など) と環境名を指定します。これらのオプションは、Jira Cloud でデプロイ情報を表示するために必要です。
TeamCity と Jira クラウドビデオガイドの統合
関連ページ：
ビルド結果ページ
TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...
プロジェクト管理者ガイド
このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...
コンポジットビルド構成
コンポジットビルド構成は、複数の通常のビルド構成をトリガーし、結果を 1 か所で追跡するように設計された「ステップレス」構成です。重要なポイント：複合構成では、実際の構築ルーチンは実行されません。複合構成では、依存関係からすべての情報が集約され、一元的な方法で表示されます。複合ビルドはビルドキュースロットを占有せず、エージェントを実行する必要もありません。ビルド構成タイプを切り替えるには、「構成設定 | 一般」タブに移動します。サンプル：このチュートリアルでは、複数のビルド構成を作成し、1...
ビルド機能を追加する
ビルド機能は、追加の機能を有効にするために任意のビルド構成に追加できる機能です。例: ステータス発行者のコミットビルド機能は、コードファイルを保存する VCS に TeamCity ビルド結果を公開し、調査自動割り当ては最新の変更によってビルドが壊れたユーザーを識別し、これらの問題を解決するタスクを自動的に割り当てます。構成されたビルド機能は、削除することなくいつでも一時的に無効にできます。TeamCity ビルドの特徴：TeamCity には、構成に追加できる次のビルド機能が付属しています。A...
TeamCity と GitLab の問題の統合
TeamCity と GitLab 課題追跡システムの統合は、個別に設定することも、GitLab ソースコードホスティングサービスとの TeamCity 統合の一部として設定することもできます。ここで説明するように、GitLab との接続を構成します。GitLab イシューとの統合をセットアップする場合（ここで一般情報を参照）、リポジトリ URL およびその他の一般設定に加えて、認証を構成し、イシュー ID パターンを指定する必要があります。認証：TeamCity を使用すると、GitLab...