Vercel 상태 가이드
GIIP 플랫폼에서 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 상세 사양은 별도 가이드를 참조하세요.
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| 페이지가 계속 "이동 중..." 상태에 머무름 | 세션에 csn이 없거나 로그인 세션이 만료됨 | 다시 로그인하거나 프로젝트를 선택한 뒤 재접속합니다. |
| 설정 카드가 하나도 없음 | 현재 프로젝트에 등록된 Vercel 설정이 없음 | [설정 추가] 버튼으로 새 Vercel 설정을 등록합니다. |
| 최근 배포 상태가 표시되지 않음 | 아직 동기화되지 않아 배포 이력이 없음 | 카드의 [동기화] 버튼을 눌러 Vercel에서 데이터를 가져옵니다. |
배포 상태가 ERROR로 표시됨 | Vercel 빌드가 실패함 | 배포 URL 또는 Vercel 대시보드에서 빌드 로그를 확인합니다. |
| 동기화가 실패함 | Vercel 토큰이 만료되었거나 잘못됨 | 설정 [수정]에서 유효한 토큰을 갱신한 뒤 다시 동기화합니다. |
버전: 1.0
최종 업데이트: 2026-07-22
소스 파일: giipv3/public/help/vercel-status.ko.md