SCMシステムのブランチを追跡する

ALM Octaneは、バックログ項目に関連するブランチを追跡するのに役立ちます。

たとえば、フィーチャーを開発するためにカスタムブランチを作成する場合、ブランチ内のコミットとプル要求を確認できます。QAは、ブランチがマージされているかどうかを確認できます。

概要

ALM Octaneを使用すると、Jenkinsを介してSCMシステムのブランチを追跡し、リリースとビルドの品質への影響の詳細を取得できます。たとえば、フィーチャーとそのユーザーストーリーのコンテキストでブランチの詳細を確認したり、マスターにマージされたかどうかを確認したりできます。

Jenkinsプラグインによってブランチが挿入されると、関連するすべてのデータがALM Octaneに表示されます。ブランチがコミットまたはプル要求インジェクションを介してインジェクトされる場合、ブランチ名と関連項目のみが表示されます。

現在、次のSCMツールがサポートされています。

ブランチを挿入してバックログ項目に関連付けるには、ALM Octaneには次のものが必要です。

ブランチインジェクションは、Jenkinsプラグインバージョン6.9以降でサポートされています。
ALM Octaneは、メッセージパターンに基づいて、ブランチを関連するフィーチャー、ユーザーストーリー、品質ストーリー、または不具合に関連付けます。フィーチャーには、子エンティティのコミットに基づくブランチ、およびフィーチャーに手動で関連付けられたブランチも表示されます。
SCMシステムに変更をコミットする場合、ブランチ名には、DevOps > SCM変更パターン設定ページで定義されているパターンの1つを含める必要があります。これにより、ALM Octaneは、ブランチ名のパターンに基づいて、ブランチを関連するフィーチャー、ユーザーストーリー、品質ストーリー、または不具合に関連付けることができます。詳細については、SCM変更パターンのカスタマイズを参照してください。

ALMOctaneにあなたのSCMからブランチの詳細を注入するJenkinsでジョブを作成します。

ブランチコレクタジョブを作成するには:

Jenkinsでは、ビルド後のアクションと呼ばれるALM Octane branch collectorでジョブを設定します。
ALM Octaneエリア。ブランチを挿入するALM Octane URLとワークスペースを入力します。

ALM Octaneを開くブラウザーのアドレスバーからURLをコピーできます。
SCMツール領域。SCMツールタイプ、リポジトリURL、およびリポジトリ資格情報を入力します。

BitbucketサーバーとGithubサーバーは、ユーザー/パスワードとPAT (パーソナルアクセストークン) の両方をサポートしています。Github CloudはPATのみをサポートします。詳細については、Jenkinsプラグイン内のヘルプを参照してください。
SSH形式を使用します。このリポジトリを使用し、ALM Octaneパイプラインに接続されている他のすべてのジョブがSSH形式を使用している場合は、チェックボックスを選択します。

注: SSH形式の設定が、このリポジトリを使用する他のジョブと一致していることを確認してください。これにより、ALM Octaneが、コミット、ブランチ、プル要求に関連付けられたSCMリポジトリを正しく識別できるようになります。
ブランチフィルター (オプション)。正規表現を使用して、リポジトリ内の特定のブランチをフィルタリングします。

標準設定設定を変更するには:

標準設定では、ALMOctaneは、最後の90日間にアクティブだった枝を収集します。変更するには、パラメーターbranches_active_branch_daysを使用します。

ALM Octaneのブランチは、フィーチャー、バックログ項目、またはチームのコンテキストで追跡できます。

バックログのブランチの詳細

バックログモジュールのブランチタブには、SCMコミットメッセージを使用してALM Octaneフィーチャーとバックログ項目に関連付けられているブランチの詳細が表示されます。各項目について、次のことがわかります。

ブランチID、名前、およびリポジトリ。
最後のコミットバージョン、最後のコミッター、およびそれがマージされたかどうか。
関連するバックログ項目。項目を開いて詳細を表示するには、バックログ項目のIDをクリックします。
プル要求メッセージ、ソースブランチ、およびSCMユーザー。

ヒント: ユーザーを基準に絞り込む場合は、SCMユーザーがALM Octaneユーザーにマップされていることを確認してください。詳細については、SCMユーザーをALM Octaneユーザーにマッピングするを参照してください。

ブランチに部分的な詳細が表示される場合、これは、詳細がブランチインジェクションからではなく、関連するコミットまたはプル要求からのものであることを示しています。

ブランチの詳細にドリルダウンして、SCMのブランチへのリンクにアクセスできます。

ブランチをフィーチャーまたはバックログ項目に手動で関連付けるには、ブランチの詳細ペインでバックログ項目にリンクをクリックします。リンクを削除するには、バックログ項目のリンク解除をクリックします (フィーチャー、ユーザーストーリー、品質ストーリー、または不具合のコンテキストで)。

フィーチャー、ユーザーストーリー、品質ストーリー、または不具合のコンテキストからブランチにリンクをクリックすることもできます。関連する項目も自動的にブランチにリンクされ、トレーサビリティが得られます。

注: ALM Octaneは、フィーチャーを直接関連付けられたブランチと、ユーザーストーリーによって伝達されたブランチの両方に関連付けます。フィーチャーレベルでは、フィーチャーに直接関連付けられているブランチのみをリンク解除できます (伝播されたブランチはリンク解除できません)。

チームバックログのブランチ

チームバックログモジュールでは、特定のフィーチャーやバックログ項目に関連付けられていないブランチを含め、ワークスペース内のすべてのブランチを確認できます。

チーム、チームメンバー、リリース、マイルストーンでブランチをフィルタリングできます。

参照情報: