솜사탕 Docs운영
배포 복구와 롤백
실패 원인을 수정해 재시도하거나 과거 ACTIVE 배포로 안전하게 되돌립니다.
이 문서에서 다루는 내용
재시도와 롤백 선택
- 상황
- 빌드 설정·환경변수·일시 오류를 수정함
- 선택
- 실패 배포 재시도
- 이유
- 원본 소스 revision을 기준으로 현재 서비스 설정과 환경변수를 다시 검증합니다.
- 상황
- 새 버전 배포 뒤 고객 오류가 발생함
- 선택
- 과거 ACTIVE 배포로 롤백
- 이유
- 검증됐던 과거 빌드 결과로 새 배포를 시작합니다.
- 상황
- DB schema나 데이터가 잘못 변경됨
- 선택
- 배포 버튼보다 데이터 복구 판단
- 이유
- 애플리케이션 롤백은 데이터베이스를 이전 시점으로 되돌리지 않습니다.
- 상황
- 다른 배포가 진행 중임
- 선택
- 진행 중 배포를 먼저 확인
- 이유
- 같은 서비스에 QUEUED·BUILDING·DEPLOYING 배포가 있으면 재시도와 롤백을 시작할 수 없습니다.
| 상황 | 선택 | 이유 |
|---|---|---|
| 빌드 설정·환경변수·일시 오류를 수정함 | 실패 배포 재시도 | 원본 소스 revision을 기준으로 현재 서비스 설정과 환경변수를 다시 검증합니다. |
| 새 버전 배포 뒤 고객 오류가 발생함 | 과거 ACTIVE 배포로 롤백 | 검증됐던 과거 빌드 결과로 새 배포를 시작합니다. |
| DB schema나 데이터가 잘못 변경됨 | 배포 버튼보다 데이터 복구 판단 | 애플리케이션 롤백은 데이터베이스를 이전 시점으로 되돌리지 않습니다. |
| 다른 배포가 진행 중임 | 진행 중 배포를 먼저 확인 | 같은 서비스에 QUEUED·BUILDING·DEPLOYING 배포가 있으면 재시도와 롤백을 시작할 수 없습니다. |
실패 배포 재시도
- 1FAILED 배포의 오류와 로그를 확인합니다마지막 오류를 기준으로 소스, Root Directory, 명령, PORT 또는 환경변수 중 무엇을 바꿀지 결정합니다.
- 2원인을 수정하고 저장합니다환경변수와 서비스 설정은 저장만 하지 말고 적용 대기 상태까지 확인합니다.
- 3실패 배포에서 재시도를 선택합니다재시도는 기존 기록을 덮어쓰지 않고 별도의 새 배포로 남습니다.
- 4새 배포가 ACTIVE인지 검증합니다공개 URL과 런타임·HTTP 로그에서 원래 문제가 해결됐는지 확인합니다.
과거 ACTIVE 배포로 롤백
배포 히스토리에서 현재 활성 배포가 아닌 과거 ACTIVE 항목을 선택해 롤백할 수 있습니다. 롤백도 새 배포를 생성하며 완료되기 전까지 현재 서비스를 복구 완료로 보지 않습니다.
롤백이 되돌리는 범위
과거 빌드 이미지 또는 소스 revision은 되돌리지만, 현재 서비스의 환경변수, DB 연결, 내부 서비스 연결과 일부 실행 설정은 새 롤백 배포 시점의 값을 사용합니다. DB schema와 데이터, 외부 API 상태는 롤백되지 않습니다. 컨테이너 로컬 폴더에 쓴 파일도 복구 대상이 아니므로 사용자 업로드는 영구 파일 보관 방식을 사용하세요.
복구가 시작되지 않을 때
- 재시도와 롤백은 새 배포로 처리되어 현재 청구 기간의 배포 사용량에 포함됩니다.
- 배포 한도에 도달했다면 결제 화면의 사용량과 가능한 상위 플랜 경로를 확인합니다.
- 진행 중 배포가 오래 멈춰 있거나 동일한 플랫폼 오류가 반복되면 연속 재시도보다 지원 요청이 우선입니다.
- 지원 요청에는 서비스 이름, 발생 시각, 대상 배포 상태와 비밀값을 제거한 오류 구간을 포함합니다.