Vercel 상태 가이드

GIIP 플랫폼에서 Vercel 배포 상태를 확인하고 배포 이력을 모니터링하는 방법을 안내합니다.

🚀 Vercel 상태 페이지로 이동 →

📋 개요

Vercel 상태 페이지는 GIIP에 등록된 Vercel 설정과 각 설정의 최신 배포 상태를 한눈에 확인하는 화면입니다. 이 페이지에 접속하면 현재 선택된 프로젝트(csn)의 Vercel 관리 목록(/project/[csn]/vercel)으로 자동 이동합니다. 프로젝트가 선택되어 있지 않으면 기본 프로젝트로 이동합니다.

🔍 주요 구성 요소

1. Vercel 설정 카드 목록

등록된 각 Vercel 설정이 카드 형태로 표시됩니다. 카드에는 설정 이름(vcConfigName), 연동된 Vercel 프로젝트명(vcVercelProjectName), 설명이 나타납니다. 비활성화된 설정은 흐리게 표시되고 비활성(Inactive) 배지가 붙습니다.

2. 최근 배포 상태 배지

각 카드에는 가장 최근 배포의 상태가 색상 배지로 표시됩니다.

• READY (초록): 배포 완료
• BUILDING (파랑): 빌드 진행 중
• ERROR (빨강): 배포 실패
• CANCELED (노랑): 배포 취소
• QUEUED (보라): 대기 중

배포 URL이 있으면 클릭하여 새 탭에서 실제 배포된 사이트를 열 수 있습니다. 카드 하단에는 총 배포 개수(deploymentCount)와 마지막 동기화 날짜(vcLastSyncAt)가 표시됩니다.

3. 카드 액션 버튼

각 카드에서 다음 작업을 수행할 수 있습니다.

• 배포 보기: 해당 설정의 배포 이력 상세 페이지로 이동합니다.
• 동기화: Vercel에서 최신 배포 정보를 가져와 갱신합니다.
• 수정: 설정을 편집합니다.
• 삭제: 설정을 삭제합니다(삭제 전 확인 창이 표시됩니다).

4. 배포 이력 테이블

설정 카드에서 [배포 보기]를 누르면 해당 설정의 배포 목록이 테이블로 표시됩니다. 컬럼은 URL, 상태(State), 생성 시각(Created), 생성자(Creator), 대상(Target)입니다. 상단에서 상태 필터(전체/READY/BUILDING/ERROR/CANCELED/QUEUED)와 표시 개수(10/20/50)를 조정할 수 있습니다.

🛠️ 활용 팁

• 새 설정 추가: 우측 상단의 [설정 추가] 버튼으로 새 Vercel 설정을 등록할 수 있습니다.
• 최신화: 배포 상태는 자동으로 실시간 갱신되지 않습니다. 최신 상태가 필요하면 카드 또는 상세 페이지의 [동기화] 버튼을 눌러 Vercel에서 데이터를 새로 가져오세요.
• 프로젝트 전환: 상단에서 프로젝트를 변경하면 해당 프로젝트의 Vercel 목록으로 자동 전환됩니다.

💡 유의 사항

• 이 페이지 자체는 리다이렉트 전용입니다. 잠시 "Vercel 관리 페이지로 이동 중..." 메시지가 표시된 뒤 프로젝트 Vercel 목록으로 이동합니다.
• 배포 목록이 비어 있다면 아직 동기화가 이루어지지 않았거나 Vercel 토큰이 유효하지 않을 수 있습니다.

API 참조

이 기능의 API 상세 사양은 별도 가이드를 참조하세요.

📘 Vercel 관리 API 가이드

문제 해결

증상	원인	해결
페이지가 계속 "이동 중..." 상태에 머무름	세션에 csn이 없거나 로그인 세션이 만료됨	다시 로그인하거나 프로젝트를 선택한 뒤 재접속합니다.
설정 카드가 하나도 없음	현재 프로젝트에 등록된 Vercel 설정이 없음	[설정 추가] 버튼으로 새 Vercel 설정을 등록합니다.
최근 배포 상태가 표시되지 않음	아직 동기화되지 않아 배포 이력이 없음	카드의 [동기화] 버튼을 눌러 Vercel에서 데이터를 가져옵니다.
배포 상태가 ERROR로 표시됨	Vercel 빌드가 실패함	배포 URL 또는 Vercel 대시보드에서 빌드 로그를 확인합니다.
동기화가 실패함	Vercel 토큰이 만료되었거나 잘못됨	설정 [수정]에서 유효한 토큰을 갱신한 뒤 다시 동기화합니다.

---

버전: 1.0 최종 업데이트: 2026-07-22 소스 파일: giipv3/public/help/vercel-status.ko.md