GitHub 用の Azure Boards アプリをインストールする

  • [アーティクル]

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

GitHub 用 Azure Boards アプリをインストールし、Azure Boards を GitHub リポジトリに接続します。 GitHub.com を使って Azure Boards プロジェクトを接続するとき、GitHub コミットや pull request から作業項目へのリンクをサポートします。 ソフトウェアの開発に GitHub を使用し、Azure Boards をご自分の作業の計画と追跡に使用できます。

GitHub 用の Azure Boards アプリがサポートする統合の概要については、Azure Boards と GitHub の統合に関する記事をご覧ください。 GitHub アカウントまたは組織に GitHub 用 Azure Boards アプリをインストールしたら、プロジェクトから接続する GitHub リポジトリを選択します。

前提条件

  • Azure Boards アプリをインストールするには、GitHub 組織の管理者または所有者である必要があります。
  • Azure Boards プロジェクトに接続するには、GitHub リポジトリの読み取りアクセス許可が必要です。 また、プロジェクト コレクション管理者グループのメンバーである必要があります。 自分でプロジェクトを作成した場合は、アクセス許可を持っています。

重要

リポジトリが別の認証の種類 (OAuth など) で既に接続されている場合、GitHub App 経由で再接続する前に、そのリポジトリを既存の接続から削除する必要があります。 GitHub App を構成する前に、この記事の後半の「GitHub リポジトリの追加または削除」に記載されている手順に従ってください。

Azure DevOps 組織を複数の GitHub リポジトリに接続するには、それらのリポジトリの管理者でなければなりません。 ただし、1 つの GitHub リポジトリを複数の Azure DevOps 組織には接続しないでください。

Azure Boards 組織へのアクセス権の付与

組織にアクセス権を付与するには以下の手順を実行します。

  1. GitHub Web ポータルで、プロファイル メニューから [設定] を開きます。

    Screenshot of open profile, choose Settings.

  2. [統合] の下で [アプリケーション] を選択します。

  3. [承認済み OAuth Apps]>[Azure Boards] を選択します。

    Screenshot of Authorized OAuth Apps tab, choose Azure Boards.

  4. [組織のアクセス権] の下で、表示された問題を解決します。 [Access request pending] (保留中アクセス要求) があることが示されているすべての組織にアクセスを許可するには、[許可] を選びます。

    Screenshot of Organization access with organizations without access.

Azure Boards アプリをインストールして構成する

  1. GitHub Marketplace で Azure Boards アプリに移動します。

  2. [プランの設定] を選択します。

    Screenshot of GitHub Marketplace, Set up a plan button.

  3. Azure Boards に接続する GitHub 組織を選びます。

    Screenshot showing Install Azure Boards dialog.

  4. Azure Boards に接続するリポジトリを選択します。

    次の例では、すべてのリポジトリに接続することを選択します。

    Screenshot showing all repositories selected.

  5. GitHub.com に接続する Azure DevOps 組織と Azure Boards プロジェクトを選びます。

    Screenshot of setting up connection dialog.

    接続できるプロジェクトは一度に 1 つだけです。 他のプロジェクトを接続したい場合は、この記事で後述する「他のプロジェクトまたはリポジトリを構成する」の説明に従って、後で行うことができます。

  6. Azure Boards 組織が GitHub.com と接続するのを認可します。

    Screenshot of Azure Boards authorization dialog.

  7. 接続する GitHub.com リポジトリを確認します。 接続する各リポジトリを選択します。 統合に加えたくないリポジトリの選択を解除します。

    Screenshot of Confirm your GitHub repositories dialog.

接続を使用する

