TeamCity と Bugzilla の統合
TeamCity を Bugzilla (3.0 以降) と統合して、TeamCity UI から Bugzilla の課題へのリンクを提供できます。
TeamCity UI で Bugzilla の課題へのリンクを表示
Bugzilla との統合が有効になっている場合、TeamCity は VCS コミットのコメントに記載されている課題 ID を自動的に検出します。 これらの ID を Bugzilla の対応する課題へのリンクに変換し、UI で TeamCity ユーザーに表示します:
TeamCity UI で課題の基本的な詳細を表示するには、関連するビルドの結果の 変更 タブを開き、課題 ID の横にあるアイコンにカーソルを合わせます。
ビルドで修正された問題は、ビルド結果の 課題 タブで確認できます。
ビルド構成全体に関連する問題 (個々のビルドだけでなく) を表示するには、 ビルド構成ホーム ページの 課題ログ タブを使用します。 リストを特定の範囲のビルドにフィルター処理したり、 解決された課題のみを表示オプションを有効にしてビルドで修正された課題のみを表示したりできます。
Bugzilla 統合から最大の利益を得るには、次の推奨事項に従ってください。
バージョン管理への変更をコミットするとき、 課題 ID を必ず記載する はコミットへのコメントの修正に関連していました。
修正された課題を Bugzilla で 解決済み としてマークすると、TeamCity ログで 修正済み ステータスとして表示されます (解決した時刻はあまり重要ではありません)。
Bugzilla への接続の設定
統合を有効にするには、 プロジェクト設定 | 課題トラッカー ページで Bugzilla への接続を作成し、次の設定を指定します。
設定 | 説明 |
|---|---|
接続タイプ | リストから Bugzilla を選択します。 |
表示名 | 接続名を指定して、他の接続と区別します。 |
サーバー URL | Bugzilla インスタンスの URL を入力します。 |
ユーザー名 | Bugzilla ユーザーアカウントのユーザー名を入力します。 |
パスワード | Bugzilla ユーザーアカウントのパスワードを入力します。 |
発行 ID パターン | Java 正規表現 パターンを指定して、コメントテキスト内の課題 ID を認識します。 一致したテキスト (グループが定義されている場合は最初のグループ) が課題番号として使用されます。 最も一般的なケースは |
Bugzilla への接続で指定されたユーザーは、Bugzilla の問題を表示するための十分な権限を持っている必要があることに注意してください。 これにより、TeamCity は課題に関する情報を取得して UI に表示できるようになります。
既知の課題
Bugzilla には、問題のために生成された XML に関する既知の問題がいくつかあり、そのため、Bugzilla との通信が困難になっています。 ただし、これは通常、Bugzilla の設定を調整することで修正できます。
path/to/bugzilla.dtd が見つかりませんエラーが表示される場合、これは、問題 XML に URL ではなく
Bugzilla DTDファイルへの相対パスが含まれていることを意味します。 これを修正するには、Bugzilla でサーバー URL を設定します。時々、
SAX 解析例外が 要素タイプフラグに関連付けられた属性 type_id にはオープンクォートが必要ですと表示される場合があります。 これは、生成された XML がバンドルされたBugzilla DTDに対応していないために発生します。 これを修正するには、Bugzilla DTDファイルでタイプ ID属性を#暗黙指定(オプション) にします。