Как опубликовать приложение с помощью Firebase Studio

Firebase Studio предлагает несколько вариантов публикации, позволяя вам выбрать тот, который лучше всего подходит для вашего проекта. Вот обзор доступных вариантов:

  • Firebase App Hosting : Ideal for publishing dynamic Next.js and Angular applications, App Hosting offers built-in framework support, GitHub integration, and integration with other Firebase products like Firebase Authentication , Cloud Firestore , and Firebase AI Logic .

    Если вы разработали приложение Next.js с помощью App Prototyping agent , вы можете опубликовать его непосредственно из Firebase Studio всего за несколько щелчков мыши.

  • Firebase Hosting : отлично подходит для размещения веб-приложений и статического веб-контента (HTML, CSS, JavaScript, изображений и других статических ресурсов), а также одностраничных приложений. Firebase Hosting обеспечивает быструю доставку контента через глобальную сеть CDN, бесплатные SSL-сертификаты и поддержку настраиваемых доменов.

    Если вы разработали статическое или одностраничное веб-приложение в Firebase Studio , вы можете опубликовать его непосредственно из Firebase Studio , предложив Gemini в Firebase опубликовать ваше приложение.

  • Cloud Run : используйте Cloud Run для развертывания контейнерных приложений. Это хороший выбор для публикации масштабируемых и переносимых приложений, которые могут работать на любой платформе.

  • Другие варианты развертывания: развертывание на выбранном вами хостинговом решении, включая другие платформы или ваш собственный сервер.

Публикуйте и отслеживайте свое приложение с помощью Firebase App Hosting

После того как вы протестировали свое приложение и остались довольны его работой в рабочей области, вы можете опубликовать его в Интернете с помощью Firebase App Hosting .

When you set up App Hosting , Firebase Studio creates a Firebase project for you (if one was not already created by auto-generating a Gemini API key or other backend services) and guides you through linking a Cloud Billing account.

Чтобы опубликовать ваше приложение:

  1. Нажмите «Опубликовать» , чтобы настроить проект Firebase и опубликовать приложение. Откроется панель «Опубликовать приложение» .

  2. In the Firebase project step, the App Prototyping agent displays the Firebase project associated with the workspace. If a Firebase project doesn't already exist, the App Prototyping agent creates a new project for you. Click Next to proceed.

  3. На этапе «Привязать учетную запись Cloud Billing выберите один из следующих вариантов:

    • Выберите учетную запись Cloud Billing , которую вы хотите связать с вашим проектом Firebase.

    • If you don't have a Cloud Billing account or want to create a new one, click Create a Cloud Billing account . This opens the Google Cloud console, where you can create a new self-serve Cloud Billing account . After you create the account, return to Firebase Studio and select the account from the Link Cloud Billing list.

  4. Нажмите кнопку «Далее» . Firebase Studio связывает платежный аккаунт с проектом, связанным с вашим рабочим пространством, созданным либо при автоматической генерации ключа API Gemini , либо при нажатии кнопки «Опубликовать» .

  5. Нажмите «Настроить службы» . Агент прототипирования приложений начнет подготовку служб Firebase.

  6. Нажмите «Опубликовать сейчас» . Firebase Studio настроит службы Firebase, а затем запустит развертывание App Hosting . Это может занять несколько минут. Чтобы узнать больше о том, что происходит за кулисами, см. статью «Процесс сборки App Hosting .

  7. When the publish step completes, the App overview appears with a URL and app insights powered by App Hosting observability. To use a custom domain (like example.com or app.example.com) instead of the Firebase-generated domain, you can add a custom domain in the Firebase console.

Дополнительную информацию о App Hosting см. в разделе Понимание App Hosting и принципов его работы .

(Только Cloud Firestore ) Добавьте индексы и проверьте правила безопасности в рабочей среде.

После завершения публикации и развертывания вашего приложения в Firebase Cloud Firestore и Firebase Authentication готовы к тестированию в рабочей среде.

Создайте индексы для вашей базы данных Cloud Firestore

При развертывании приложения в Cloud Firestore индексы не генерируются автоматически. Это означает, что после публикации вам может потребоваться сгенерировать индексы для ваших запросов.

Вы можете увидеть это в сообщениях об ошибках или в консоли разработчика вашего браузера.

