Azure DevOps Server を GitHub に接続する (オンプレミス)

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

前提条件

• GitHub との統合:
  • GitHub.com のリポジトリに接続するには、Azure DevOps Server 2020.1.1 Patch 2 をインストールする必要があります。 このパッチを適用しない場合は、GitHub Enterprise Server のリポジトリにのみ接続できます。
  • GitHub の組織またはアカウントに GitHub 用の Azure Boards アプリをインストールします。
• プロジェクト接続: Azure Boards または Azure DevOps プロジェクトに接続します。 プロジェクトがまだない場合は、作成します。
• アクセス許可:
  • Project コレクション管理者グループプロジェクトの Contributors グループのメンバーになります。 自分でプロジェクトを作成した場合は、アクセス許可を持っています。
  • 接続先の GitHub Enterprise Server の管理者である。

認証オプション

次の認証オプションがサポートされています。

Azure DevOps Server を GitHub Enterprise Server に接続する

1. Azure DevOps Server の Web ポータルを開きます。

2. Azure DevOps のロゴを選択して [プロジェクト] を開き、GitHub Enterprise リポジトリに接続するように構成する Azure Boards プロジェクトを選択します。

個人用アクセス トークンを使用して接続する

1. PAT を作成するには、個人用アクセス トークンの作成に関するページを参照してください。

   ヒント

   GitHub PAT を作成するときは、repo, admin:repo_hook, read:user, user:email のスコープが含まれていることを確認してください。

2. GitHub Enterprise サーバーの URL と、そのサーバーによって認識される個人用アクセス トークン資格情報を入力します。 次に、 [接続] を選択します。

ユーザー名とパスワードで接続

1. GitHub Enterprise サーバーの URL と、そのサーバーによって認識される管理者アカウントの資格情報を入力します。 次に、[接続] を選択します。

2. ダイアログには、GitHub 管理権限を持つすべてのリポジトリが一覧表示されます。 [自分のもの] と [すべて] を切り替えると、その他を表示するかどうかを決定できます。その後、追加したいものをチェックします。 終わったら [保存] を選択します。

   

3. 初めて Azure Boards から GitHub アカウントまたは組織に接続する場合は、GitHub 用の Azure Boards アプリもインストールします。 「接続を確認する」に記載されている手順に従って、統合を完了します。

接続に関する問題の解決

Azure Boards と GitHub の統合では、接続をサポートするためにさまざまな認証プロトコルに依存しています。 ユーザーのアクセス許可のスコープまたは認証の資格情報を変更すると、Azure Boards に接続されている GitHub リポジトリが失効する可能性があります。

GitHub 用の Azure Boards アプリがサポートする統合の概要については、Azure Boards と GitHub の統合に関する記事をご覧ください。

サポートされている認証オプション

接続先の GitHub プラットフォームに基づいて、次の認証オプションがサポートされています。

プラットフォーム

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• GitHub.com ユーザー アカウント
• 個人用アクセス トークン (PAT)

• OAuth
• PAT
• ユーザー名とパスワード

Azure DevOps Server 2020

適用なし

• PAT
• ユーザー名とパスワード

Azure DevOps Server 2019

適用なし

• OAuth
• PAT
• ユーザー名とパスワード

Note

GitHub 用の Azure Boards アプリを使用することで、Azure Boards と Azure DevOps Services が GitHub.com および GitHub Enterprise Server リポジトリと統合されます。 Azure DevOps Server 2019 以降のバージョンは、GitHub Enterprise Server リポジトリとの統合のみをサポートしています。 他の Git リポジトリとの統合はサポートされていません。

アクセスの問題を解決する

GitHub への Azure Boards の接続にアクセスできなくなると、ユーザー インターフェイスに赤色の X でアラート状態が示されます。 アラートをポイントすると、資格情報が無効になっていることが示されます。 この問題を解決するには、接続を削除して、新しい接続を作成し直します。

次の解決策を検討してください。

• 接続で OAuth を使っている場合:

  • Azure Boards アプリケーションで、いずれかのリポジトリに対するアクセスが拒否されました。

  • GitHub が利用できないか、到達できない可能性があります。 このように利用できなくなるのは、サービスの停止またはオンプレミスのインフラストラクチャやネットワークの問題が原因である可能性があります。 サービスの状態は、次のリンクからチェックできます。

    • GitHub
    • Azure DevOps

    GitHub リポジトリへの接続を削除して作成し直します。 接続を作成し直すと、GitHub で Azure Boards の再認証を求めるメッセージが表示されます。

• 接続で PAT を使っている場合:

  • PAT が取り消されたか、必要なアクセス許可範囲が変更されたりして、不十分である可能性があります。

  • ユーザーが GitHub リポジトリの管理アクセス許可を失った可能性があります。

    PAT を作成し直し、トークンのスコープに必要なアクセス許可 (repo, read:user, user:email, admin:repo_hook) が含まれていることを確認します。

選択した作業項目の種類の XML 定義を更新する

組織で Hosted XML またはオンプレミスの XML プロセス モデルを使用して作業追跡をカスタマイズし、GitHub リンク型を作業項目フォームの開発セクションに統合する場合は、対応する作業項目の種類の XML 定義を更新する必要があります。

たとえば、作業項目フォームの Development セクション内でユーザー ストーリーやバグを GitHub コミットと pull request にリンクするには、これらの作業項目の種類の XML 定義を更新する必要があります。

XML 定義を変更するには、「 Hosted XML プロセス モデルで説明されている手順を実行します。 作業項目の種類ごとに、次の操作を行います。

1. Group Label="Development" セクションを見つけます。
2. 外部リンクの種類 GitHub Commit および GitHub Pull Request をサポートするには次のコード行を追加します。

この統合により、Azure Boards の作業項目から直接 GitHub アクティビティをシームレスに追跡できます。

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

更新すると、セクションは次のように表示されるはずです。

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

次のステップ

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

関連記事

• Azure Boards について学習する
• GitHub と Azure Boards の統合に関するトラブルシューティング
• GitHub Enterprise Server リポジトリを作成する