GitHub と Slack を連携させる

GitHub は、ソフトウェア開発者のチームが共同でコードを記述し、プロジェクトを管理するためのツールです。GitHub を Slack に連携させれば、選択した Slack チャンネルであらゆるイベントの通知を受信できるようになります。一番よく使う重要度の高い 2 つのツールを連携させて、業務の状況を Slack 内から完全に把握できるようにしましょう。🛠


用途に合わせてアプリを選択

  • Slack 用 GitHub アプリ : GitHub の Developer、Team または Business プランを利用していますか?そんな方にはこのアプリがおすすめです!
  • GitHub Notifications(レガシー): このアプリは GitHub Enterprise と互換性があります。

注意 :GitHub による Slack 用 GitHub アプリの新バージョンリリースに伴い、2020 年 7 月に現バージョンのサポートを終了します


アプリをインストールする

Slack 用 GitHub アプリ 

GitHub Notifications(レガシー)

GitHub アプリを使えば、パブリックリポジトリのリンクのプレビューを Slack で受信し、スラッシュコマンドで通知を設定し、プロジェクトのアクティビティを簡単に把握することができます。


アプリをインストールする

  1. slack.github.com にアクセスし、「Add to Slack」をクリックします。
  2. アプリが必要とするアクセス権限を確認し、「Continue」をクリックして許可します。
  3. アプリがアクセスできるチャンネルを選択します(すべてのパブリックチャンネル、特定のチャンネル、なし、など)。

アプリのインストールが完了すると、GitHub アプリから設定方法と「/github」のスラッシュコマンドの使い方に関するダイレクトメッセージが送信されます。

Tip :以前の設定を購読するためには、スラッシュコマンド「/github subscribe owner/repo」を使いましょう。



通知をカスタマイズする

GitHub アプリを使えば、Slack に投稿する内容のカスタマイズがしやすくなります。チャンネル全体で見てほしい関連のあるアクティビティの情報については購読し、その必要がなくあまり役立たないものについては購読を解除することができます。アクティビティの中には、デフォルトで Slack での通知を行うものと、そうでないものがあります。

デフォルトで通知を行う機能

  • issues(イシュー)
  • pulls(プル)
  • statuses(ステータス)
  • commits(コミット)
  • デプロイ数
  • パブリック

デフォルトで通知されない機能

  • reviews(レビュー)
  • comments(コメント)
  • branches(ブランチ)
  • すべてコミット 

 

以下のスラッシュコマンドも通知のカスタマイズに便利です。

  • /github subscribe owner/repo [feature]
  • /github unsubscribe owner/repo [feature]


アプリをインストールする

  1. Slack の App ディレクトリで GitHub アプリを見つけます。
  2. 「インストール」または、すでにアプリをインストールしている場合は「設定を追加する」をクリックします。
  3. GitHub イベントの投稿先チャンネルを選択するか、「新しいチャンネルを作成する」をクリックしてまったく新しいチャンネルを作成します。
  4. 「GitHub インテグレーションを追加する」をクリックします。
  5. GitHub のアカウントページから、自分がモニターしたいリポジトリに移動します。上部のナビゲーションメニューから、「Settings」をクリックします。
  6. 左ナビゲーションメニューの「Webhooks」をクリックして、「Add webhook」ボタンを押します。
  7. Slack の App ディレクトリウィンドウから、「URL をコピーする」をクリックします。
  8. GitHub アカウントに戻り、「Payload URL」の下に URL をペーストします。
  9. 「Content type」の項目で、必ず「application/json」が選択されていることを確認してください。
  10. 「SSL verification」が ON になっていることを確認します。
  11. 「Add webhook」をクリックします
  12. Slack の設定ページに戻り、「インテグレーションを保存する」をクリックします。