Copy & Run

GitHub ruleset으로 main 보호: 직접 푸시와 강제 푸시 막기

GitHub 저장소에 ruleset을 만들어 main 브랜치의 삭제, 직접 푸시, 강제 푸시를 막습니다. 규칙을 켠 뒤 직접 푸시와 강제 푸시가 GH013 오류로 거부되는 것을 확인하고, 풀 리퀘스트로는 같은 변경이 들어가는 것까지 시험합니다.

실습 노트 · 2026-11-18 발행 · 6분 · 2026-11 확인

main 브랜치에 누구나 바로 푸시할 수 있으면 검토를 거치지 않은 코드가 배포되고, 강제 푸시 한 번으로 이력이 사라질 수 있습니다. GitHub의 ruleset은 브랜치에 적용할 규칙을 묶어 두는 기능입니다. 이 글에서는 시험용 공개 저장소에 규칙 세 개를 켜고, 막히는 동작과 통과하는 동작을 차례로 확인합니다.

한 문장 답

저장소 Settings의 Rulesets에서 기본 브랜치를 대상으로 Restrict deletions, Require a pull request before merging, Block force pushes를 켜고 상태를 Active로 둡니다. 그 뒤 main으로 가는 직접 푸시와 강제 푸시는 GH013 오류로 거부되고, 풀 리퀘스트를 거친 변경만 들어갑니다.

준비물

항목 내용
GitHub 계정 저장소 관리자 권한
시험 저장소 공개 저장소 하나. 이 글에서는 cr-lab-secret-scanning
도구 git, 풀 리퀘스트를 명령으로 만들려면 gh

공개 저장소에서는 ruleset을 무료로 쓸 수 있습니다. 비공개 저장소는 요금제에 따라 다르므로 Settings에 Rulesets 메뉴가 보이는지 확인합니다.

ruleset 만들기

저장소의 Settings를 엽니다.

왼쪽 메뉴에서 Rulesets를 누릅니다.

New ruleset을 누르고 New branch ruleset을 고릅니다.

아래 값을 넣습니다.

화면 입력칸 입력값
New branch ruleset Ruleset Name protect-main
New branch ruleset Enforcement status Active
Bypass list 비워 둠
Target branches Add target Include default branch

Ruleset Name이 protect-main이고 Enforcement status가 Active이며 대상이 Default로 잡혀 main 한 개에 적용된다는 표시를 확인합니다.
Ruleset Name이 protect-main이고 Enforcement status가 Active이며 대상이 Default로 잡혀 main 한 개에 적용된다는 표시를 확인합니다.

Enforcement status는 처음에 Disabled로 나옵니다. Active로 바꾸지 않으면 규칙을 저장해도 적용되지 않습니다. Bypass list를 비워 두면 저장소 관리자도 규칙을 따라야 합니다.

Branch rules에서 세 가지를 켭니다.

Restrict deletions는 처음부터 켜져 있습니다.

Branch rules에서 Restrict deletions가 선택된 것을 확인합니다.
Branch rules에서 Restrict deletions가 선택된 것을 확인합니다.

Require a pull request before merging을 켭니다.

Require a pull request before merging이 선택된 것을 확인합니다.
Require a pull request before merging이 선택된 것을 확인합니다.

이 항목을 켜면 필요한 승인 수 같은 세부 설정이 펼쳐집니다. Required approvals는 기본값 0으로 둡니다. 혼자 쓰는 저장소에서 1 이상으로 올리면 본인이 올린 풀 리퀘스트를 본인이 승인할 수 없어 병합이 막힙니다.

Block force pushes를 켭니다.

Block force pushes가 선택된 것을 확인합니다.
Block force pushes가 선택된 것을 확인합니다.

맨 아래 Create를 누릅니다.

Rulesets 목록에 새 항목이 생깁니다.

Rulesets 목록에서 protect-main이 3 branch rules, targeting 1 branch로 표시된 것을 확인합니다.
Rulesets 목록에서 protect-main이 3 branch rules, targeting 1 branch로 표시된 것을 확인합니다.

명령으로도 확인할 수 있습니다.

gh api repos/<계정>/cr-lab-secret-scanning/rulesets --jq '.[] | "\(.name) \(.enforcement) \(.target)"'
protect-main active branch

막히는 동작 확인

main에 커밋을 하나 만들어 바로 푸시합니다.

git commit -am "main 에 직접 커밋"
git push origin main

이어서 이력을 고쳐 쓴 뒤 강제 푸시를 시도합니다.

git reset --hard origin/main
git commit --amend -m "이력 고쳐 쓰기"
git push --force origin main

터미널에서 직접 푸시는 Changes must be made through a pull request로, 강제 푸시는 Cannot force-push to this branch로 거부된 것을 확인합니다.
터미널에서 직접 푸시는 Changes must be made through a pull request로, 강제 푸시는 Cannot force-push to this branch로 거부된 것을 확인합니다.

remote: error: GH013: Repository rule violations found for refs/heads/main.
remote: Review all repository rules at https://github.com/<계정>/cr-lab-secret-scanning/rules?ref=refs%2Fheads%2Fmain
remote:
remote: - Changes must be made through a pull request.
remote:
 ! [remote rejected] main -> main (push declined due to repository rule violations)
remote: error: GH013: Repository rule violations found for refs/heads/main.
remote:
remote: - Cannot force-push to this branch
remote:
remote: - Changes must be made through a pull request.
remote:
 ! [remote rejected] main -> main (push declined due to repository rule violations)
시도 결과 걸린 규칙
main에 직접 푸시 거부 Require a pull request before merging
main에 강제 푸시 거부 Block force pushes, Require a pull request before merging

저장소 관리자 계정으로 시도했는데도 거부됐습니다. 오류에 나온 주소를 열면 이 브랜치에 걸린 규칙 목록을 볼 수 있습니다.

브랜치 삭제도 시도했습니다. 결과는 거부였지만 사유가 refusing to delete the current branch였습니다. 기본 브랜치는 규칙이 없어도 지울 수 없어서, 이 시험으로는 Restrict deletions의 효과를 따로 확인하지 못했습니다. 기본 브랜치가 아닌 브랜치를 대상으로 삼을 때 의미가 있는 규칙입니다.

통과하는 동작 확인

같은 변경을 다른 브랜치에 올려 풀 리퀘스트로 넣습니다.

git checkout -b docs/readme-note
git commit -am "README 에 한 줄 추가"
git push -u origin docs/readme-note
gh pr create --base main --head docs/readme-note --title "README 에 한 줄 추가" --body "ruleset 시험용 풀 리퀘스트"
gh pr merge docs/readme-note --squash --delete-branch
748699a README 에 한 줄 추가 (#1)

풀 리퀘스트를 거친 커밋은 main에 들어갔습니다. 필요한 승인 수가 0이라 본인이 바로 병합할 수 있었습니다. 팀 저장소에서는 이 값을 1 이상으로 올려 다른 사람의 검토를 거치게 합니다.

알아 둘 점

  • ruleset은 예전의 branch protection rule과 함께 쓸 수 있고, 둘 다 있으면 더 엄격한 쪽이 적용됩니다. 새로 만든다면 ruleset 하나로 관리하는 편이 보기 쉽습니다.
  • 배포 자동화가 main에 직접 푸시한다면 그 앱이나 역할을 Bypass list에 넣어야 합니다. 목록은 짧게 유지하고, 사람 계정은 넣지 않습니다.
  • 비밀값이 든 푸시를 막는 설정은 따로 있습니다. push protection 글에서 같은 GH013 오류가 다른 사유로 나오는 것을 볼 수 있습니다.
  • 워크플로 파일의 위험 패턴은 GitHub Actions 하드닝 글에서 다룹니다.

정리

시험이 끝나면 Rulesets 목록에서 protect-main 오른쪽의 메뉴를 열어 ruleset을 지우거나, 저장소를 지웁니다.

  • ruleset의 Enforcement status가 Active인지 확인했습니다.
  • main으로 가는 직접 푸시가 GH013으로 거부되는 것을 확인했습니다.
  • 강제 푸시가 거부되는 것을 확인했습니다.
  • 풀 리퀘스트로는 변경이 들어가는 것을 확인했습니다.

이 글의 다음 단계

  • GitHub push protection 확인: 비밀값이 든 푸시가 막히는지 시험하기GitHub 공개 저장소에서 secret scanning과 push protection 설정을 확인하고, 무작위로 만든 가짜 AWS 키를 커밋해 푸시가 GH013 오류로 거부되는 것을 시험합니다. 차단된 뒤 커밋에서 값을 빼고 다시 푸시하는 방법과 허용 화면의 세 가지 선택지를 정리합니다.
  • GitHub Dependabot 켜기: 취약한 의존성 알림과 자동 수정 PR 받기오래된 버전을 고정한 requirements.txt를 시험 저장소에 넣고 Dependency graph, Dependabot alerts, Dependabot security updates를 켭니다. 알림 47건이 뜨는 것과 Dependabot이 올린 수정 풀 리퀘스트를 확인하고, 하나를 병합해 열린 알림이 36건으로 줄어드는 것까지 봅니다.

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글