Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022
このクイック スタートでは、GitHub用のAzure Boards アプリをインストールして、Azure BoardsをGitHub リポジトリに接続します。 GitHub.com リポジトリと Azure Boards プロジェクトに接続する場合は、GitHub コミットやプルリクエストと作業項目とのリンクをサポートします。 GitHubを使用してソフトウェア開発を行い、Azure Boardsを使用して作業を計画および追跡できます。 GitHub アカウントまたは組織にGitHub用のAzure Boards アプリをインストールしたら、プロジェクトから接続するGitHub リポジトリを選択します。
GitHub用Azure Boards アプリがサポートする統合の概要については、Azure Boards-GitHub 統合を参照してください。
前提条件
| カテゴリ | 必要条件 |
|---|---|
| Permissions | - プロジェクト コレクション管理者 グループのメンバー。 プロジェクトを作成した場合は、アクセス許可があります。 Azure Boards アプリをインストールするためのGitHub組織の - Administrator または owner。 GitHub リポジトリの- Read アクセス許可。 |
| プロジェクト会員 | プロジェクトのメンバー。 |
重要
リポジトリが OAuth などの別の認証の種類を使用して既に接続されている場合は、GitHub アプリを使用して再接続する前に、そのリポジトリを既存の接続から削除する必要があります。 GitHub アプリを構成する前にこの記事で後述するGitHub リポジトリを追加または削除する手順に従います。
これらのリポジトリの管理者である場合は、Azure DevOps組織を複数のGitHub リポジトリに接続できます。 GitHub リポジトリを複数のAzure DevOps組織に接続しないでください。
Azure Boards アプリをインストールして構成する
インストールシーケンスは、アカウントの構成によって異なる場合があります。 必要に応じて、画面の指示に従って次の手順を実行します。
GitHub Marketplace のAzure Boards アプリに移動します。
[ プランと価格] の [ 無料] で [インストール] を選択 します。
Install & Authorize Azure Boards で、Azure Boardsに接続するリポジトリを選択し、インストールと承認を選択します。
この例では 、すべてのリポジトリを使用します。
スクリーンショットは、すべてのリポジトリが選択された [インストールと承認] ページを示しています。
GitHub.com に接続するAzure DevOps組織とAzure Boardsプロジェクトを選択します。
スクリーンショットには、Azure Boards プロジェクトのセットアップ ページが表示されており、そこでは組織とプロジェクトを選択します。 接続できるプロジェクトは一度に 1 つだけです。 他のプロジェクトを接続したい場合は、この記事で後述する「他のプロジェクトまたはリポジトリを構成する」の説明に従って、後で行うことができます。
Azure Boards 組織へのアクセス権を付与する
必要に応じて、Azure DevOps組織GitHubアクセス権を付与するには、次の手順を実行します。
GitHub Web ポータルで、プロファイル メニューから Settings を開きます。
プロファイルの [設定] オプションを示すスクリーンショット。
[統合]の下で [アプリケーション] を選択します。
Authorized GitHub Apps>Azure Boards を選択します。
スクリーンショットには、Azure Boardsが強調表示された承認済みのGitHubアプリが表示されます。
[組織のアクセス権] の下で、表示された問題を解決します。 [Access request pending](保留中アクセス要求) があることが示されているすべての組織にアクセスを許可するには、 [許可] を選びます。
スクリーンショットは、組織がアクセス権を持たない組織へのアクセスを示しています。
サード パーティのアプリケーション アクセス ポリシーを確認する
GitHub組織が、Azure Boards アプリに対するサード パーティ製アプリケーション アクセスを許可していることを確認します。 サードパーティのアクセスが制限されている場合、Azure DevOpsからリポジトリを追加すると、空のリストが表示されたり、エラーが発生したりする可能性があります。
アクセスを有効にするには:
GitHubで組織を開き、[設定] > OAuth アプリ ポリシーに移動します。
Azure Boards アプリを明示的に承認するか (推奨)、またはすべてのサード パーティ製アプリケーションの制限を削除します。
サード パーティ製のアプリケーション アクセス ポリシーを示すスクリーンショット。
注
この設定を変更するには、組織の所有者または管理者である必要があります。
接続を使用する
この時点で、Azure Boards GitHub統合は完了です。 次の手順をスキップするか実行することにより、接続によってサポートされている機能について理解できます。
ボードで新しい作業項目 を選択して、Azure Boards プロジェクトで使用されるプロセス モデルに応じて、"ReadME にバッジを追加する" という名前の新しい作業項目 (問題 (Basic)、ユーザー ストーリー (アジャイル)、または製品バックログ項目 (スクラム)) を入力します。
"README にバッジを追加" というタイトルの作業項目がボードに表示されます。
作業項目を開き、 [開発] セクションに移動し、 [追加リンク]を選択します。
Link の種類から、GitHub Pull Request を選択します。
リポジトリを選択し、pull request ID とオプションのコメントを入力します。
[+ リンクの追加] を選択します。
スクリーンショットは、リポジトリの選択と、pull request ID と省略可能なコメントの入力用の空のボックスを示す、ユーザー ストーリーの [リンクの追加] アクションを示しています。
次のアクションはバックグラウンドで自動的に実行されます。
- 接続されているGitHub リポジトリの一覧にある最初のリポジトリの README ファイルにバッジを追加します。
- バッジを README ファイルに追加して、更新のGitHubコミットを作成します。
- README ファイルに加えられた変更をマージするGitHubプル要求を作成します。
- GitHubコミットとプル要求を、手順 1 で作成した作業項目にリンクします。
作業項目から最初の pull request リンクを選択します。
GitHubで開かれたプルリクエストの問題フォームを示すスクリーンショットです。 GitHub pull request が新しいブラウザー タブで開きます。
[Merge pull request](pull request をマージする) を選択します。
スクリーンショットは、GitHub のプルリクエストの例を示しています。 リポジトリの README ファイルに移動し、追加されたバッジを表示します。
詳細については、「GitHub リポジトリの状態バッジの追加を参照してください。
他のプロジェクトまたはリポジトリを構成する
他のAzure Boards/Azure DevOps プロジェクトを構成したり、リポジトリを GitHub.com したり、Azure Boards アプリ ページから現在の構成を変更したりできます。 詳細については、「
リポジトリの追加または削除、またはAzure Boardsからの接続の削除
接続に関する問題が発生した場合は、接続を削除し、新しい接続からやり直すことをお勧めします。
Azure DevOpsのプロジェクトから、Project settings>GitHub connections に移動します。
リポジトリを追加または削除するには、接続の [その他のオプション] 省略記号を選択し、メニューから [リポジトリの追加] または [リポジトリの削除] を選択します。
すべてのリポジトリと接続を削除するには、 [接続の削除] オプションを選びます。 次に、 [削除] を選んで確定します。
より正確な翻訳は以下の通りです: GitHub接続の削除確認がスクリーンショットに表示されています。
リポジトリへのアクセスを変更する
GitHub Web ポータルで、プロファイル メニューから Settings を開きます。
[IntegrationsApplications] を選択します。 [Installed GitHub Apps で、Configure を選択します。
Azure Boards構成ページが開きます。
[リポジトリ アクセス] セクションまで下にスクロールします。
必要なオプション ([すべてのリポジトリ] または [選択したリポジトリのみ]) を選択します。
[リポジトリの選択のみ]を選択した場合は、Azure Boardsとの統合に参加するリポジトリを選択します。
[リポジトリ] アクセスを示すスクリーンショット。選択したリポジトリを選択できます。
[保存] を選択します。
Azure Boards 統合を一時停止またはアンインストールする
前の手順のステップ 2 から、 [危険なゾーン] セクションまで下にスクロールします。
[危険ゾーン] セクションを示すスクリーンショット。中断とアンインストールのオプションが表示されています。
統合を中断するには、 [中断]を選択します。 確認ウィンドウで、[ OK] を 選択して中断を確認します。
中断の確認ダイアログを示すスクリーンショット。
統合の中断を解除するには、 [中断の解除]を選択します。
Azure Boards アプリをアンインストールするには、Uninstall を選択し、ポップアップ確認ウィンドウから OK を選択します。
スクリーンショットは、アンインストールの確認ダイアログを示しています。
Azure Boards-GitHub接続を更新する
GitHub用のAzure Boards アプリでサポートされているリポジトリを変更すると、Azure Boards GitHub接続にリダイレクトされることがあります。 GitHubに接続できなくなったAzure Boards内のリポジトリを削除することをお勧めします。 詳細については、「リポジトリ GitHubの追加または削除を参照してください。
GitHubのAzure Boards アプリをアンインストールすると、次のメッセージが Azure Boards、Project settings>GitHub 接続に表示されます。 接続の削除を選択して、以前に作成したすべてのGitHub接続を削除します。 詳細については、「リポジトリ GitHubの追加または削除を参照してください。