For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/web/deployment.md (or send Accept: text/markdown).
배포 체크리스트
프로덕션 의존성을 준비하고 출시할 플로를 검증하세요.
이 순서대로 공용 앱을 준비하세요.
배포는 다른 사람들이 방문할 수 있도록 호스팅 서비스에서 앱을 실행하는 것을 의미합니다. localhost는 개발 환경에서만 액세스할 수 있습니다. 먼저 실제 데이터베이스 기반 로그인을 로컬에서 완료하고, 아래 호스팅 가이드를 선택하고, 별도의 테스트 데이터베이스를 생성하고, 실제 공용 HTTPS 앱 URL를 사용하여 호스트 환경 설정을 구성합니다. 로컬 데모 설정을 공용 앱과 별도로 유지하세요.
저장소 루트의 두 번째 터미널에서 아래 웹 검사를 실행하세요. 성공적인 빌드는 컴퓨터에 프로덕션 버전을 생성합니다. 업로드하거나 게시하지 않습니다. corepack pnpm --filter @supastack/web start with 배포를 혼동하지 마세요. start는 이전에 빌드된 버전을 로컬에서 실행합니다. 3000번 포트에서 개발서버를 중지한 후 실행해주세요.
마이그레이션, 환경 및 시작 단계는 선택한 호스트의 가이드를 따르세요. 가입, 이메일 코드, 재시작 후 저장된 계정 데이터, 판매 시작 전 제공업체 샌드박스의 유료 기능을 테스트하세요. 모바일 또는 데스크톱 클라이언트는 이 실행 중인 HTTPS 백엔드를 가리켜야 합니다. 네이티브 앱 출시는 해당 플랫폼의 배포 가이드에 문서화된 별도의 단계입니다.
corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web build서비스 준비
Postgres 데이터베이스를 생성하고, 저장소의 마이그레이션을 적용하고, 호스팅 대시보드에 공용 앱 URL 및 인증 설정을 입력하세요. 활성화하는 기능에 대해 지원되는 웹 청구 제공업체 하나와 거래 이메일 제공업체 하나를 선택하세요. 제품이 백그라운드 워크플로우를 사용할 때 Trigger.dev를 구성하십시오. 기본 앱을 게시하기 위해 모든 통합이 필요하지는 않습니다.
프로덕션 AI 작업을 수락하기 전에 불변의 모델/가격 카탈로그와 워크스페이스 AI 정책을 설정하세요. 빈 별칭 정책은 해당 선택지를 사용 불가로 두어야 합니다.
웹 앱 빌드 및 배포
계속하기 전에 리포지토리 루트에서 아래 웹 명령을 실행하고 오류를 해결하세요. typecheck는 유형을 확인하고, test는 웹 테스트를 실행하고, build는 로컬에서 프로덕션 파일을 생성합니다. 선택한 호스팅 가이드에 따라 서버측 환경 설정으로 업로드하고 실행하세요. 이 명령은 앱을 배포하지 않습니다.
corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web test
corepack pnpm --filter @supastack/web build배포된 경계 검증
배포된 데이터베이스에서 로그인과 영속화를 검증하고, 워크스페이스 격리를 테스트하고, Stripe 샌드박스 웹훅 처리와 권한 변경을 확인하고, 백그라운드 작업을 지속된 결과와 트랜잭션 전송까지 실행하세요.
명시적 프로바이더 수용 프로세스는 리포지토리의 docs/real-provider-smoke.md와 docs/production-ai-runtime.md를 읽으세요. 성공한 빌드나 가로챈 브라우저 테스트는 이러한 외부 결과를 확립하지 않습니다.