Community코딩 & 개발github.com

THE3RDTRAINER/Homepage

Next.js, Angular 등 풀스택 웹 애플리케이션을 Firebase App Hosting으로 배포 및 관리합니다. Next.js/Angular 앱 배포, apphosting.yaml 또는 firebase.json apphosting 블록 구성, 시크릿 관리, GitHub CI/CD 설정, Blaze 과금제 구성 시 사용하세요. 정적 웹 호스팅, Auth, Firestore, Crashlytics, Xcode에는 사용하지 마세요.

Homepage란 무엇인가요?

이 스킬은 Firebase App Hosting을 사용하여 Next.js, Angular와 같은 최신 풀스택 웹 애플리케이션을 배포하고 관리하는 방법을 제공합니다. Firebase App Hosting은 서버사이드 렌더링(SSR)과 증분 정적 재생성(ISR)을 지원하며, 정적 사이트에는 적합하지 않습니다(이 경우 Firebase Hosting을 사용). 배포는 firebase.json의 apphosting 블록과 apphosting.yaml 설정을 통해 소스에서 직접 배포하거나, GitHub 저장소와 연결하여 CI/CD 기반의 'git push to deploy' 자동화 워크플로우를 구성할 수 있습니다. 또한 Firebase Local Emulator Suite를 이용한 로컬 테스트(에뮬레이션)도 지원합니다. 이 스킬을 사용하려면 Firebase 프로젝트가 Blaze(종량제) 요금제여야 하며, 시크릿 관리는 `npx firebase-tools apphosting:secrets` 명령어를 사용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/THE3RDTRAINER/Homepage/tree/HEAD/.agents/skills/firebase-app-hosting-basics

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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에 배포하기

소스에서 배포

대부분의 사용자에게 권장되는 흐름입니다.

  1. firebase.json에 apphosting 블록을 구성합니다.

    {
      "apphosting": {
        "backendId": "my-app-id",
        "rootDir": "/",
        "ignore": [
          "node_modules",
          ".git",
          "firebase-debug.log",
          "firebase-debug.*.log",
          "functions"
        ]
      }
    }
    
  2. apphosting.yaml을 생성하거나 편집합니다. 자세한 내용은 설정을 참조하세요.

  3. 앱이 민감한 키에 안전하게 접근해야 하는 경우 npx -y firebase-tools@latest apphosting:secrets 명령어를 사용하여 시크릿을 설정하고 접근 권한을 부여합니다.

  4. 배포할 준비가 되면 npx -y firebase-tools@latest deploy를 실행합니다.

GitHub를 통한 자동 배포 (CI/CD)

또는 GitHub 저장소에 연결된 백엔드를 설정하여 'git push' 시 자동 배포되도록 할 수 있습니다. 이는 고급 사용자에게만 권장되며, App Hosting 사용에 필수는 아닙니다. CLI 명령어를 사용하여 설정하는 방법은 CLI 명령어를 참조하세요.

에뮬레이션

Firebase Local Emulator Suite를 사용하여 로컬에서 앱을 테스트하는 방법은 에뮬레이션을 참조하세요.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