Для создания индексов после публикации:

  1. Из опубликованного приложения: на панели обзора приложения (нажмите «Опубликовать» , если она не отображается) найдите и нажмите ссылку «Посетить ваше приложение» .

    Из предварительной версии Firebase Studio : откройте консоль разработчика браузера и найдите сообщение об ошибке 200, которое генерирует Cloud Firestore .

  2. Протестируйте все процессы в вашем приложении. Может возникнуть ошибка вроде: «Ошибка загрузки рецептов. Запрос требует индекса. Вы можете создать его здесь» со ссылкой на консоль Firebase .

  3. Перейдите по ссылке, чтобы перейти в консоль Firebase , и появится рекомендуемый индекс.

  4. Нажмите «Сохранить» , чтобы принять рекомендуемый индекс.

  5. Вернитесь в приложение и перезагрузите страницу.

  6. Продолжайте тестировать все потоки в вашем приложении, чтобы добавить индексы при необходимости.

Дополнительную информацию см. в статье Управление индексами в Cloud Firestore .

Просмотр данных аутентификации Cloud Firestore и Firebase Authentication в консоли Firebase

После публикации вы можете просматривать оперативные данные из вашего приложения в консоли Firebase .

  • Чтобы просмотреть работающую базу данных Cloud Firestore , откройте консоль Firebase и выберите «Создать» > «База данных Firestore» в навигационном меню.

    Здесь вы можете проверять сохранённые данные, просматривать и тестировать правила безопасности, а также создавать индексы. Подробнее на сайте Cloud Firestore .

  • Чтобы просмотреть текущие данные Firebase Authentication , откройте консоль Firebase и выберите в меню навигации «Сборка» > «Аутентификация» .

    Здесь вы можете проверить конфигурацию аутентификации и пользователей приложения. Подробнее см. в статье Firebase Authentication .

Тестирование правил Cloud Firestore в производственной среде

После публикации приложения следует повторно протестировать правила безопасности Cloud Firestore в вашей производственной среде. Это поможет гарантировать доступность данных для авторизованных пользователей и защиту от несанкционированного доступа.

Вы можете протестировать свои правила, используя все следующие методы:

  • Application Testing : Interact with your deployed application, performing operations that trigger various data access patterns (reads, writes, deletes) for different user roles or states. This real-world testing helps confirm that your rules are correctly enforced in practice.

  • Площадка для правил : для целевых проверок используйте площадку для правил в консоли Firebase . Этот инструмент позволяет моделировать запросы (чтение, запись, удаление) к базе данных Cloud Firestore используя ваши производственные правила. Вы можете указать состояние аутентификации пользователя, путь к данным и тип операции, чтобы проверить, разрешают ли ваши правила доступ или запрещают его, как задумано.

  • Модульное тестирование : для более полного тестирования вы можете написать модульные тесты для правил безопасности . Предварительная версия Firebase Studio на базе Firebase Local Emulator Suite позволяет запускать эти тесты локально, имитируя поведение ваших производственных правил. Это надёжный способ проверки сложной логики правил и подтверждения покрытия для различных сценариев. После развёртывания следует ещё раз проверить, что ваши модульные тесты с помощью эмулятора работают должным образом и охватывают все сценарии.

Контролируйте свое приложение с помощью функции наблюдения App Hosting

Панель обзора приложения в Firebase Studio предоставляет ключевые показатели и информацию о вашем приложении, позволяя отслеживать производительность веб-приложения с помощью встроенных инструментов наблюдения App Hosting . После запуска сайта вы сможете получить доступ к обзору, нажав кнопку «Опубликовать» . На этой панели вы можете:

  • Нажмите «Опубликовать» , чтобы выпустить новую версию вашего приложения.
  • Поделитесь ссылкой на свое приложение или откройте его напрямую в разделе «Посетите свое приложение» .
  • Review a summary of your app's performance over the last 7 days, including the total number of requests and the status of your latest rollout. Click View details to access even more information in the Firebase console .
  • Просмотрите график количества запросов, полученных вашим приложением за последние 24 часа, с разбивкой по кодам статуса HTTP.
  • Просмотрите статус активации служб Firebase, таких как Firebase Authentication и Cloud Firestore .

Если вы закроете панель обзора приложения, вы сможете снова открыть ее в любое время, нажав кнопку «Опубликовать» .

