firebase-hosting-basics
firebase-hosting-basics — официальный навык Firebase для классического Firebase Hosting. Он помогает развернуть статический сайт, одностраничное приложение или небольшой динамический сервис, когда публикация строится вокруг конфигурации hosting и управляемых каналов Firebase. Навык полезен на этапе выбора продукта: Firebase Hosting подходит для статических файлов и SPA, а также может проксировать динамическое содержимое через Cloud Functions или Cloud Run. Если приложению нужен полноценный Next.js/Angular SSR или ISR, источник направляет к Firebase App Hosting, поэтому эту карточку не следует использовать как универсальную инструкцию для серверного рендеринга. Основная рабочая точка — firebase.json. Через конфигурацию описываются публичный каталог, правила rewrites и redirects, заголовки ответа и несколько hosting sites. Это позволяет связать URL приложения с нужным каталогом, перенаправлять старые адреса и направлять запросы к функциям или Cloud Run, не смешивая такие правила со случайной настройкой веб-сервера. Перед публикацией нужно проверить, какой каталог действительно содержит собранные файлы, какие маршруты должны обрабатываться клиентским роутером SPA, а какие — передаваться динамическому backend. Для безопасной проверки изменений навык выделяет preview channels. Они дают временный URL для просмотра версии до production-релиза; такой канал удобен для проверки redirects, rewrites, заголовков, пользовательского домена и поведения приложения после сборки. GitHub Actions можно использовать для автоматизации preview-публикаций. Локально конфигурацию разрешено проверять через Firebase Emulator Suite, ограничив запуск hosting-эмулятором; в стандартном примере сервис доступен на localhost:5000. Эмулятор проверяет локальное поведение, но не доказывает корректность DNS, TLS, CDN-кэша или production-домена. Практический сценарий начинается с описания типа приложения и границ размещения. Для SPA нужно согласовать fallback-маршруты с клиентским роутером; для микросервиса — явно определить rewrite к Cloud Functions или Cloud Run; для нескольких сайтов — разделить каталоги и цели публикации. После этого preview проверяется как отдельный релиз, а production deploy выполняется только с понятной конфигурацией. Навык также напоминает о встроенном SSL и глобальной CDN-доставке, но это свойства сервиса, а не гарантия быстрого ответа конкретного backend. Ограничения важны: материал не предназначен для Firebase App Hosting, Auth, Firestore rules, Data Connect или Crashlytics. Он не создаёт автоматически рабочий домен, не выбирает за команду структуру каталогов и не заменяет проверку Cloud Functions или Cloud Run. Для production нужно отдельно подтвердить rewrites, redirects, headers, домены, preview-релиз и фактические ответы после deploy; конфигурацию следует применять только к проекту, которому принадлежит команда.
Для чего подходит
- Публикация SPA на Firebase Hosting
- Настройка rewrites и redirects
- Проверка preview channels и домена
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/firebase/agent-skills/tree/main/skills/firebase-hosting-basics