Slack で GitHub を使う

GitHub はオンライン Git リポジトリサービスです (複数の人が一度に同じコードの扱うことを可能にするシステム)。GitHub により、Git プロジェクトの保存、チームメートとの共同作業、問題の追跡、作業の整理が容易になります。

Slack の GitHub アプリを使えば、以下のイベントに関する通知を Slack で受け取ることができます :

  • Commit (コミット)
  • Pull requests (プルリクエスト)
  • Issue (イシュー)
  • プルリクエストのレビューイベント
  • Deployment statuses (デプロイメント・ステータス)

 

GitHub を Slack に連携させる

Tip :  始める前に、必ず GitHub アカウントの作成を完了してください。アカウントを作成するには、 github.com  のページへアクセスしてください。

準備ができたら、以下の手順で GitHub を Slack に連携させます :

  1. Slack の App Directory (App ディレクトリ) で  GitHub  アプリを見つけます。 
  2.  Install  をクリックします。
  3. GitHub イベントの投稿先チャンネルを選択するか、「新しいチャンネルを作成する」をクリックしてまったく新しいチャンネルを作成します。
  4.  Add GitHub Integration をクリックします。 
  5.  Authenticate your GitHub account  (GitHub のアカウントを認証する) をクリックします。
  6. Slack で通知を受け取りたいリポジトリを選択します。 
  7. Slack に投稿する GitHub イベントを選択します。
  8. 必要に応じてカスタム表示名とアイコンを選択し、GitHub イベントの表示方法をカスタマイズできます。
  9. 以上全て終了したら  Save Integration   をクリックします。

 

許可に関する注意

GitHub アプリを Slack に初めて連携させた時に、Slack から GitHub リポジトリへのアクセス許可を求められることがあります。すべてのパブリックおよびプライベートリポジトリデータ (コード、問題、プルリクエスト、wikis、設定、デプロイキー、Web フックとサービス) への読み取り権限と書き込み権限が必要です。

難しいことをお願いしているのは十分承知しています!ですが、Slack が公開/非公開リポジトリの全項目にアクセスするには、上記に挙げた全ての許可を与える GitHub の repo scope を使うことが必要なため、どうかご理解ください。

Slack が使用する許可は、リポジトリデータを読むのに必要な許可 (公開・非公開リポジトリのリストを取得するため) と、GitHub に webhooks を設定するための書き込み許可だけになります。


非認証モードに切り替える

GitHub アプリを非認証モードで設定することもできます。この設定が役立つのは、次の 2 つ理由がある場合、つまり、チームで GitHub Enterprise を使用している場合、または Slack に完全な読み取り権限と書き込み権限を許可したくない場合です。

GitHub アプリを非認証モードで設定するには、上記の手順1〜4を実行し、それから以下の手順に従います。

  1. Slack の設定ページで、 switch to unauthed mode  (非認証モードに切り替える) をクリックします。
  2. GitHub のアカウントページから、自分がモニターしたいレポジトリに移動します。右ナビゲーションメニューから、 Settings  をクリックします。
  3. 左ナビゲーションメニューから  Webhooks & Services  をクリックして、 Add webhook  を選択します。
  4. Slack の App Directory (App ディレクトリ) ウィンドウから、copy URL  をクリックします。
  5. GitHub アカウントに戻り、Payload URL  の下に URL をペーストします。
  6.  Content type  の項目で、必ず  application/json  が選択されていることを確認してください。
  7.  SSL verification (SSL 認証) が ON になっていることを確認します。
  8.  Add webhook をクリックします。
  9. Slack の設定ページに戻り、Save Integration  をクリックします。

 

Slack に新しい GitHub オーガナイゼーションを追加する

新しい GitHub オーガナイゼーションに参加した場合は、Slack がそれにアクセスできるように許可する必要があります。この設定が済むと、その新しいオーガナイゼーションが既存のアプリ一覧に表示されるようになります。

新しいオーガナイゼーションへのアクセスを許可する

  1. GitHub Settings のページ :  github.com/settings  にアクセスします。
  2. Authorized OAuth Apps(認証済の OAuth アプリ)の項目で Slack をクリックします。
  3. Organization access」の新しい OrG の横にある「Grant Access」をクリックします。

新しいオーガナイゼーションとそのリポジトリが、Slack の GitHub アプリのページ :  my.slack.com/apps/manage  に表示されます。

関連記事

最近チェックした記事