この時点で、Azure Boards と GitHub の統合は完了しています。 次の手順をスキップするか実行することにより、接続によってサポートされている機能について理解できます。

  1. ボードで [新しい項目] を選択し、Azure Boards プロジェクトによって使用されるプロセス モデルに応じて、"README にバッジを追加" という名前の新しい作業項目 (問題 (基本)、ユーザー ストーリー (アジャイル)、または製品バックログ項目 (スクラム)) を入力します。

    "README にバッジを追加" というタイトルの作業項目がボードに表示されます。

  2. 作業項目を開き、[リンクの追加] で pull request を選択します。

  3. リポジトリを選択し、pull request ID とオプションのコメントを入力します。

  4. [+ リンクの追加] を選択します。

    Screenshot of Add link action in user story, showing repository selection and empty boxes for input of pull request ID and optional comment.

    バックグラウンドでは、以下のアクションが実行されます。

    • 接続された GitHub リポジトリの一覧にある最初のリポジトリの README ファイルにバッジを追加します。
    • バッジを README ファイルに追加することにより行われた更新の GitHub コミットを作成します。
    • GitHub pull request を作成し、README ファイルに加えられた変更をマージします。
    • GitHub のコミットと pull request を、ステップ 1 で作成した作業項目にリンクします。

  5. 作業項目から最初の pull request リンクを選択します。

    Screenshot of issue form for pull request opened in GitHub.

    GitHub の pull request が新しいブラウザー タブで開きます。

  6. [Merge pull request](pull request をマージする) を選択します。

    Screenshot of example pull request in GitHub.

  7. リポジトリの README ファイルに移動し、追加されたバッジを表示します。

    Screenshot of GitHub repo with badge added.

    詳しくは、GitHub README ファイルに追加するステータス バッジの構成に関するページをご覧ください。

他のプロジェクトまたはリポジトリを構成する

Azure Boards アプリのページから、他の Azure Boards、Azure DevOps Projects、GitHub.com リポジトリを構成することや、現在の構成を変更することができます。 詳しくは、GitHub リポジトリのアクセスの変更、または統合の中断またはアンインストールに関する記事をご覧ください。

リポジトリを追加または削除する、または Azure Boards から接続を削除する

接続に関する問題が発生した場合は、接続を削除し、新しい接続からやり直すことをお勧めします。

  1. リポジトリを追加または削除するには、接続の [その他のオプション] を選び、メニューから [リポジトリの追加] または [リポジトリの削除] を選びます。

    Screenshot of GitHub connection menu of More options.

  2. すべてのリポジトリと接続を削除するには、[接続の削除] オプションを選びます。 次に、[削除] を選んで確定します。

    Screenshot of confirmation removal of GitHub connection.

  1. リポジトリを追加または削除するには、接続の アクション アイコンを開き、メニューから [リポジトリの追加] または [リポジトリの削除] を選びます。

    Screenshot of add or remove GitHub repos.

  2. すべてのリポジトリと接続を削除するには、[接続の削除] オプションを選びます。 次に、[削除] を選んで確定します。

    Screenshot of confirmation of GitHub connection removal dialog.

リポジトリへのアクセスを変更する

  1. GitHub 組織の Web ポータルにサインインし、[アカウント設定] を開きます。

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. [インストール済み GitHub アプリ] を選択し、[Azure Boards] の横にある [構成] を選択します。
    Screenshot of open Organization account, Installed GitHub Apps, Azure Boards, Configure.

    Azure Boards の構成ページが開きます。

  3. [リポジトリ アクセス] セクションまで下にスクロールします。

  4. 必要なオプション ([すべてのリポジトリ] または [選択したリポジトリのみ]) を選択します。

    [選択したリポジトリのみ] を選択する場合は、Azure Boards との統合に加えたいリポジトリを選択します。

    Screenshot of Repository access, choose Only select repositories.

  5. 終わったら [保存] を選択します。

Azure Boards 統合を中断またはアンインストールする

  1. 前の手順のステップ 2 から、[危険なゾーン] セクションまで下にスクロールします。

    Screenshot of Azure Boards configuration, Danger zone section.

  2. 統合を中断するには、[中断] を選択します。 ポップアップの確認ウィンドウで、[OK] を選択して中断を確認します。

    Screenshot of suspension confirmation.

    統合の中断を解除するには、[中断の解除] を選択します。

  3. Azure Boards アプリをアンインストールするには、[アンインストール] を選択し、ポップアップの確認ウィンドウで [OK] を選択します。

    Screenshot of uninstall confirmation.

Azure Boards-GitHub 接続の更新

GitHub 用 Azure Boards アプリによってサポートされるリポジトリを変更した場合、Azure Boards GitHub 接続にリダイレクトされる可能性があります。 GitHub に接続できなくなった Azure Boards 内のリポジトリは削除することをお勧めします。 詳しくは、「GitHub リポジトリの追加または削除」を参照してください。

GitHub 用 Azure Boards アプリをアンインストールした場合、Azure Boards の [プロジェクト設定]>GitHub 接続に次のメッセージが表示されます。 [接続の削除] を選択し、既に作成されているすべての GitHub 接続を削除します。 詳しくは、「GitHub リポジトリの追加/削除」を参照してください。

Screenshot of uninstalled Azure Boards GitHub app.

次のステップ

GitHub コミットと pull request の作業項目とのリンク