次の方法で共有

Microsoft Teamsで Azure Repos を使用する

  • [アーティクル]

Azure DevOps Services

Microsoft Teams と Azure Repos を使用する場合は、Teams 用の Azure Repos アプリを使用してリポジトリを監視できます。 このアプリでは、Git リポジトリと Team Foundation Version Control (TFVC) リポジトリの両方の監視がサポートされていますが、GitHub リポジトリとの統合はサポートされていません。

この記事では、次のタスクを実行する方法について説明します。

  • Microsoft Teamsでチームに Azure Repos アプリを追加する
  • Azure Repos アプリをリポジトリに接続する
  • チャネル内のリポジトリ関連イベントへのサブスクリプションを管理する
  • 作成拡張機能を利用して PR 情報を検索して共有する
  • PR URL をプレビューする
  • チャネルからサブスクリプションとリポジトリを削除する

前提 条件

  • サブスクリプションを管理して、コードがプッシュまたはチェックインされるたびに、またはプル要求 (PR) が作成、更新、またはマージされるたびに、チャネルで通知を受け取るようにします。 リポジトリ関連のイベントのサブスクリプションを作成するには、プロジェクト管理者 グループのメンバーまたはチーム管理者になります。 追加するには、「プロジェクト レベルのアクセス許可 を変更する」または「チーム管理者を追加する」を参照してください。
  • 通知を受信するには、Azure DevOps 組織の OAuth 設定を使用して、サード パーティ製アプリケーションへのアクセスを有効にします。 「組織のアプリケーション アクセス ポリシーを変更する」を参照してください。

手記

  • 現在、ダイレクト メッセージ内では通知はサポートされていません。
  • Microsoft Teams用の Azure Repos アプリは、Azure DevOps Services でホストされているプロジェクトにのみリンクできます。

Microsoft Teamsのチームに Azure Repos アプリを追加する

  1. Microsoft Teams の Azure Repos アプリ (Microsoft Teams > Azure Repos) に移動します。

  2. [追加] を選択するか、既にアプリをダウンロードしている場合は、[開く] の横にあるドロップダウン メニューを選択し、[チームに追加] を選択します。

  3. チーム名またはチャネル名を入力し、[ボットの設定] を選択します。

    Teams の Azure Repos からのウェルカム メッセージのスクリーンショット。

Azure Repos アプリをリポジトリに接続する

  1. チームにアプリがインストールされたら、応答フィールドに次のテキストを入力します:@azure repos signin

    Microsoft Teamsと Azure Boards が異なるテナントにある場合は、[別のメールアドレスでサインイン ] を選択します。

    Azure Repos の Teams サインイン エントリを示すスクリーンショット。

    サインイン完了応答を示すスクリーンショット。

  2. プロジェクト内のすべての Git リポジトリを監視するには、チャネルに「@azure repos subscribe [project url]」と入力します。 必ずプロジェクトの URL を追加してください。 プロジェクト URL は、プロジェクト内の任意のページに設定できます (リポジトリへの URL を除く)。

    @azure repos subscribe [repo url]を使用して、特定のリポジトリを監視することもできます。

    リポジトリの URL は、リポジトリ名を持つリポジトリ内の任意のページ (たとえば、@azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo)、TFVC リポジトリの場合は [@azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl] にすることができます。

  3. subscribe コマンドを使用すると、既定のサブスクリプションの使用を開始できます。 Git リポジトリの場合、チャネルは(ターゲット ブランチ = メインの) イベント 作成された Pull request にサブスクライブされます。 TFVC リポジトリでは、チャネルがコードのチェックイン イベントにサブスクライブされます。

    既定のサブスクリプション作成メッセージを示すスクリーンショット。

サブスクリプションの管理

チャネルのサブスクリプションを表示、追加、削除するには、次のテキストを入力します:@azure repos subscriptions。

チャネルの現在のすべてのサブスクリプションの一覧が表示され、新しいサブスクリプションを追加したり、既存のサブスクリプションを削除したりできます。 次のセクションで説明するように、さまざまなフィルターを使用して通知をカスタマイズします。

手記

チーム管理者は、プロジェクト管理者によって作成されたサブスクリプションを削除または変更することはできません。

サブスクリプション を表示する

フィルターを使用して必要な通知のみを取得する

@azure repos subscribeを使用してリポジトリをサブスクライブすると、フィルターが適用されていない既定のサブスクリプションが作成されます。 多くの場合、ユーザーは、特定の条件が満たされたときにのみ通知されるように、これらのサブスクリプションをカスタマイズする必要があります。 次のスクリーンショットは、チームが PR のレビュー担当者リストに含まれている場合にのみ通知を設定する例を示しています。

  1. チャネルに次のテキストを入力します:@azure repos subscriptions。

  2. サブスクリプションの一覧で、不要なサブスクリプションまたは変更する必要があるサブスクリプションがある場合は、[削除] を選択して削除します。

  3. [サブスクリプション の追加] ボタンを選択します。

  4. イベントの種類を選択し、[次へ]選択します。

    イベントの種類の選択を示すスクリーンショット。

  5. リポジトリを選択し、[次へ]選択します。

    リポジトリの選択を示すスクリーンショット。

  6. 適切なフィルターを選択してサブスクリプションをカスタマイズし、[送信] を選択します。

    選択したフィルターを示すスクリーンショット。

