mcpField
F
firebase-app-hosting-basics

firebase-app-hosting-basics

官方
github.com/firebase云与 DevOps491170.9k 次安装1 天前更新
代码仓库

关于 firebase-app-hosting-basics

firebase-app-hosting-basics 是帮助 Agent 使用 Firebase App Hosting 部署和管理全栈 Web 应用的技能，涵盖源码部署、GitHub 自动部署及本地模拟器测试，并说明何时选择 App Hosting 而非 Firebase Hosting。

主要功能

  1. 01配置 App Hosting 后端
  2. 02从源码部署全栈应用
  3. 03设置 GitHub 自动部署
  4. 04使用 Local Emulator Suite 测试

适用场景

  1. 01部署 Next.js 或 Angular 应用
  2. 02为支持 SSR 或 ISR 的应用配置托管
  3. 03为代码仓库设置推送触发的部署

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/firebase/agent-skills --skill firebase-app-hosting-basics

安装后在 Claude Code 中输入/firebase-app-hosting-basics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
cli_commands.md
configuration.md
emulation.md

详细介绍

App Hosting 基础知识

描述

此技能支持 Agent 使用 Firebase App Hosting 部署和管理现代全栈 Web 应用（Next.js、Angular 等）。

重要：使用 App Hosting 时，Firebase 项目必须采用 Blaze 价格方案。请引导用户访问 https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered 升级方案。

Hosting 与 App Hosting 的区别

选择 Firebase Hosting 的情况：

  • 部署静态网站（HTML/CSS/JS）。
  • 部署简单的 SPA（React、Vue 等，不使用 SSR）。
  • 希望通过 CLI 完全掌控构建和部署流程。

选择 Firebase App Hosting 的情况：

  • 使用 Next.js 或 Angular 等受支持的全栈框架。
  • 需要服务器端渲染（SSR）或 ISR。
  • 希望使用无需配置的自动化“git push 即部署”工作流。

部署到 App Hosting

从源代码部署

这是大多数用户推荐采用的流程。

  1. 在 firebase.json 中配置 apphosting 块。

    {
  "apphosting": {
    "backendId": "my-app-id",
    "rootDir": "/",
    "ignore": [
      "node_modules",
      ".git",
      ".next",
      ".vercel",
      "firebase-debug.log",
      "firebase-debug.*.log",
      "functions"
    ]
  }
}

  2. 创建或编辑 apphosting.yaml——更多信息请参阅 配置。

  3. 如果后端不存在，请创建后端（apphosting:backends:list；如果某个区域达到 10 个后端的配额上限，请切换 --primary-region，例如 us-east4）：

    npx -y firebase-tools@latest apphosting:backends:create --backend my-app-id --primary-region us-central1 --root-dir /

  4. 如果应用需要安全地访问敏感密钥，请在创建后端后设置密钥并授予访问权限：

    printf '%s' '<value>' | npx -y firebase-tools@latest apphosting:secrets:set <secret-name> --data-file - --force
npx -y firebase-tools@latest apphosting:secrets:grantaccess <secret-name> --backend my-app-id

  5. 准备好部署后，运行 npx -y firebase-tools@latest deploy。

通过 GitHub 自动部署（CI/CD）

也可以设置连接到 GitHub 仓库的后端，以通过“git push”自动部署。此方式仅建议高级用户使用，并非使用 App Hosting 的必要条件。请参阅 CLI 命令，了解如何使用 CLI 命令进行设置。

模拟

请参阅模拟，了解如何使用 Firebase Local Emulator Suite 在本地测试应用。

评论

支持 Markdown