Teams での GitHub の通知のカスタマイズ

通知をカスタマイズするには、Microsoft Teams チャネルに関連するアクティビティをサブスクライブし、プロジェクトにあまり役に立たないアクティビティからサブスクライブを解除します。

既定で有効になっている通知

次の通知は既定で有効になっていますが、@GitHub Notifications unsubscribe owner/repo [feature] コマンドを使用して無効にできます。

既定で無効になっている通知

次の通知は既定で無効になっていますが、@GitHub Notifications subscribe owner/repo [feature] コマンドを使用して有効にできます。

一度に複数の設定を登録または解除できます。 例えば次が挙げられます。

• pull request レビューとコメントのアクティビティを有効にするには、@GitHub Notifications subscribe owner/repo reviews comments を使用します。
• 問題と pull request のアクティビティをオフにするには、@GitHub Notifications unsubscribe owner/repo issues pulls を使用します。

通知のフィルター処理

分岐フィルターとラベル フィルターを使用して、通知をさらにカスタマイズできます。 ブランチ フィルターを使用すると、ブランチ名に基づいてコミット通知をフィルター処理できますが、ラベル フィルターを使用すると、問題をフィルター処理したり、それらに適用されたラベルに基づいて要求通知をプルしたりできます。

コミット通知の分岐フィルター

ブランチ フィルターを使用すると、ブランチ名に基づいてコミット通知をフィルター処理できます。 既定では、 commits イベントをサブスクライブすると、既定のブランチの通知が表示されます。 ただし、特定のブランチ、ブランチのパターン、またはすべてのブランチを基準としてフィルター処理を選択できます。

          `main` ブランチのコミット通知のみを受信します。|

|@GitHub Notifications subscribe owner/repo commits:feature/*| feature/で始まるすべてのブランチのコミット通知を受け取ります。| |@GitHub Notifications subscribe owner/repo commits:*|すべてのブランチのコミット通知を受信します。|

コミット機能の登録を解除するには、@GitHub Notifications unsubscribe owner/repo commitsを使用します。

問題とプルリクエストの通知に対するラベルフィルター

ラベル フィルターを使用すると、問題やプル要求に適用されたラベルに基づいて通知をフィルター処理できます。 ラベル フィルターを設定すると、指定したラベルを含むイベントの通知のみが送信されます。 ラベルの詳細については、「 ラベルを管理する 」と 「AUTOTITLE」を参照してください。

現時点では、リポジトリごとに必要なラベル フィルターを 1 つだけ持つことができます。 次の表は、ラベル フィルターの影響を受けるイベントの種類を示しています。

ラベル フィルターの作成

ラベル フィルターを作成するには、次のコマンド形式を使用します。

@GitHub Notifications subscribe [owner/repo] +label:"your label"

@GitHub Notifications subscribe [owner/repo] +label:"your label"

これにより、 your label値を持つ必須ラベル フィルターが作成されます。 フィルターをサポートする受信イベントは、そのラベルがない限り破棄されます。

ラベル フィルターの更新

新しいラベル値を指定することで、既存のラベル フィルターを更新できます。

@GitHub Notifications subscribe [owner/repo] +label:"new label"

@GitHub Notifications subscribe [owner/repo] +label:"new label"

これにより、「あなたのラベル」フィルターが「新しいラベル」フィルターに置き換わります。

ラベル フィルターの削除

          `+label` オプションを指定して unsubscribe コマンドを使用して、既存のラベル フィルターを削除できます。

@GitHub Notifications unsubscribe [owner/repo] +label:"new label"

@GitHub Notifications unsubscribe [owner/repo] +label:"new label"

これにより、"新しいラベル" フィルターが削除され、チャネルは、ラベルのフィルター処理なしでサブスクライブされたイベントのすべての通知を受け取ります。

アクティブなラベル フィルターの表示

チャネルの現在アクティブなラベル フィルターを表示するには、次のコマンドを使用します。

@GitHub Notifications subscribe list features

@GitHub Notifications subscribe list features

有効なフィルター

Teams の GitHub アプリは、Teams と GitHub が標準として提供するすべての絵文字を含む、ラベル フィルターの最も一般的な特殊文字をサポートしています。 サポートされていない特殊文字を含むラベルが表示されることはほとんどありません。 たとえば、 :foo:としてエンコードされていないマルチバイト文字や、 , 文字を使用するラベルが期待どおりに機能しない場合があります。

GitHub Actions ワークフロー通知

GitHub Actions ワークフロー実行通知は、"ワークフロー" 機能を使用してチャネルまたは個人用アプリからサブスクライブできます。形式は @GitHub Notifications subscribe owner/repo workflows です。

"ワークフロー" をサブスクライブしている場合は、次の機能を使用できます。

• 新しいワークフロー実行がトリガーされると、通知が表示されます。
• スレッドで承認通知を返信として追跡し、チャネルまたは個人用アプリから直接通知を承認できます。
• ワークフローが完了すると、ワークフロー実行の完全なコンテキストと履歴を表示できるように、スレッドで更新が応答として取得されます。
• 何かが失敗した場合は、ワークフローを再実行することを選択できます。また、必要に応じてデバッグ ログを有効にすることもできます。

ワークフロー通知フィルター

ワークフロー通知をフィルター処理するには、次のオプションを使用します。

          `pull_request` イベントが含まれている場合、ブランチはプル要求が作成されるターゲット ブランチになります。|

|event|ワークフローをトリガーしたイベント (プッシュ、pull_requestなど) でフィルター処理します。|

ワークフロー通知フィルターは、次の形式で構成できます。

@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}

@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}

コンマで区切って、フィルターごとに複数の値を渡すこともできます。 例えば次が挙げられます。

@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name","another workflow name" event:"workflow event","another workflow event" branch:"branch name","another branch name" actor:"username","another-username"}

@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name","another workflow name" event:"workflow event","another workflow event" branch:"branch name","another branch name" actor:"username","another-username"}

既定では、フィルターを渡さずにワークフロー通知を構成すると、既定のブランチを対象とするプル要求によってトリガーされるワークフロー用に構成されます。 1 つまたは複数のエントリを渡すことができます。

ワークフロー通知の登録を解除するには、@GitHub Notifications unsubscribe owner/repo workflows コマンドを使用します。

デプロイ通知

個別のデプロイ通知を構成することもできます。 これらのデプロイは、GitHub Actions から、またはデプロイ API を使用して外部ソースから行うことができます。 「デプロイ用の REST API エンドポイント」を参照してください。

次のコマンドを使用して、デプロイ通知をサブスクライブまたはサブスクライブ解除できます。

@GitHub Notifications subscribe owner/repo deployments
@GitHub Notifications unsubscribe owner/repo deployments

@GitHub Notifications subscribe owner/repo deployments
@GitHub Notifications unsubscribe owner/repo deployments