App Hosting 기본
설명
이 스킬은 에이전트가 Firebase App Hosting을 사용하여 최신 풀스택 웹 애플리케이션(Next.js, Angular 등)을 배포하고 관리할 수 있도록 합니다.
중요: App Hosting을 사용하려면 Firebase 프로젝트가 Blaze 요금제여야 합니다. 사용자를 https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered 로 안내하여 요금제를 업그레이드하세요.
Hosting vs App Hosting
다음 경우 Firebase Hosting을 선택하세요:
- 정적 사이트(HTML/CSS/JS)를 배포하는 경우
- SSR 없는 간단한 SPA(React, Vue 등)를 배포하는 경우
- CLI를 통해 빌드 및 배포 과정을 완전히 제어하려는 경우
다음 경우 Firebase App Hosting을 선택하세요:
- Next.js 또는 Angular와 같은 지원되는 풀스택 프레임워크를 사용하는 경우
- 서버사이드 렌더링(SSR) 또는 ISR이 필요한 경우
- 제로 구성으로 자동화된 'git push to deploy' 워크플로우를 원하는 경우
App Hosting에 배포하기
소스에서 배포
대부분의 사용자에게 권장되는 흐름입니다.
-
firebase.json에apphosting블록을 구성합니다.{ "apphosting": { "backendId": "my-app-id", "rootDir": "/", "ignore": [ "node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log", "functions" ] } } -
apphosting.yaml을 생성하거나 편집합니다. 자세한 내용은 설정을 참조하세요. -
앱이 민감한 키에 안전하게 접근해야 하는 경우
npx -y firebase-tools@latest apphosting:secrets명령어를 사용하여 시크릿을 설정하고 접근 권한을 부여합니다. -
배포할 준비가 되면
npx -y firebase-tools@latest deploy를 실행합니다.
GitHub를 통한 자동 배포 (CI/CD)
또는 GitHub 저장소에 연결된 백엔드를 설정하여 'git push' 시 자동 배포되도록 할 수 있습니다. 이는 고급 사용자에게만 권장되며, App Hosting 사용에 필수는 아닙니다. CLI 명령어를 사용하여 설정하는 방법은 CLI 명령어를 참조하세요.
에뮬레이션
Firebase Local Emulator Suite를 사용하여 로컬에서 앱을 테스트하는 방법은 에뮬레이션을 참조하세요.