Основы Firebase App Hosting

Описание

Этот навык позволяет агенту деплоить современные full-stack веб-приложения (Next.js, Angular и другие) и управлять ими с помощью Firebase App Hosting.

Важно: для использования App Hosting ваш Firebase-проект должен быть на тарифном плане Blaze. Чтобы обновить план, перейдите по ссылке: https://console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered

Hosting vs App Hosting

Выбирайте Firebase Hosting, если:

• вы деплоите статический сайт (HTML/CSS/JS);
• вы деплоите простое SPA (React, Vue и т. д. без SSR);
• вам нужен полный контроль над сборкой и деплоем через CLI.

Выбирайте Firebase App Hosting, если:

• вы используете поддерживаемый full-stack фреймворк — Next.js или Angular;
• вам нужен Server-Side Rendering (SSR) или ISR;
• вы хотите автоматический деплой по команде git push без конфигурации.

Деплой в 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 — подробнее в references/configuration.md.
3. Если приложению нужен безопасный доступ к секретным ключам, используйте команды npx -y firebase-tools@latest apphosting:secrets для установки секретов и управления доступом к ним.
4. Когда будете готовы задеплоить, выполните:

   npx -y firebase-tools@latest deploy

Автоматический деплой через GitHub (CI/CD)

В качестве альтернативы можно настроить бэкенд, связанный с репозиторием GitHub, для автоматических деплоев по команде git push. Это рекомендуется для более опытных пользователей и не является обязательным требованием для работы с App Hosting. Подробнее в references/cli_commands.md.

Эмуляция

Информация о локальном тестировании приложения с помощью Firebase Local Emulator Suite: references/emulation.md.