Vercel Hobby 플랜에서 협업자 배포 막히는 문제, 우회 경험

728x90

상황

Next.js 프로젝트를 혼자 개발하다가 다른 개발자와 협업을 시작했다. GitHub 레포에 권한을 주고 같이 작업하는 건 문제없었는데, 문제는 배포였다.

협업자가 push를 하면 Vercel에서 이런 에러가 떴다.

The Deployment was blocked because the commit author does not have
contributing access to the project on Vercel.
Hobby teams do not support collaboration.
Please upgrade to Pro to add team members.

Vercel Hobby 플랜은 팀 협업을 지원하지 않는다. 즉, Vercel에 연결된 GitHub 계정 이메일로 작성된 커밋만 자동 배포가 허용된다.

Pro 플랜으로 업그레이드하면 해결되지만, 개인 프로젝트에 월 구독료를 쓰기는 아깝다. 그래서 우회 방법을 찾아봤다.

핵심 원인 파악

그렇다면 커밋 로그의 작성자만 바꾸면, 배포가 되지않을까? 라는 접근을 하였고, 이를 한번 시도해봤다.

첫번째로는 이메일만 바꾸고, 그래도 안되면 name도 바꿀 예정이었다.

하지만, 이메일만 바꿔도 배포가 진행되었다.

그래서 내가 내린 결론으로는,

Vercel은 커밋 작성자(author) 이메일을 보고 배포 허용 여부를 판단한다.

협업자가 자신의 이메일로 커밋을 남기면 → ❌ 배포 차단 내 이메일(Vercel 연결 계정)로 커밋이 작성되면 → ✅ 배포 허용

그렇다면, 배포 직전에 커밋 작성자만 바꿔치기하면 배포가 된다.

해결 방법: git alias로 배포용 커밋 작성자 교체 자동화

1. git alias 등록 (최초 1회만)

bash

git config alias.vdeploy '!git commit --amend --author="이름 <Vercel연결이메일@gmail.com>" --no-edit && git push --force'

이메일만 Vercel에 연결된 메일로만 변경한다.

2. 배포할 때

bash

git vdeploy

이 한 줄로 아래 두 가지가 자동으로 처리된다.

마지막 커밋의 작성자를 Vercel 연결 이메일로 변경 (--amend)
force push로 원격 레포에 반영

Vercel은 push를 감지하고, 커밋 작성자가 허용된 이메일이므로 정상 배포된다. ✅

주의할 점

--force push이므로 혼자 쓰는 브랜치 또는 배포 전용 브랜치에서만 사용할 것
협업자의 커밋 이력 자체가 바뀌는 건 아니고, 마지막 커밋의 author 메타데이터만 바뀐다
평소 커밋은 원래 이메일로 유지해도 무방하다. 배포 시에만 git vdeploy를 쓰면 된다

정리

상황명령어

평소 커밋	git commit -m "..." (기존 방식 그대로)
배포할 때	git vdeploy

Pro 플랜 없이도 협업 환경에서 Vercel 자동 배포를 유지할 수 있는 실용적인 방법이였다.

하지만, 서비스를 악용하는것 같아 죄책감이 들기는 한다. 😔