솜사탕 Docs운영
운영 전 준비 체크리스트
실제 고객 트래픽을 받기 전에 배포·비밀값·데이터·도메인·복구 경로를 확인합니다.
이 문서에서 다루는 내용
소스와 배포
- 운영에 사용할 GitHub 저장소와 브랜치가 정확한지 확인합니다.
- Root Directory, Build Command, Start Command와 Healthcheck Path를 실제 앱 구조에 맞춥니다.
- 서버가 PORT 환경변수를 사용하고 0.0.0.0에 바인딩되는지 확인합니다.
- 자동 배포를 켰다면 운영 브랜치 push가 배포를 시작하고, 진행 중 배포와 겹치면 가장 최신 push가 다음 배포로 이어진다는 점을 팀과 공유합니다.
- 마지막 배포가 ACTIVE이고 적용 대기 설정이 없는지 확인합니다.
비밀값과 데이터
- 비밀번호, API 토큰과 DB 연결 문자열이 저장소·브라우저 번들·로그에 포함되지 않았는지 확인합니다.
- 브라우저 공개 접두사가 붙은 변수에는 공개돼도 되는 값만 저장합니다.
- DB를 사용하는 서비스만 PostgreSQL에 연결하고 새 ACTIVE 배포에서 DATABASE_URL 적용을 확인합니다.
- schema migration은 재실행과 실패에 안전한 절차로 별도 검증합니다.
- 사용자 업로드를 컨테이너 로컬 폴더에 저장하지 않았는지 확인하고, 파일 보관은 외부 object storage 연결 기준을 따릅니다.
- 중요 데이터는 파괴적 변경 전에 애플리케이션 수준의 별도 export를 준비합니다.
도메인과 핵심 사용자 흐름
- 기본 HTTPS 주소에서 먼저 정상 동작을 확인한 뒤 커스텀 도메인을 연결합니다.
- 커스텀 도메인의 HTTPS 활성 상태와 http에서 https로 접근되는지 확인합니다.
- 로그인, 폼 제출, 파일 또는 데이터 변경, 외부 API 호출과 오류 화면을 실제 모바일·데스크톱에서 점검합니다.
- AI 하자점검 결과는 보조 자료로 사용하고 인증·결제·데이터 변경 흐름은 직접 검증합니다.
복구와 한도
- 실패 배포 재시도와 과거 ACTIVE 배포 롤백 위치를 미리 확인합니다.
- 롤백이 DB schema와 데이터를 되돌리지 않는다는 점을 확인합니다.
- 플랜별 고객 로그 조회 범위(Free 1일, Starter 3일, Pro 7일)를 고려해 중요한 앱 로그는 별도 보존 전략을 검토합니다.
- 결제 화면에서 배포, 트래픽, 서비스, DB 용량과 플랜 한도를 확인합니다.
- 지원 요청에 포함할 서비스 이름, 발생 시각, 배포 상태와 비밀값 제거 로그를 준비합니다.
현재 플랫폼 경계
고객용 staging·PR preview 환경, 고객 self-service replica·multi-region·autoscaling, PostgreSQL 시점 복구와 고객 직접 restore는 현재 일반 지원 기능이 아닙니다. 이 기능이 필요한 워크로드는 운영 시작 전에 지원 범위를 상담하세요.
운영 시작 판단
- 판정
- 진행
- 조건
- 핵심 흐름·복구·한도·책임 범위를 확인함
- 다음 행동
- 점진적으로 트래픽을 열고 초기 로그를 집중 확인
- 판정
- 보류
- 조건
- DB 복구, 고가용성 또는 장기 로그가 필수인데 대안이 없음
- 다음 행동
- 지원 상담 후 외부 도구나 다른 구성을 결정
- 판정
- 중단
- 조건
- 비밀값 노출, DB 백업 부재, ACTIVE 미확인 또는 반복 플랫폼 오류
- 다음 행동
- 원인을 제거하고 새 배포와 복구 절차를 다시 검증
| 판정 | 조건 | 다음 행동 |
|---|---|---|
| 진행 | 핵심 흐름·복구·한도·책임 범위를 확인함 | 점진적으로 트래픽을 열고 초기 로그를 집중 확인 |
| 보류 | DB 복구, 고가용성 또는 장기 로그가 필수인데 대안이 없음 | 지원 상담 후 외부 도구나 다른 구성을 결정 |
| 중단 | 비밀값 노출, DB 백업 부재, ACTIVE 미확인 또는 반복 플랫폼 오류 | 원인을 제거하고 새 배포와 복구 절차를 다시 검증 |