Slack + GitHub 연동

들어가며

GitHub에서 발생하는 이벤트를 Slack으로 받으면 PR, 커밋, 이슈 변경 사항을 팀 전체가 실시간으로 파악할 수 있다. 연동 방법과 알림 설정을 정리해둔다.

---

GitHub 앱 설치

Slack App Directory에서 설치

Slack 앱 → 앱 추가 → GitHub 검색 → 설치
또는
https://slack.com/apps/A8GBNUWU8-github

GitHub에서 Slack 앱 설치

GitHub 저장소 → Settings → Integrations → Slack

---

기본 연동 설정

저장소 구독

GitHub 앱 설치 후 Slack 채널에서 명령어로 저장소를 구독한다.

비공개 채널에서 사용하려면 먼저 /invite @GitHub로 GitHub을 채널에 초대해야 한다.

/github subscribe owner/repo

예시:
/github subscribe team/shop-frontend
/github subscribe team/shop-backend

구독 확인 및 해제

# 현재 구독 목록 확인
/github subscribe list

# 구독 해제
/github unsubscribe owner/repo

---

알림 이벤트 설정

기본으로 구독하면 모든 이벤트 알림이 온다. 필요한 이벤트만 선택적으로 받을 수 있다.

기본 구독 이벤트

issues        : 이슈 생성, 수정, 종료
pulls         : PR 생성, 수정, 종료
commits       : 기본 브랜치 커밋
releases      : 릴리즈 생성
deployments   : 배포 상태 변경

이벤트 추가/제거

# 특정 이벤트 추가
/github subscribe owner/repo reviews
/github subscribe owner/repo comments
/github subscribe owner/repo +label:"bug"

# 특정 이벤트 제거
/github unsubscribe owner/repo commits
/github unsubscribe owner/repo issues

추가 가능한 이벤트

이벤트	설명
reviews	PR 리뷰 요청 및 완료
comments	PR, 이슈 댓글
branches	브랜치 생성/삭제
commits:*	모든 브랜치 커밋
+label:"bug"	특정 라벨 이슈만 알림

---

채널별 알림 분리

모든 알림을 하나의 채널에서 받으면 노이즈가 심하다. 용도에 맞게 채널을 분리하는 게 좋다.

#alert-github-pr      : PR 관련 알림만
  /github subscribe team/repo pulls reviews

#alert-github-issue   : 이슈 알림만
  /github subscribe team/repo issues

#alert-deploy         : 배포 알림만
  /github subscribe team/repo deployments releases

---

Slack에서 GitHub 액션

연동 후 Slack에서 직접 GitHub 액션을 수행할 수 있다.

# PR 목록 확인
/github prs owner/repo

# 이슈 목록 확인
/github issues owner/repo

# 저장소 검색
/github search owner/repo "검색어"

---

PR 알림 활용

PR 알림이 오면 Slack에서 바로 확인하고 반응할 수 있다.

PR 알림 메시지에서:
- 링크 클릭 → GitHub PR 페이지로 이동
- Open / Merged / Closed 상태 표시
- CI 통과 여부 표시

팀 활용 패턴:
1. PR 생성 → #alert-github-pr에 알림
2. 리뷰어 Slack 멘션
3. 리뷰 완료 → ✅ 이모지 반응
4. merge 완료 → 자동 알림

---

정리

명령어	설명
/github subscribe owner/repo	저장소 구독
/github unsubscribe owner/repo	구독 해제
/github subscribe list	구독 목록 확인
/github subscribe owner/repo reviews	리뷰 알림 추가
/github prs owner/repo	PR 목록 확인
/github issues owner/repo	이슈 목록 확인