이번 소식
GitHub가 비동기 병합 API를 정식 제공하며 프로그램으로 PR을 병합할 때의 권장 방식으로 안내했습니다. PR은 코드 변경을 검토해 기존 코드에 합치는 요청입니다. 비동기 방식에서는 병합을 요청하는 단계와 그 결과를 확인하는 단계를 나눕니다.
주요 변경
- 요청 뒤 상태 확인: PUT 방식으로 병합 요청을 보내고, 응답으로 받은 요청 ID를 사용해 GET 방식으로 처리 상태를 조회합니다. 복잡한 병합이 끝날 때까지 하나의 요청을 계속 붙잡아 두지 않는 구조입니다.
- 여러 병합 흐름 지원: 개별 PR과 서로 의존 관계로 연결된 stacked PR을 다루며, PR을 병합 대기열에 넣거나 직접 병합하는 흐름을 지원합니다.
- 자동화의 권장 경로 변경: GitHub는 동기식 REST 엔드포인트나 GraphQL mutation 대신 새 API를 권장한다고 밝혔습니다. 또한 연결된 stacked PR을 지원하는 병합 API는 이것뿐이라고 설명합니다.
영향 대상과 활용
예를 들어 서버와 화면 수정이 여러 PR로 이어지는 저장소에서는 앞선 변경에 의존하는 후속 PR까지 고려해야 합니다. 새 API는 이런 연결 관계를 다루는 자동화를 위한 선택지입니다. 변경을 합치는 일이 오래 걸리더라도 요청 ID를 보관해 진행 상태를 확인하는 흐름으로 프로그램을 설계할 수 있습니다.
핵심은 요청 접수와 병합 완료를 구분하는 것입니다. 자동화가 요청을 보냈다는 이유만으로 배포나 다음 단계를 즉시 시작하지 않도록, 반환된 상태를 확인해야 합니다. 이는 비동기 처리 방식에서 필요한 구현상의 주의점이며, 모든 병합이 더 빠르게 끝난다는 성능 보장은 아닙니다.
사용 전 확인할 점
저장소 규칙을 건너뛰는 선택지는 해당 권한이 있는 호출자에게만 허용됩니다. 이 기능이 기존 검토·보호 규칙을 누구나 무시할 수 있게 해 주는 것은 아닙니다. 실제 요청 인수와 결과 상태는 공식 API 문서에 맞춰 처리해야 합니다.
이번 발표는 권장 병합 경로를 바꾸는 안내입니다. 기존 동기식 REST API와 GraphQL 방식이 이미 제거됐다거나 특정 날짜에 중단된다는 공지는 포함하지 않습니다. 이 기사에서는 실제 저장소의 PR을 합치거나 처리 속도를 측정하지 않았습니다.
공식 출처·발표 시점
공식 발표 시각: 2026년 10월 1일 23:00 KST, GitHub 변경 공지의 게시 메타데이터와 RSS 기준. 세부 요청 형식은 원문이 연결한 비동기 병합 API 문서를 참고할 수 있습니다.
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.