DEVNURION · 개발 뉴스
GitHub Stacked PR 정식 제공, 큰 변경을 나눠도 리뷰 기준은 유지
승인 보존·병합 큐·브랜치 의존성을 함께 이해해야 작은 PR이 팀의 실제 검토 단위가 됩니다.
- Stacked Pull Requests는 10월 6일 GA로 전환됐고 github.com 전체 요금제에서 제공된다.
- 코드 차이가 그대로인 rebase에서 승인을 보존하며, 스택은 merge queue에 하나의 그룹으로 들어간다.
- 자동병합은 향후 몇 주간 순차 배포된다. GHES의 정확한 제공일은 아직 안내되지 않았다.
데이터 구조부터 API와 화면까지 한 번에 바꾸면 리뷰어는 서로 다른 논점을 같은 변경 목록에서 따라가야 한다. GitHub PR을 의존 순서에 맞춰 나누면 작은 차이를 독립적으로 검토하면서도 전체 변경의 관계를 유지할 수 있다.
이번 정식 제공은 PR 개수를 늘리는 기능보다 승인과 병합의 연결을 관리한다는 점에서 의미가 있다. 팀이 먼저 정할 것은 각 층의 목적과 통과 기준이다. 작은 PR이라는 이유로 보호 규칙을 줄이면 검토 부담을 줄이는 효과도 판단하기 어려워진다.
아래 PR이 다음 층의 기준이 된다
Stacked Pull Requests는 같은 저장소 안에서 각 PR이 바로 아래 PR의 브랜치를 대상으로 하는 연결 구조다. 예를 들어 공통 타입, API, 화면 순으로 나누면 위쪽 변경은 아래쪽 변경에 의존한다. 독립적인 작업을 무조건 스택으로 묶는 방식과는 다르다.
GitHub 공식 문서는 각 PR을 스택의 기반 브랜치 규칙으로 평가한다고 설명한다. 중간 PR도 필수 리뷰와 상태 검사 등 같은 기준을 따른다. 서로 다른 fork를 가로지르는 스택과 GitHub Desktop은 지원하지 않으므로, 기존 브랜치 전략과 도구 구성을 먼저 확인해야 한다.
rebase 뒤 승인 유지에는 조건이 있다
GA 변경에는 차이가 바뀌지 않은 코드를 rebase할 때 기존 승인을 보존하는 동작이 포함된다. 기반 브랜치가 앞서갔다는 이유로 검토했던 내용까지 반복 승인하는 부담을 줄이는 방향이다. 실제 코드가 변경된 상황에서도 모든 승인이 유지된다고 확대하면 안 된다.
rebase된 대체 커밋의 서명과 원래 작성자 정보도 다룬다. 기반 브랜치가 삭제되면 연결된 스택을 자동으로 다시 대상으로 지정하는 개선도 발표됐다. 팀은 GitHub 코드리뷰 과정에서 변경 내용의 수정과 단순 기반 갱신을 구분해 기록하는 것이 좋다.
merge queue와 자동병합은 다른 단계
스택은 merge queue에서 여러 그룹으로 흩어지는 대신 하나의 merge group으로 들어가 병합된다. 위쪽 PR을 병합하려면 그 아래 PR들도 필수 조건을 충족해야 한다. 특정 PR이 큐에서 제외되면 위에 의존하는 PR들도 영향을 받을 수 있다는 점을 운영 문서와 함께 확인하자.
PR 자동병합은 GA 발표 이후 몇 주에 걸쳐 순차 배포한다고 안내됐다. 정식 제공 소식만 보고 모든 저장소에서 즉시 같은 버튼이 나타난다고 가정할 수 없다. GHES도 향후 릴리스에 포함할 계획이며, GitHub Enterprise Server 포함 시점의 정확한 날짜는 이번 발표에 없다.
| 기능 | 확인할 조건 |
|---|---|
| 승인 보존 | 코드 차이가 바뀌지 않은 rebase |
| 병합 큐 | 스택 전체의 검사·승인과 의존 순서 |
| 자동병합 | 순차 배포 및 저장소 병합 조건 |
| GHES | 향후 릴리스 예정, 날짜 미확정 |
첫 실험은 의존성이 분명한 변경부터
GitHub Stacked PR 사용법의 출발점은 기반 작업과 그 위의 작업을 나누는 것이다. gh stack 확장을 사용하거나 웹에서 만들 수 있다. CLI는 로컬 브랜치 생성·rebase·push·이동을 돕는다. 명령별 상세 절차는 공식 생성·관리 문서를 따라 현재 확장 버전과 함께 확인해야 한다.
한 번의 시범 작업에서 리뷰 대기시간, 다시 읽은 변경량, CI 반복을 기록하면 팀에 맞는지 판단하기 쉽다. GitHub는 스택 사용 저장소의 merged code가 비교군보다 9% 많았다고 소개했다. 회사의 관찰 결과이므로 팀 생산성의 확정적인 향상률로 적용하지 않는 편이 정확하다.
