Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
このクイック スタートでは、GitHub 用の Azure Boards アプリをインストールして、Azure Boards を GitHub リポジトリに接続します。 GitHub.com リポジトリを使って Azure Boards プロジェクトを接続するとき、GitHub コミットや pull request から作業項目へのリンクをサポートします。 ソフトウェアの開発に GitHub を使用し、Azure Boards をご自分の作業の計画と追跡に使用できます。 GitHub アカウントまたは組織に GitHub 用の Azure Boards アプリをインストールしたら、プロジェクトから接続する GitHub リポジトリを選択します。
GitHub 用の Azure Boards アプリがサポートする統合の概要については、 Azure Boards と GitHub の統合に関する記事をご覧ください。
前提条件
| カテゴリ | 必要条件 |
|---|---|
| アクセス許可 | - プロジェクト コレクション管理者 グループのメンバー。 プロジェクトを作成した場合は、アクセス許可があります。 - Azure Boards アプリをインストールするための GitHub 組織の [管理者] または [所有者]。 - GitHub リポジトリの [読み取り] アクセス許可。 |
| プロジェクト会員 | プロジェクトのメンバー。 |
重要
リポジトリが OAuth などの別の認証の種類を使用して既に接続されている場合は、GitHub アプリを使用して再接続する前に、そのリポジトリを既存の接続から削除する必要があります。 GitHub App を構成する前に、この記事の後半の「GitHub リポジトリの追加または削除」に記載されている手順に従ってください。
Azure DevOps 組織を複数の GitHub リポジトリに接続するには、それらのリポジトリの管理者でなければなりません。 GitHub リポジトリを複数の Azure DevOps 組織に接続しないでください。
Azure Boards アプリをインストールして構成する
インストールシーケンスは、アカウントの構成によって異なる場合があります。 必要に応じて、画面の指示に従って次の手順を実行します。
GitHub Marketplace で Azure Boards アプリに移動します。
[ プランと価格] の [ 無料] で [インストール] を選択 します。
[ Azure Boards のインストールと承認] で、Azure Boards に接続するリポジトリを選択し、[ インストール] と [承認] を選択します。
この例では 、すべてのリポジトリを使用します。
![スクリーンショットは、すべてのリポジトリが選択された [インストールと承認] ページを示しています。](media/github-app/install-options.png?view=azure-devops-server)
GitHub.com に接続する Azure DevOps 組織と Azure Boards プロジェクトを選びます。
![スクリーンショットは、[Azure Boards プロジェクトのセットアップ] ページを示しています。ここで、組織とプロジェクトを選択します。](media/github-app/choose-azure-boards-project.png?view=azure-devops-server)
接続できるプロジェクトは一度に 1 つだけです。 他のプロジェクトを接続したい場合は、この記事で後述する「他のプロジェクトまたはリポジトリを構成する」の説明に従って、後で行うことができます。
Azure Boards 組織へのアクセス権の付与
必要に応じて、GitHub に Azure DevOps 組織へのアクセス権を付与するには、次の手順を実行します。
GitHub Web ポータルで、プロファイル メニューから [設定] を開きます。
![プロファイルの [設定] オプションを示すスクリーンショット。](media/troubleshoot/choose-settings.png?view=azure-devops-server)
[統合]の下で [アプリケーション] を選択します。
Select [承認された OAuth Apps]>[Azure Boards] を選択します。
[組織のアクセス権] の下で、表示された問題を解決します。 [Access request pending](保留中アクセス要求) があることが示されているすべての組織にアクセスを許可するには、 [許可] を選びます。
サード パーティのアプリケーション アクセス ポリシーを確認する
GitHub 組織が Azure Boards アプリに対してサードパーティ製のアプリケーション アクセスを許可していることを確認します。 サード パーティのアクセスが制限されている場合、Azure DevOps からリポジトリを追加すると、空のリストが表示されたり、エラーが発生したりする可能性があります。
アクセスを有効にするには:
GitHub で組織を開き、[設定] > OAuth アプリ ポリシーに移動します。
Azure Boards アプリを明示的に承認するか (推奨)、またはすべてのサードパーティ アプリケーションの制限を削除します。
注
この設定を変更するには、組織の所有者または管理者である必要があります。
接続を使用する
この時点で、Azure Boards と GitHub の統合は完了しています。 次の手順をスキップするか実行することにより、接続によってサポートされている機能について理解できます。
ボードで [新しい作業項目] を選択し、Azure Boards プロジェクトによって使用されるプロセス モデルに応じて、"README にバッジを追加" という名前の新しい作業項目 (問題 (基本)、ユーザー ストーリー (アジャイル)、または製品バックログ項目 (スクラム)) を入力します。
"README にバッジを追加" というタイトルの作業項目がボードに表示されます。
作業項目を開き、 [開発] セクションに移動し、 [追加リンク]を選択します。
[リンクの種類] で、[GitHub Pull Request] を選択します。
リポジトリを選択し、pull request ID とオプションのコメントを入力します。
[+ リンクの追加] を選択します。
![スクリーンショットは、リポジトリの選択と、pull request ID と省略可能なコメントの入力用の空のボックスを示す、ユーザー ストーリーの [リンクの追加] アクションを示しています。](media/troubleshoot/add-link-to-pull-request-2.png?view=azure-devops-server)
次のアクションはバックグラウンドで自動的に実行されます。
- 接続された GitHub リポジトリの一覧にある最初のリポジトリの README ファイルにバッジを追加します。
- バッジを README ファイルに追加することにより行われた更新の GitHub コミットを作成します。
- GitHub pull request を作成し、README ファイルに加えられた変更をマージします。
- GitHub のコミットと pull request を、ステップ 1 で作成した作業項目にリンクします。
作業項目から最初の pull request リンクを選択します。
GitHub の pull request が新しいブラウザー タブで開きます。
[Merge pull request](pull request をマージする) を選択します。
リポジトリの README ファイルに移動し、追加されたバッジを表示します。
詳細については、「 GitHub リポジトリの状態バッジを追加する」を参照してください。
他のプロジェクトまたはリポジトリを構成する
Azure Boards アプリのページから、他の Azure Boards、Azure DevOps Projects、GitHub.com リポジトリを構成することや、現在の構成を変更することができます。 詳細については、「リポジトリの 追加または削除、または Azure Boards からの接続の削除」を参照してください。
リポジトリを追加または削除する、または Azure Boards から接続を削除する
接続に関する問題が発生した場合は、接続を削除し、新しい接続からやり直すことをお勧めします。
Azure DevOps のプロジェクトから、 [プロジェクト設定]>[GitHub 接続]に移動します。
リポジトリを追加または削除するには、接続の [その他のオプション] 省略記号を選択し、メニューから [リポジトリの追加] または [リポジトリの削除] を選択します。
![[その他] オプションの [GitHub 接続] メニューを示すスクリーンショット。](media/connect-cloud/connection-menu.png?view=azure-devops-server)
すべてのリポジトリと接続を削除するには、 [接続の削除] オプションを選びます。 次に、 [削除] を選んで確定します。
リポジトリへのアクセスを変更する
GitHub Web ポータルで、プロファイル メニューから [設定] を開きます。
[ Integrations>Applications] を選択します。 [ Installed GitHub Apps]\(インストールされた GitHub アプリ\) で、[構成] を選択 します。
![スクリーンショットは、Azure Boards でインストールされた GitHub Apps と [構成] オプションを示しています。](media/change-repo-access/open-installed-github-apps.png?view=azure-devops-server)
Azure Boards の構成ページが開きます。
[リポジトリ アクセス] セクションまで下にスクロールします。
必要なオプション ([すべてのリポジトリ] または [選択したリポジトリのみ]) を選択します。
[選択したリポジトリのみ] を選択する場合は、Azure Boards との統合に加えたいリポジトリを選択します。
![[リポジトリ] アクセスを示すスクリーンショット。選択したリポジトリを選択できます。](media/change-repo-access/choose-repositories.png?view=azure-devops-server)
[保存] を選択します。
Azure Boards 統合を中断またはアンインストールする
前の手順のステップ 2 から、 [危険なゾーン] セクションまで下にスクロールします。
![[危険ゾーン] セクションを示すスクリーンショット。中断とアンインストールのオプションが表示されています。](media/change-repo-access/danger-zone.png?view=azure-devops-server)
統合を中断するには、 [中断]を選択します。 確認ウィンドウで、[ OK] を 選択して中断を確認します。
統合の中断を解除するには、 [中断の解除]を選択します。
Azure Boards アプリをアンインストールするには、 [アンインストール]を選択し、ポップアップの確認ウィンドウで [OK] を選択します。
Azure Boards-GitHub 接続の更新
GitHub 用 Azure Boards アプリによってサポートされるリポジトリを変更した場合、Azure Boards GitHub 接続にリダイレクトされる可能性があります。 GitHub に接続できなくなった Azure Boards 内のリポジトリは削除することをお勧めします。 詳しくは、「GitHub リポジトリの追加または削除」を参照してください。
GitHub 用 Azure Boards アプリをアンインストールした場合、Azure Boards の [プロジェクト設定]>GitHub 接続に次のメッセージが表示されます。 [接続の削除] を選択し、既に作成されているすべての GitHub 接続を削除します。 詳しくは、「GitHub リポジトリの追加または削除」を参照してください。