Дополнительную информацию об управлении и мониторинге развертываний App Hosting можно найти в разделе Управление развертываниями и выпусками .

Откатите свой сайт App Hosting

Если вы развернули несколько версий своего приложения на App Hosting , вы можете откатить его к одной из более ранних версий. Вы также можете удалить его.

  • Чтобы откатить опубликованный сайт:

    1. Откройте App Hosting в консоли Firebase .

    2. Найдите бэкэнд вашего приложения, нажмите «Просмотр» , а затем нажмите «Развертывания» .

    3. Рядом с развертыванием, к которому вы хотите вернуться, нажмите More , затем выберите Откатиться к этой сборке и подтвердите.

    Дополнительную информацию можно найти в разделе Управление развертываниями и выпусками .

  • Чтобы удалить домен вашего App Hosting из Интернета:

    1. В консоли Firebase откройте App Hosting и нажмите View в разделе приложения Firebase Studio .

    2. В разделе «Информация о внутреннем сервере» нажмите «Управление» . Загрузится страница «Домены» .

    3. Рядом с вашим доменом нажмите More , затем выберите Disable domain и подтвердите.

    Это удалит ваш домен из интернета. Чтобы полностью удалить бэкенд App Hosting , следуйте инструкциям в разделе Удаление бэкенда .

Firebase Hosting

Вы можете публиковать статические и одностраничные веб-приложения на Firebase Hosting из своего рабочего пространства Firebase Studio .

Если у вас нет необходимых разрешений для проекта Firebase, попросите владельца проекта Firebase назначить вам соответствующую роль на странице «Пользователи и разрешения» консоли Firebase . Если у вас есть вопросы о доступе к проекту Firebase, включая поиск и назначение владельца, см. раздел «Разрешения и доступ к проектам Firebase» .

Публикация с помощью Gemini в Firebase

  1. В чате Gemini в Firebase введите запрос, например «Опубликовать мое приложение».

  2. Gemini в Firebase проведет вас через все необходимые этапы. Это может включать в себя создание проекта Firebase и регистрацию приложения, если вы ещё этого не сделали.

Публикация из панели Firebase Studio

Firebase Hosting оптимизирован для статических сайтов и одностраничных приложений. Если ваш проект содержит динамический контент, Gemini в Firebase может не инициировать процесс публикации. Если это произошло, но вы всё равно хотите использовать Firebase Hosting , опубликуйте свой проект из панели Firebase Studio :

  1. Если вы еще этого не сделали, создайте проект Firebase и зарегистрируйте свое приложение .

  2. Откройте рабочее пространство Firebase Studio .

    • Если вы используете App Prototyping agent , нажмите Значок переключения кода Переключитесь в режим Код , чтобы открыть представление Code .
  3. На панели навигации щелкните значок Firebase Studio , чтобы открыть панель, затем разверните раздел Firebase Hosting .

  4. Нажмите «Аутентифицировать Firebase» и следуйте инструкциям в окне терминала, чтобы аутентифицировать свою учетную запись Firebase.

  5. Нажмите «Инициализировать Firebase Hosting и следуйте инструкциям в окне терминала, чтобы настроить конфигурацию развертывания.

  6. Чтобы развернуть приложение, нажмите «Развернуть в производство» или «Развернуть в канал» в разделе Firebase Hosting на панели Firebase Studio .

Cloud Run

Перед развертыванием с помощью Cloud Run обязательно настройте проект Google Cloud и включите Cloud Billing .

  1. Откройте рабочее пространство Firebase Studio . Если вы используете App Prototyping agent , нажмите Значок переключения кода Переключитесь в режим Код , чтобы открыть представление Code .

  2. Щелкните значок Firebase Studio на панели навигации, чтобы открыть панель Firebase Studio , и щелкните Deploy to Cloud Run .

  3. Выберите Разрешить этому рабочему пространству доступ к ресурсам Google Cloud с помощью моей учетной записи Google , а затем выберите в диалоговых окнах проект Google Cloud с включенной оплатой.

  4. Нажмите «Аутентификация» в разделе Cloud Run на панели Firebase Studio и следуйте инструкциям по аутентификации.

  5. Нажмите «Развернуть» и следуйте инструкциям, чтобы настроить конфигурацию развертывания и развернуть приложение.

Следующие шаги