GitHub を Azure Boards にリンクする

完了

GitHub を使い、Azure Boards で作業を追跡する

作業の計画と追跡には Azure Boards を、ソフトウェア開発のソース管理には GitHub を使います。

Azure Boards を GitHub リポジトリと接続し、GitHub のコミット、pull request、issue を Boards の作業項目にリンクできるようにします。

GitHub と Azure Boards の統合を示すスクリーンショット。

Azure Boards アプリ

この統合を作成するには、Azure Boards と GitHub 間のブリッジとして機能する Azure Boards アプリを使います。

アプリをインストールするには、GitHub リポジトリまたは GitHub 組織の管理者または所有者でなければなりません。

アプリは GitHub Marketplace からインストールされます。 Azure Boards アプリ

Azure Boards アプリの統合を示すスクリーンショット。

GitHub に認証する

Azure Boards を GitHub に接続できます。 GitHub がクラウドの中にある場合、GitHub 接続を追加すると、認証オプションは次のようになります。

  • ユーザー名/パスワード
  • 個人用アクセス トークン (PAT)

接続の作成に関する説明は、「Azure Boards を GitHub に接続する」を参照してください。

Azure Boards アプリのページから、他の Azure Boards、Azure DevOps Projects、GitHub.com リポジトリを構成することや、現在の構成を変更することができます。

Azure Boards アプリを使って Azure Boards を GitHub と統合すると、Azure Boards の Web ポータルからリポジトリを追加または削除できるようになります。

サポートされている統合シナリオ

Azure Boards - GitHub 統合では、次の接続がサポートされます。

  • GitHub から:

    • GitHub アカウントまたは組織のすべてのリポジトリ、または選択したリポジトリの統合をサポートする。
    • 統合に参加する GitHub リポジトリを追加または削除し、接続するプロジェクトを構成する。
    • Azure Boards - GitHub 統合を中断するか、アプリをアンインストールする。
  • Azure Boards から:

    • 1 つ以上の GitHub リポジトリを Azure Boards プロジェクトに接続する。
    • Azure Boards プロジェクト内の GitHub 接続との間で GitHub リポジトリを追加または削除する。
    • プロジェクトの GitHub 接続を完全に削除する。
    • 同じ Azure DevOps 組織またはコレクション内の 1 つ以上の Azure Boards プロジェクトに GitHub リポジトリの接続を許可する。

Azure Boards と GitHub の統合では、次の運用タスクがサポートされています。

  • 作業項目と GitHub メンションに基づく GitHub コミット、pull request、issue の間にリンクを作成する。
  • GitHub メンションを使う場合に、fix、fixes、fixed を使って、作業項目を "Done"(終了) または "Completed"(完了) 状態に状態遷移することをサポートする。
  • 作業項目から GitHub コミット、pull request、または issue にリンクするときに、ディスカッション コメントを GitHub に投稿することで、完全に追跡できるようにする。
  • 作業項目の [Development](開発) セクション内の GitHub コード成果物へのリンクを表示する。
  • かんばんボード カードに注釈としてリンクされている GitHub 成果物を表示する。
  • GitHub リポジトリに追加されたかんばんボード列の状態バッジをサポートする。

現時点では、次のタスクはサポートされていません。

  • GitHub 成果物へのリンクを含む作業項目にクエリを実行する。 ただし、外部リンク数が 0 より大きい作業項目に対してクエリを実行することができます。

詳細については、次を参照してください。