GitHub のコミット、プル要求、ブランチ、および問題を Azure Boards の作業項目にリンクする

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

この記事では、Azure Boards プロジェクトを GitHub リポジトリに接続した後で、作業項目を GitHub コミット、プル要求、ブランチにリンクする方法について説明します。 コミットとブランチに #mention 構文を使用するか、Azure Boards 作業項目から直接 GitHub コミット、プル要求、またはブランチ リンクを追加できます。

前提条件

GitHub から Azure Boards 作業項目にリンクするには AB# を使います

GitHub のコミット、pull request、または issue から Azure Boards 作業項目へのリンクを作成するには、次の構文を使います。 コミット メッセージのテキスト内に AB#ID を入力します。 pull request または issue の場合は、タイトルまたは説明内に AB#ID を入力します。 コメント内で AB#ID を使用しても、作業項目へのリンクは作成されません。

AB#{ID}

たとえば、AB#125 は作業項目 ID 125 にリンクします。

コミットまたは pull request メッセージを入力して、作業項目を切り替えることもできます。 システムは、 {state} または {state category}を fix、 fixes、 fixedと共に認識し、次の #メンション項目に適用します。

プル要求の説明に有効な状態名 ( Closed AB#1234など) が含まれている場合、システムは参照先の作業項目をその特定の状態に更新します。 状態名が直接認識されない場合、Azure Boards は、 Resolved や Completedなどのワークフロー カテゴリとの照合を試みます。 一致するものが見つかった場合、作業項目は、そのカテゴリで定義されている最初の使用可能な状態に遷移します。

既定では、fix、fixes、またはfixedで参照される作業項目は、解決済みカテゴリに関連付けられている最初の状態に遷移します。 現在のプロセスにこのような状態が存在しない場合は、代わりに作業項目が 完了 カテゴリの最初の状態に遷移します。

詳細については、「 Azure Boards のバックログとボードでワークフロー カテゴリの状態を使用する方法」を参照してください。

例については、次の表を確認してください。

AB# を使用して作業項目へのリンクを追加すると、それらのリンクが pull request の [開発 ] セクションに表示されます。

作業項目から GitHub ブランチを作成する

作業項目から GitHub ブランチを直接作成するには、以下の手順を実行します。

1. ボードから、GitHub ブランチを作成する作業項目を見つけます。

2. ワーク項目アクション>新しいGitHubブランチを選択します。

   

3. [ GitHub ブランチの作成 ] ダイアログで、ブランチ名を入力し、GitHub リポジトリとベース ブランチを選択します。

4. 作成を選択します。

   

   Azure Boards によって、指定した GitHub リポジトリにブランチが作成され、作業項目にリンクされます。 詳細については、 Azure Boards-GitHub 統合に関するページを参照してください。

作業項目のリンクを GitHub ブランチ、コミット、または pull request に追加する

1. 作業項目を開き、[ リンク ] タブに移動します。

   

2. [ リンクの追加 ] ダイアログで、 いずれかの GitHub リンクの種類を選択し、GitHub リポジトリを選択し、GitHub ブランチへの URL を入力し、コミットまたはプル要求を選択して、[ リンクの追加] を選択します。

   次の例では、GitHub pull request へのリンクを追加します。

   

   Azure Boards では、有効なリンクが入力されたかどうかの検査を完了します。 リンク先の GitHub リポジトリが Azure Boards プロジェクトに接続されている必要があります 。または、検証が失敗します。

リンクの自動更新

複数のイベントによって作業項目フォームのリンクが自動的に更新されるため、手動で作成する必要はありません。 これには以下が含まれます:

[開発] セクションでリンクを表示または開く

作業項目フォーム内の [開発] セクションには、GitHub のコミットと pull request に対して作成されたリンクが GitHub アイコンと共に一覧表示されます。

表示されたリンクを選ぶと、GitHub のコミットか pull request が開きます。

ボード上で GitHub オブジェクトを表示する

ボードで GitHub アノテーションを有効にすると、リンクされた GitHub コミット、pull request、または issue をすばやく開いて詳細を確認できます。 詳細については、「カードの カスタマイズ」を参照してください。

次のステップ

関連記事

• Azure Boards と GitHub の統合
• Azure Boards のバックログとボードでワークフロー カテゴリの状態がどのように使用されるかを理解する
• 作業項目をオブジェクトにリンクする
• GitHub と Azure Boards の統合のトラブルシューティング