솜사탕 Docs운영
배포 상태와 로그
배포가 어느 단계에 있는지 확인하고 빌드·런타임·HTTP 로그에서 문제를 찾습니다.
이 문서에서 다루는 내용
배포 상태
- 상태
- QUEUED
- 의미
- 배포 요청이 등록되어 시작을 기다리는 중
- 상태
- BUILDING
- 의미
- 저장소를 가져와 실행 이미지로 만드는 중
- 상태
- DEPLOYING
- 의미
- 새 실행 버전을 준비하고 상태를 확인하는 중
- 상태
- ACTIVE
- 의미
- 배포 완료로 기록된 상태. 이 배포의 환경변수와 빌드·실행 설정이 현재 서비스에 적용됨
- 상태
- FAILED
- 의미
- 배포가 중단되어 로그와 오류 안내를 확인해야 함
| 상태 | 의미 |
|---|---|
| QUEUED | 배포 요청이 등록되어 시작을 기다리는 중 |
| BUILDING | 저장소를 가져와 실행 이미지로 만드는 중 |
| DEPLOYING | 새 실행 버전을 준비하고 상태를 확인하는 중 |
| ACTIVE | 배포 완료로 기록된 상태. 이 배포의 환경변수와 빌드·실행 설정이 현재 서비스에 적용됨 |
| FAILED | 배포가 중단되어 로그와 오류 안내를 확인해야 함 |
설정 적용 여부 확인
저장된 환경변수와 Root Directory, Build Command, Start Command, Healthcheck Path가 현재 서비스와 다르면 배포 탭에 적용 대기 항목과 개수가 표시됩니다. 새 배포가 ACTIVE가 되면 대기 표시가 사라집니다.
배포 기록 생성과 적용 완료는 다릅니다
QUEUED, BUILDING, DEPLOYING 또는 FAILED 배포는 현재 서비스의 적용 기준을 바꾸지 않습니다. 적용 후에도 공개 URL과 최신 로그로 핵심 동작을 확인하세요.
로그 종류
- 로그
- 빌드 로그
- 언제 보나요?
- BUILDING 또는 빌드 실패
- 대표 문제
- 의존성 설치, 프레임워크 감지, build command
- 로그
- 런타임 로그
- 언제 보나요?
- 앱 시작 후 오류
- 대표 문제
- start command, 누락된 변수, 애플리케이션 예외
- 로그
- HTTP 로그
- 언제 보나요?
- 서비스는 실행되지만 요청이 실패
- 대표 문제
- 4xx/5xx, 경로, 응답 지연
| 로그 | 언제 보나요? | 대표 문제 |
|---|---|---|
| 빌드 로그 | BUILDING 또는 빌드 실패 | 의존성 설치, 프레임워크 감지, build command |
| 런타임 로그 | 앱 시작 후 오류 | start command, 누락된 변수, 애플리케이션 예외 |
| HTTP 로그 | 서비스는 실행되지만 요청이 실패 | 4xx/5xx, 경로, 응답 지연 |
안전하게 로그 사용하기
- 비밀번호, API 토큰, 쿠키, 전체 DB 연결 문자열을 애플리케이션 로그에 출력하지 마세요.
- 지원 요청에는 비밀값을 제거한 오류 구간과 발생 시각, 배포 상태를 포함하세요.
- 고객 로그 화면과 API의 최대 조회 범위는 Free 1일, Starter 3일, Pro 7일입니다.
- 긴 빌드 로그는 마지막 오류와 그 직전 문맥을 함께 확인하세요.
- 환경변수 문제를 확인할 때 값이 아니라 키의 존재 여부만 기록하세요.