🔐 GitHub에서 CI를 실제로 강제하려면?

🔐 GitHub에서 CI를 실제로 강제하려면?

 

앞에서 우리는 GitHub Actions로 PR이 열릴 때

pnpm install, build, test를 자동 실행하도록 구성했어요.

 

근데 사실…

테스트가 실패했는데도 Merge 버튼을 누를 수 있다면? 😱

CI를 돌리는 의미가 많이 퇴색되겠죠?

 

그래서 반드시 설정해야 하는 게 있어요.

바로 GitHub의 Branch Protection Rule입니다.

 

---

✅ 설정 위치

1. GitHub 저장소의 상단 메뉴에서 Settings 클릭

2. 좌측 메뉴에서 Branches 클릭

3. Branch protection rules 섹션에서 Add rule 클릭

 

---

✅ 필수 옵션들

→ 우리가 보호하고 싶은 브랜치 이름을 입력합니다. 보통은  main 을 보호하죠!

 

---

무조건 PR을 통해서만 main에 머지 가능하도록 강제합니다.

→ 실수로 git push origin main 해버리는 상황을 막을 수 있어요!

 

---

이게  CI 연동의 핵심 입니다!

• 체크하면 아래에서 GitHub Actions에서 정의한 워크플로우 이름 선택 가능

• 예: build-and-test 등

✅ 이걸 설정하면 CI가 통과하지 않은 PR은 Merge 버튼이 비활성화돼요

 

---

⭕ 선택 옵션 (상황에 따라)

• 리뷰 코멘트가 남아있다면 머지 불가

• 팀원과 협업할 때 좋을 듯

---

🧪 테스트 팁

이 설정을 완료한 뒤에는 꼭 아래를 테스트해보세요:

• PR을 하나 열고

• CI가 실패하는 상황을 일부러 만들고

• Merge 버튼이 비활성화되는지 확인!

 

풀리퀘스트 올린거 빌드 하고 테스트 중...

빌드하고 테스트 중...

CI 실패

Merge 버튼이 비활성화된게 보임

---

✅ 마무리 요약

설정 항목역할필수 여부

Require pull request	main에 직접 push 금지	✅
Require status checks	CI 통과 안 하면 병합 불가	✅
Require conversation resolution	리뷰 해소 전 병합 금지	⭕ 선택

 

 

---

✨ 이 설정까지 마치면 진짜 실전에서 쓸 수 있는 완벽한 CI 파이프라인이 구축됩니다!