GitHub と Slack を連携させる

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


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

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


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

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 (ステータス)
  • コミット
  • deployments (デプロイメント)
  • public (パブリック)

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

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

 

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

  • /github subscribe owner/repo [機能]
  • /github unsubscribe owner/repo [機能]


GitHub アプリについての注意事項

Slack の他のアプリを使っているユーザーの方は、GitHub のインストール方法が少し違うことに気づかれたかもしれません。このアプリは、メンバーレベルではなく、ワークスペースレベルで動作するものです。それには以下のようなしかるべき理由があります!

  • アプリをインストールしたメンバーがワークスペースから退出しても、アプリの連携が解除されることはありません。
  • GitHub アプリは特定のチャンネルに追加することができます。インストール時にチャンネルを選択するか、「/invite @github」を使って後からアプリをチャンネルに追加することもできます 

💡 Slack のプラットフォームブログで今後の Slack アプリの展開についてチェックしてみましょう。

 

GitHub のオンプレミスオプション、GitHub Enterprise を利用している場合には、GitHub Notifications (レガシー) アプリのインストールが必要となります。


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

  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 (SSL 認証) が ON になっていることを確認します。
  11. 「Add webhook」 をクリックします
  12. Slack の設定ページに戻り、Save Integration  をクリックします。

質問がある?—いつでもお気軽にお問い合わせください!