手記

  • 通常、すべてのフィルターはドロップダウンです。 ただし、ドロップダウンに 100 を超える項目がある場合は、値を手動で入力する必要があります。
  • TFVC [コードのチェックイン] イベントの場合、[次のパスの下] フィルターの形式は $/myproject/path である必要があります。

Compose 拡張機能を使用して pull request 情報を検索および共有する

ユーザーが pull request に関する情報を検索して共有できるように、Microsoft Teams用の Azure Repos アプリでは作成拡張機能がサポートされています。 プル要求は、ID または名前で検索できます。 拡張機能を機能させるには、@azure repos signin 入力するか、新規作成拡張機能に直接サインインして、Azure Repos プロジェクトにサインインします。

作成拡張機能を示すスクリーンショット。

プル要求 URL のプレビュー

PR の URL を貼り付けると、次の図のようなプレビューが表示されます。これは、PR 関連の会話をコンテキストに応じて正確に保つために役立ちます。 サインインすると、チーム内のすべてのチャネルで URL の PR をプレビューできます。

URL の展開を示すスクリーンショット。

チャネルからサブスクリプションとリポジトリを削除する

プロジェクト内のリポジトリに関連するすべてのサブスクリプションを削除し、チャネルからリポジトリを削除するには、Teams に次のテキストを入力します:@azure repos unsubscribe all [project url]。 必ずプロジェクトの URL を入力してください。 このタスクを実行できるのは、プロジェクト管理者だけです。

スレッド通知

関連する一連の通知をリンクし、チャネル内の通知によって占有される領域を減らすために、通知はスレッド化されます。 特定のプル要求にリンクされているすべての通知が一緒にリンクされます。

スレッド通知のコンパクト ビュースレッド通知のコンパクト ビューを示すスクリーンショット。

スレッド通知の展開ビュースレッド通知の展開ビューを示すスクリーンショット。

コマンド リファレンス

次の表に、Teams チャネルで使用できるすべての azure repos コマンドを示します。

コマンド 機能
@azure repos subscribe [repo url/ project url] リポジトリまたはプロジェクト内のすべてのリポジトリをサブスクライブして通知を受信する
@azure repos subscriptions このチャネルのサブスクリプションを追加または削除する
@azure repos signin Azure Repos 組織にサインインする
@azure repos signout Azure Repos 組織からサインアウトする
@azure repos feedback 問題を報告する、または機能を提案する
@azure repos unsubscribe all [project url] すべてのリポジトリ (プロジェクトに属) とそれに関連付けられているサブスクリプションをチャネルから削除する

マルチテナントのサポート

Microsoft Teamsと Azure DevOps に別の電子メールまたはテナントを使用している場合は、ユース ケースに基づいて次の手順に従ってサインインします。

使用事例 メール ID + Microsoft Teams テナント メール ID + Azure DevOps テナント ステップス
1 email1@abc.com (テナント 1) email1@abc.com (テナント 1) [サインイン] をクリックします。
2 email1@abc.com (テナント 1) email1@abc.com (テナント 2) Azure DevOps にサインインします。 同じブラウザーで、新しいタブを開始し、https://teams.microsoft.com/に移動します。 signin コマンドを実行し、サインインを選択します。
3 email1@abc.com (テナント 1) email2@pqr.com (テナント 2) [別のメール アドレスでサインイン] を選択し、電子メール ID ピッカーで email2 を使用して Azure DevOps にサインインします。
4 email1@abc.com (テナント 1) email2@pqr.com (既定以外のテナント 3) このシナリオはサポートされていません。

トラブルシューティング

Azure Repos アプリの使用時に次のエラーが発生する場合は、このセクションの手順に従います。

申し訳ございません。問題が発生しました。 もう一度お試しください。

Azure Repos アプリは OAuth 認証プロトコルを使用しており、組織に対するサードパーティのアプリケーションアクセスをOAuth経由で許可するためには、組織の OAuth 経由のサードパーティ アプリケーション アクセス を有効にする必要があります。 この設定を有効にするには、[組織の設定] [セキュリティポリシー]に移動し、組織 の OAuth を使用した サード パーティアプリケーションのアクセスを [時に ] に設定します。

組織の設定に対して OAuth を使用してサード パーティのアプリケーション アクセスを有効にする

構成に失敗しました。 組織 '{organization name}' が存在し、十分なアクセス許可があることを確認してください。

ブラウザーを使用して https://aka.ms/VsSignout に移動して、Azure DevOps からサインアウトします。

プライベートまたはシークレットのブラウザー ウィンドウを開き、https://aex.dev.azure.com/me に移動してサインインします。 左側のプロファイル アイコンの下のドロップダウンで、サブスクライブするリポジトリを含む組織を含むディレクトリを選択します。

プロジェクト を含む組織を含むディレクトリを選択します。

同じブラウザーで、新しいタブを開始し、にサインインします。 @Azure Repos signout コマンドを実行し、Microsoft Teams用 Azure Repos アプリがインストールされているチャネルで @Azure Repos signin コマンドを実行します。

[Sign in] ボタンを選択すると、次の例のような同意ページにリダイレクトされます。 メールの横に表示されるディレクトリが、前の手順で選択したディレクトリと同じであることを確認します。 サインイン プロセスを受け入れて完了します。

要求されたアプリのアクセス許可への同意

これらの手順で認証の問題が解決しない場合は、Developer Communityまでお問い合わせください。