Azure Pipelines と Microsoft Teams の統合

Azure DevOps Services

この記事では、Azure Pipelines アプリを使用してMicrosoft Teamsを使用してパイプライン イベントを監視する方法について説明します。 パイプラインのビルド、リリース、承認に関する通知を Teams チャネルで設定して取得できます。 承認者は、Teams チャネル内からリリースを承認することもできます。

前提条件

• アプリを追加できるMicrosoft Teamsのチームへのアクセス。
• Azure DevOps プロジェクトのプロジェクト管理者またはビルド管理者 アクセス権 。 詳細については、「プロジェクトの作成Pipeline セキュリティ リソースを参照してください。
• [OAuth を使用したサードパーティ アプリケーションのアクセス] が Azure DevOps 組織設定で有効になっている。

Azure Pipelines アプリを設定する

1. Microsoft Teamsで Apps を選択し、 Azure Pipelines を検索して、 Azure Pipelines を選択します。

   

2. [追加] の横にあるドロップダウン矢印を選択し、[チームに追加] を選択。

   

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

   

Azure Pipelines アプリ コマンドを使用する

Azure Pipelines Teams アプリでは、次のコマンドがサポートされています。

Azure Pipelines にサインインする

1. Teams の会話ウィンドウで、「@azurePipelines signin」と入力します。
2. [サインイン] を選択し、Azure Pipelines への認証を完了します。

パイプラインをサブスクライブする

プロジェクト内のすべてのパイプラインまたは特定のパイプラインのみをサブスクライブして監視するには、次のコマンドを使用します。

• プロジェクト内のすべてのパイプライン: URL は、プロジェクトまたはプロジェクト内の任意のページ (パイプラインを除く) に設定できます。 次に例を示します。

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/
  

• 特定のパイプライン: パイプラインの URL は、URL に definitionId または buildId/releaseId があるパイプライン内の任意のページに設定できます。 次に例を示します。

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  

リンクされた通知を展開する

特定の投稿のすべての返信がリンクされます。

スレッドを展開するには、圧縮されたスレッド リンクを選択します。

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

パイプラインをサブスクライブすると、フィルターが適用されずに、いくつかのサブスクリプションが既定で作成されます。 これらのサブスクリプションには、Run 状態の変更 YAML パイプラインの承認を待機している Run ステージ、クラシック リリースのリリースの承認待ちが含まれます。 これらのサブスクリプションを削除したり、サブスクリプションを追加したりできます。

Azure Pipelines アプリでは、チャネルに表示される内容をカスタマイズするためのフィルターもサポートされています。 たとえば、ビルドが失敗した場合のみ、またはデプロイが運用環境にプッシュされる場合にのみ通知を希望する可能性があります。

サブスクリプションを管理するには、以下の手順を実行します。

1. すべてのパイプライン サブスクリプションを一覧表示するには、 @azure pipelines subscriptions コマンドを実行します。

   

2. サブスクリプションを削除するには、 [すべてのサブスクリプションの表示] を選択します。 不要なサブスクリプションで Remove を選択し、 OK を選択します。

3. サブスクリプションを追加するには、 [サブスクリプションの追加] を選択します。

4. サブスクライブするイベントとパイプラインを選択し、 Next を選択します。

5. 必要な Stage と Environment フィルターを選択し、 Submit を選択してから、 OK を選択します。

   たとえば、次のサブスクリプションは、Completed状態がfailed場合にのみ、_default ステージの通知を提供します。

   

承認通知を表示する

承認通知を表示するには、承認を待機している Run ステージ YAML パイプラインの通知、またはクラシック リリースの リリース承認保留中 通知をサブスクライブしていることを確認します。 これらのサブスクリプションは、パイプラインをサブスクライブするときに既定で作成されます。

実行ステージの承認が完了通知をサブスクライブすると、ステージが承認されたタイミングも確認できます。

チャネルから承認する

承認者の場合は、Teams チャネル内から展開を承認できます。 Azure Pipelines アプリでは、すべての Azure Pipelines のチェックと承認のシナリオがサポートされています。 要求は、個人またはチームとして承認できます。

ステージの実行が承認を待つたびに、アプリは通知カードに通知カードを投稿し、チャネルで要求を approve または Reject します。 通知で要求の詳細を確認し、適切なアクションを実行できます。

応答がアプリに送信されます。

実行ステージの承認が完了通知にサブスクライブしている場合は、ステージが承認されたタイミングも確認できます。

チャネルの登録を解除する

unsubscribe コマンドを実行して、プロジェクト内のパイプラインに関連するすべてのサブスクリプションを削除し、チャネルからパイプラインを削除します。 次に例を示します。

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

プロジェクトとすべてのサブスクリプションをチャネルから削除するには、 Proceed を選択します。

作成拡張機能を使用する

パイプラインに関する情報を検索して共有するために、Teams 用 Azure Pipelines アプリではメッセージ内の作成拡張機能がサポートされています。 この拡張機能を使用して、パイプライン ID またはパイプライン名でプロジェクト内のパイプラインを検索できます。

拡張機能を使用するには、Teams チャネルで Azure Pipelines プロジェクトにサインインする必要があります。 メッセージ フィールドで + 記号を選択し、 Azure Pipelines を選択して、パイプラインまたはリリースを検索します。

パイプライン URL のプレビュー

作成拡張機能を使用して Teams メッセージにパイプライン URL を追加すると、次の画像のようなプレビューが表示されます。 プレビューは、パイプライン関連の会話を関連性のある最新の状態に保つのに役立ちます。

次の例は、リリース URL プレビューを示しています。

複数のテナントを接続する

Microsoft Teams と Azure DevOps に異なるメールまたはテナントを使用している場合は、次の手順を実行し、設定に基づいてサインインして接続します。

認証の問題のトラブルシューティング

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

[サインイン] ボタンを選択し、サインイン プロセスを完了します。 表示されるディレクトリが、前の手順で選択したディレクトリと同じであることを確認します。

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

関連記事

• Microsoft Teams と共に Azure Boards を使用する
• Microsoft Teams と共に Azure Repos を使用する