TeamCity と JIRA の統合
TeamCity と JIRA の統合により、次のことが可能になります：
TeamCity UI で JIRA 課題へのリンクを表示 — セルフマネージド JIRA (Data Center およびサーバー 4.4 以降) と JIRA Cloud に適用されます。
TeamCity ビルドステータスを JIRA Cloud に報告します。
この記事では、JIRA と統合した場合の TeamCity の動作について説明し、統合を有効化して構成する方法も説明します。
TeamCity UI で JIRA 課題へのリンクを表示
JIRA との統合が有効化されている場合、TeamCity は VCS コミットのコメントに記載された JIRA 課題の鍵 を自動的に検出します。 これらの鍵を JIRA の対応する課題へのリンクに変換し、UI で TeamCity ユーザーに表示します。
TeamCity UI で課題の基本的な詳細を表示するには、関連するビルドの結果の 変更 タブを開き、課題の鍵の横にあるアイコンにカーソルを合わせます：
ビルドで修正された問題は、ビルド結果の 課題 タブで確認できます。
ビルド構成全体に関連する問題 (個々のビルドだけでなく) を表示するには、 ビルド構成ホーム ページの 課題ログ タブを使用します。 リストを特定の範囲のビルドにフィルター処理したり、 解決された課題のみを表示オプションを有効にしてビルドで修正された課題のみを表示したりできます。
Jira 統合から最大の利益を得るには、次の推奨事項に従ってください。
バージョン管理への変更をコミットするとき、 課題の鍵を常に記載する はコミットへのコメントの修正に関連していました。
修正された課題を JIRA で 解決済み としてマークすると、TeamCity ログに 修正済み ステータスで表示されます (解決時刻は実際には重要ではありません)。
TeamCity は、ビルドに表示される JIRA 課題のステータスを 10 分ごと、または新しいコミットが検出されたときに更新します。
JIRA への接続の構成
統合を有効にするには、 プロジェクト設定 | 課題トラッカー ページで Jira への接続を作成し、次の設定を指定します。
- 表示名
TeamCity UI に表示される外部接続名。
- サーバー URL
Jira インスタンスまたはサーバーの URL。 例: Jira クラウドの場合は
https://myinstance.atlassian.net- ログイン
セルフホスト型の Jira インスタンスは、アクセストークンまたは通常のユーザー名 / パスワード認証による認証をサポートしています。
トークン認証: このフィールドは空欄のままにしてください。
基本認証: ユーザー名を入力してください。
Jira クラウド接続の場合は、ユーザーのメールアドレスを入力してください。
- パスワードまたはトークン
セルフホスト型 Jira (トークンベース認証): アクセストークンを入力してください。
セルフホスト型 Jira (基本認証): ユーザーパスワードを入力してください。
クラウド Jira: API トークン(英語)を入力してください。
- プロジェクトの鍵
Jira 内の課題への参照として認識される文字列を指定するには、スペースで区切られた プロジェクトキーのリストを入力します。 例: プロジェクトキーが
ウェブの場合、VCS コメントに記載されているウェブ-101などの課題キーは、対応する課題へのリンクに変換されます。すべてのプロジェクトの鍵を自動的に読み込むこともできます: すべての JIRA プロジェクトを自動的に使用 を有効化し、JIRA サーバーへの接続をテストします。 接続に成功すると、 プロジェクトの鍵 フィールドに自動的に入力されます。 TeamCity は JIRA で新しく作成されたプロジェクトを検出し、プロジェクトの鍵のリストを自動的に同期します。
- JIRA Cloud クライアント ID
TeamCity がビルドステータスを JIRA に報告できるように指定します。 Jira クラウドインスタンスのみをサポートします。 詳細については、 TeamCity ビルドステータスの JIRA Cloud への報告 のセクションを参照してください。
- Jira Cloud サーバーシークレット 秘密鍵？ no, シークレット? wait must final only JSON. Need correct.
TeamCity がビルドステータスを JIRA に報告できるように指定します。 Jira クラウドインスタンスのみをサポートします。 詳細については、 TeamCity ビルドステータスの JIRA Cloud への報告 のセクションを参照してください。
Jira への接続で指定されたユーザーは、Jira の問題を表示するための十分な権限を持っている必要があることに注意してください。 これにより、TeamCity は課題に関する情報を取得して UI に表示できるようになります。
TeamCity ビルドステータスの JIRA Cloud への報告
TeamCity はビルドステータスを JIRA Cloud にリアルタイムで報告できます。 VCS コミットメッセージで JIRA 課題の鍵に言及すると、TeamCity はこのコミットを含むビルドの実行時にそのメッセージを検出します。 ビルドステータスは Jira クラウドに送信され、Jira タスクの詳細に表示されます。
ステータスをクリックすると、 ビルド (通常および 複合ビルドの場合) または デプロイ (デプロイビルドの場合) タブで詳細を確認できます。
機能の有効化
TeamCity がビルド / デプロイ情報を JIRA Cloud に送信するようにするには：
Jira Cloud への接続を構成するときは、 Jira クラウドクライアント ID および サーバーシークレット設定を指定します。
Jira クラウド統合 ビルド機能をビルド構成に追加し、Jira クラウドへの事前構成された接続を選択します。
デプロイビルド構成の場合は、環境タイプ (テストや 本番など) と環境名を指定します。 これらのオプションは、Jira Cloud でデプロイ情報を表示するために必要です。