배포와 운영 점검

서버 코드와 브라우저 파일을 구분하세요

앱의 파일은 서버 코드, 브라우저용 정적 파일, 이용자가 업로드한 파일로 나눌 수 있습니다. Worker에서 실행할 서버 코드는 번들로 배포하고, JS·CSS·이미지는 앱의 정적 파일 배포 경로에 포함합니다. 업로드 파일은 프로젝트 스토리지에 저장합니다. Worker는 브라우저 DOM과 영구 로컬 디스크를 제공하지 않으며, 서버 번들 배포와 public 폴더 배포는 별도로 준비해야 합니다.

템플릿이나 기존 앱을 사용한다면 해당 프로젝트의 빌드 설정에서 정적 파일 처리 방식을 확인하세요. 배포 후 각 페이지 주소를 직접 열고 새로고침해 이미지와 스크립트가 정상적으로 로드되는지 확인합니다.

배포 기록과 롤백

joripspace deployments --project PROJECT --json
joripspace events --project PROJECT --event-type error
joripspace checkpoint list --project PROJECT
joripspace rollback --project PROJECT --deployment DEPLOYMENT_ID

실제 배포 ID를 확인한 뒤 필요한 경우에만 롤백합니다. 코드 롤백이 DB 마이그레이션·외부 결제·이미 발송한 메일까지 되돌리지는 않습니다. 배포 전에 소스와 마이그레이션 이력, 운영 백업·복구 방법을 확인하세요. GitHub 연결 프로젝트는 설정된 배포 브랜치와 트리거를 따릅니다.

내 도메인 연결

joripspace domains --project PROJECT
joripspace domain create --project PROJECT --hostname www.example.com
joripspace domain verify --project PROJECT --hostname www.example.com

도메인은 본인이 관리하는 실제 주소로 바꾸세요. 생성 응답의 CNAME 대상을 DNS 관리 서비스에 등록한 뒤 verify로 상태를 확인합니다. DNS 설정과 HTTPS 인증서 준비가 모두 끝나면 연결한 주소로 접속할 수 있습니다. 도메인 사용 조건은 기존 프로젝트 설정을 따릅니다.

메일 제공자 연결

joripspace mail connect --project PROJECT
joripspace mail status --project PROJECT
joripspace mail test --project PROJECT

connect 응답이 SMTP 설정이나 Google 동의를 요구하면 반환된 조립스페이스 화면에서 진행하세요. 메일 비밀번호·키를 에이전트 대화에 전달하지 않습니다. 연결 후 본인이 받을 수 있는 테스트 주소로 발송 결과를 확인합니다. 대량 발송은 outbox와 중복 방지·실패 재처리로 분리하세요.

출시 전 점검 항목

• 타입 검사·빌드·기능 테스트와 운영 URL의 응답을 확인합니다.
• 로그인·권한 거부·입력 오류·동시 수정·외부 API 장애를 시험합니다.
• DB 주요 조회의 실행 계획, 페이지네이션, 파일 권한과 삭제 흐름을 확인합니다.
• PG 테스트 결제·중복 승인, 두 화면 실시간 수신·복구, 크론 실제 실행을 확인합니다.
• 실제 사용량과 오류율을 관찰하고 알림·백업·복구 책임을 정합니다.
• 소스·원본 설정·lockfile을 Git에 보관하고 Secret·로컬 인증 파일은 제외합니다.

앱에서 사용하는 외부 서비스는 테스트 환경에서 실제 요청을 보내 확인하세요. 예상 이용량에 맞춘 부하 시험과 장애 복구 절차도 준비하면 출시 후 문제에 대응하기 쉽습니다.