배포와 운영 점검

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

Worker 서버는 브라우저 DOM이나 로컬 영구 디스크를 사용할 수 없습니다. 브라우저 JS·CSS·이미지는 앱의 정적 배포에 포함하고, 운영 업로드 파일은 스토리지에 둡니다. Hono의 단일 서버 번들 배포 명령은 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·로컬 인증 파일은 제외합니다.

실행하지 못한 외부 연동이나 부하 시험은 미검증으로 기록하세요. 예제의 로컬 성공이 고객 앱 전체의 운영 보장은 아닙니다.