vercel 자동배포 반영이 안 된 이유 - 고정링크가 따로 있었다

요약

글을 쓰고 푸시했는데 사이트에 반영이 안 됐습니다. 자동 배포 오류인 줄 알았는데, 원인은 엉뚱한 데 있었습니다.

Vercel은 푸시할 때마다 그 순간의 사이트를 통째로 저장하고 고유 주소를 하나씩 붙입니다. 그 주소는 고유주소 생성된 이후에는 동기화가 되지 않는데 그걸 모르고 계속 새로고침만 하고 있었습니다.

이런 분께 도움이 됩니다

• Vercel로 사이트를 배포해두고 매일 글을 올리는 분

• 분명히 푸시했는데 사이트가 그대로인 분

• 주소가 여러 개인데 뭐가 진짜인지 모르겠는 분

진행 방법

상황: 분명히 올렸는데 안 보인다

오늘 학습일지와 사례글을 쓰고 깃허브에 푸시까지 마쳤습니다. 그런데 제 사이트에 들어가 보니 어제와 똑같았습니다.

그래서 AI에게 이렇게 물어봤습니다.

근데 이거 vercel 화면에도 연동 자동으로 되어야 하는데 왜 안되는 거야?

원인을 찾는 순서 (이게 핵심입니다)

여기서 배운 게 있습니다. 안 될 때 아무거나 찍지 말고, 글이 지나가는 길을 순서대로 짚어보는 것입니다. 제 글이 사이트에 도착하려면 이런 길을 지나갑니다.

내 컴퓨터 → 깃허브 → Vercel이 감지 → 빌드(사이트 만들기) → 주소로 공개

이 중 어디가 끊겼는지 앞에서부터 하나씩 확인했습니다.

1단계: 깃허브까지 갔나

git status -sb

맨 윗줄에 이렇게 나오면 성공입니다.

## master...origin/master

내 컴퓨터와 깃허브가 같은 상태라는 뜻입니다. 뒤에 [ahead 1] 같은 게 붙어 있으면 아직 안 올라간 게 남아 있다는 뜻이니 푸시를 해야 합니다.

2단계: Vercel이 알아챘나

Vercel 대시보드에 들어가서 Deployments 목록을 봅니다. 방금 올린 커밋이 목록에 있고 초록색이면 감지도 되고 배포도 성공한 것입니다.

여기에 Vercel 대시보드의 Deployments 목록 스크린샷을 넣으면 좋아요.

3단계: 사이트 만들기가 실패했나

내 컴퓨터에서 직접 만들어봅니다.

npm run build

에러 없이 끝나고 마지막에 이런 줄이 나오면 정상입니다.

[build] Complete!

*그 위에 방금 쓴 글의 주소가 목록에 나오는지도 같이 보세요. 목록에 없으면 그 글이 사이트에 안 들어간 것이고, 있으면 사이트 만들기까지는 문제가 없는 것입니다.

4단계: 주소가 맞나

앞의 세 단계가 전부 통과였습니다. 그래서 마지막 남은 게 주소였습니다.

제가 보고 있던 주소는 이런 모양이었습니다.

https://내프로젝트-44tqdyvo2-내팀이름.vercel.app/wiki

가운데 뒤죽박죽한 글자(44tqdyvo2)가 문제였습니다.

배포 할 때마다 주소가 새로 생긴다

Vercel은 푸시할 때마다 그 순간의 사이트를 사진 찍듯 저장하고, 사진마다 고유 번호를 붙입니다.

이걸 커밋 URL이라고 부른다고 합니다.

그리고 이 주소들은 영원히 안 바뀝니다.
7월 26일 사진을 아무리 새로고침해도 27일에 쓴 글은 나올 수가 없습니다.

저는 며칠 전에 배포하고 그때 뜬 주소를 즐겨찾기에 넣어뒀습니다. 그리고 아무리 글을 쓰고 새로고침해도 계속 며칠 전 모습만 보여주고 있었습니다.

해결: 고정 주소를 찾는다

다행히 항상 최신을 보여주는 주소가 따로 있습니다.

찾는 법입니다.

1. Vercel에 로그인

2. 내 프로젝트 클릭

3. 위쪽 Domains 항목 열기

4. 거기 주소들 중에서 가운데 뒤죽박죽한 글자가 없는 것이 고정 주소

ALT

제품 목록 페이지 스크린샷

이 주소를 즐겨찾기에 넣으면 끝입니다.

배운 점

"커밋 URL이 따로 있다"

이게 오늘 제일 쓸모 있는 발견이었습니다. 주소 가운데 의미를 알 수 없는 글자 덩어리가 끼어 있으면 그건 그날의 사진입니다.

소감

좀 허무했습니다. 새로고침을 해도 반영이 안되어서 오류인 줄 알았는데, 결론은 제가 URL을 잘못 저장해둔 거였으니까요.

이것 말고 브랜치 URL이라고, 특정 작업 갈래의 최신을 보여주는 주소도 있다고 하는데 이렇게 링크의 종류가 더 있을 거라고는 생각을 못했네요.

그래도 이런 시행착오로 하나씩 배우는 재미가 있는 것 같습니다 :)