SCMシステムのプル要求を追跡する

Jenkinsサーバーがプル要求を使用してソースコントロール管理 (SCM) システムと連携している場合、ALM Octaneは、バックログ項目に関連するプル要求を追跡するのに役立ちます。

たとえば、QAがフィーチャーが完了していることを確認する場合、すべてのプル要求がマージされ、開いているプル要求がないことを確認できます。

概要

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

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

  • Bitbucketサーバー

  • Githubクラウド

  • Githubサーバー

トップに戻る

前提条件

  • プル要求は、Jenkinsプラグインバージョン6.2以降を使用するALM Octaneでサポートされています。

  • ALM Octaneは、コミットパターン、タイトル、および説明に基づいて、プル要求を関連するフィーチャー、ユーザーストーリー、品質ストーリー、または不具合に関連付けます。フィーチャーには、子エンティティのコミットに基づくプル要求、およびフィーチャーに手動で関連付けられたプル要求も表示されます。

  • SCMシステムに変更をコミットする場合、コミットメッセージまたはプル要求には、DevOps > SCM変更パターン設定ページで定義されているパターンの1つを含める必要があります。Java正規表現を使用して、標準設定のコミットメッセージとプル要求パターンを変更できます。詳細については、SCM変更パターンのカスタマイズを参照してください。

トップに戻る

Jenkinsでプル要求コレクタージョブを設定する

開始するには、ALMOctaneにあなたのSCMから収集プル要求の詳細にJenkinsでジョブを作成します。

  1. Jenkinsで、ALM Octaneプル要求コレクターと呼ばれるビルド後のアクションを使用してジョブを設定します。

  2. ALM Octane領域に、プル要求が表示されるALM Octane URLとワークスペースを入力します。

    ALM Octaneを開くブラウザーのアドレスバーからURLをコピーできます。

  3. SCMツール領域に、SCMツールの種類、リポジトリのURL、およびリポジトリのクレデンシャルを入力します。

    BitbucketサーバーとGithubサーバーは、ユーザー/パスワードとPAT (パーソナルアクセストークン) の両方をサポートしています。Github CloudはPATのみをサポートします。詳細については、Jenkinsプラグイン内のヘルプを参照してください。

  4. このリポジトリを使用し、ALM Octaneパイプラインに接続されているすべてのジョブがSSH形式を使用する場合は、チェックボックスSSH形式を使用を選択します。

    このリポジトリを使用する他のジョブと一貫性を保つことが重要です。これにより、ALM Octaneが、コミット、ブランチ、プル要求に関連付けられたSCMリポジトリを正しく識別できるようになります。

  5. (オプション) 各プル要求には、ソースブランチとターゲットブランチがあります。リポジトリ内の特定のブランチをフィルタリングするには (たとえば、プライベートブランチを除外するには)、正規表現を使用してソースブランチフィルターを定義します。マスターブランチをフィルタリングするには、ターゲットブランチフィルターを定義します。

標準設定設定の変更

標準設定では、ALM Octaneは、最新のデータ収集から追加されたプル要求を収集します。プル要求データの完全なコレクションをトリガーするには、パラメーターpullrequests_min_update_timeをゼロ (0) に設定します。

コミットに基づくプル要求の関連付けを無効にするには、パラメーターpullrequests_max_commits_to_collectをゼロ (0) に設定します。

プラグインUIで説明されている他のパラメーターを使用して、プル要求の最大数、またはプル要求ごとのコミットを変更できます。

トップに戻る

ALM Octaneでプル要求を追跡する

フィーチャー、バックログ項目、またはチームのコンテキストでプル要求を追跡できます。

バックログエンティティのプル要求

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

  • プル要求ID、名前、および状態。

  • プル要求が作成されたとき、マージされたかどうか、およびマージされたとき。

  • 関連するバックログ項目。項目を開いて詳細を表示するには、バックログ項目のIDをクリックします。

  • プル要求メッセージ、ソースブランチ、およびSCMユーザー。

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

プル要求の詳細にドリルダウンして、ソースブランチとターゲットブランチを確認したり、SCMのプル要求へのリンクにアクセスしたりできます。

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

注: フィーチャー内には、直接関連付けられたプル要求と、そのユーザーストーリーによって伝播されたリクエストが表示されます。フィーチャーレベルでは、フィーチャーに直接関連付けられているプル要求のみをリンク解除できます (伝播されたものはリンク解除できません)。

チームバックログのプル要求

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

これらは、チーム、チームメンバー、リリース、マイルストーンなどでフィルタリングできます。

トップに戻る

参照情報: