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

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

- 주소: https://copyandrun.com/blog/github-ruleset-protect-main-branch/
- 분야: DevSecOps
- 발행일: 2026-11-18
- 태그: GitHub, ruleset, 브랜치 보호, GH013, 풀 리퀘스트

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 한 개에 적용된다는 표시를 확인합니다.](https://copyandrun.com/img/github-ruleset-protect-main-branch/01-name-enforcement-target.png)

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

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

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

![Branch rules에서 Restrict deletions가 선택된 것을 확인합니다.](https://copyandrun.com/img/github-ruleset-protect-main-branch/02-rules-selected.png)

`Require a pull request before merging`을 켭니다.

![Require a pull request before merging이 선택된 것을 확인합니다.](https://copyandrun.com/img/github-ruleset-protect-main-branch/03-require-pull-request.png)

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

`Block force pushes`를 켭니다.

![Block force pushes가 선택된 것을 확인합니다.](https://copyandrun.com/img/github-ruleset-protect-main-branch/04-block-force-pushes.png)

맨 아래 Create를 누릅니다.

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

![Rulesets 목록에서 protect-main이 3 branch rules, targeting 1 branch로 표시된 것을 확인합니다.](https://copyandrun.com/img/github-ruleset-protect-main-branch/05-ruleset-list.png)

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

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

```text
protect-main active branch
```

## 막히는 동작 확인

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

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

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

```bash
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로 거부된 것을 확인합니다.](https://copyandrun.com/img/github-ruleset-protect-main-branch/06-push-rejected.png)

```text
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)
```

```text
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`의 효과를 따로 확인하지 못했습니다. 기본 브랜치가 아닌 브랜치를 대상으로 삼을 때 의미가 있는 규칙입니다.

## 통과하는 동작 확인

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

```bash
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
```

```text
748699a README 에 한 줄 추가 (#1)
```

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

## 알아 둘 점

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

## 정리

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

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