Полный пайплайн деплоя Next.js и Angular на Firebase App Hosting: SSR и ISR. Настройка firebase.json с apphosting блоками и CDN.

Основы 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

Деплой из исходного кода (рекомендуется)

Это рекомендуемый способ для большинства пользователей.

Настройте firebase.json, добавив блок apphosting:

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

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

firebase-app-hosting-basicsFirebase App Hosting для Next.js

Установка