Тестируйте веб-приложение локально, делитесь изменениями с другими пользователями и развертывайте его.

Прежде чем развертывать изменения на сайте, их нужно проверить. Firebase Hosting позволяет просматривать и тестировать изменения локально, а также взаимодействовать с эмулированными ресурсами проекта. Если вам нужно, чтобы ваши коллеги могли просматривать и тестировать изменения, Hosting может создавать временные URL для предварительного просмотра вашего сайта, которыми можно делиться. Мы даже поддерживаем интеграцию с GitHub для развертывания из pull-запроса.

Подготовка

Выполните действия, перечисленные на странице Начало работы с Hosting, в частности следующие:

  1. Установите или обновите интерфейс командной строки Firebase до последней версии.
  2. Подключите локальный каталог проекта (содержащий контент вашего приложения) к проекту Firebase.

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

Шаг 1. Протестируйте локально

Если вы быстро вносите изменения или хотите, чтобы ваше приложение взаимодействовало с эмулированными ресурсами проекта бэкенда, вы можете протестировать контент и конфигурацию Hosting локально. При локальном тестировании Firebase размещает ваше веб-приложение по локальному URL.

Hosting входит в состав Firebase Local Emulator Suite, который позволяет приложению взаимодействовать с эмулированным контентом и конфигурацией Hosting, а также с эмулированными ресурсами проекта (функциями, базами данных и правилами).

  1. Необязательно. По умолчанию локально размещенное приложение будет взаимодействовать с реальными, а не эмулированными ресурсами проекта (функциями, базой данных, правилами и т. д.). Вместо этого вы можете подключить приложение к любым настроенным эмулированным ресурсам проекта. Подробнее: Realtime Database | Cloud Firestore | Cloud Functions

  2. В корневом каталоге локального проекта выполните следующую команду:

    firebase emulators:start
  3. Откройте веб-приложение по локальному URL, возвращенному CLI (обычно это http://localhost:5000).

  4. Чтобы обновить локальный URL, обновите страницу в браузере.

Тестируйте продукт на популярных в регионе устройствах

По умолчанию эмуляторы отвечают только на запросы от localhost. Это означает, что вы сможете получить доступ к размещенному контенту из браузера на компьютере, но не с других устройств в сети. Если вы хотите провести тестирование на других локальных устройствах, настройте firebase.json следующим образом:

"emulators": {
    // ...

    "hosting": {
      "port": 5000,
      "host": "0.0.0.0"
    }
  }

Шаг 2. Посмотрите, что получилось, и поделитесь видео

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

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

Обратите внимание, что URL предварительного просмотра являются общедоступными, хотя их сложно угадать, поскольку они содержат случайный хеш. Это значит, что любой пользователь, у которого есть URL, может получить доступ к файлу.

  1. В корневом каталоге локального проекта выполните следующую команду:

    firebase hosting:channel:deploy CHANNEL_ID

    Замените CHANNEL_ID строкой без пробелов (например, feature_mission-2-mars). Этот идентификатор будет использоваться для создания URL предварительного просмотра, связанного с каналом предварительного просмотра.

  2. Откройте веб-приложение по URL предварительного просмотра, который возвращает CLI. Она будет выглядеть примерно так: PROJECT_ID--CHANNEL_ID-RANDOM_HASH.web.app

  3. Чтобы обновить URL предварительного просмотра, выполните ту же команду ещё раз. Убедитесь, что в команде указан тот же CHANNEL_ID.

Подробнее об управлении каналами предварительных версий, в том числе о том, как задать срок действия канала…

Firebase Hosting поддерживает GitHub Action, который автоматически создает и обновляет URL предварительного просмотра, когда вы фиксируете изменения в pull-запросе. Подробнее о том, как настроить и использовать это действие GitHub…

Шаг 3. Развертывание

Когда вы будете готовы поделиться изменениями с миром, разверните контент и конфигурацию Hosting на активном канале. Firebase предлагает несколько вариантов для этого шага в зависимости от вашего сценария использования (см. варианты ниже).

Вариант 1. Клонирование из канала предварительного просмотра в канал прямой трансляции

Этот вариант позволяет быть уверенным, что вы развертываете на своем канале именно тот контент и конфигурацию, которые вы протестировали на канале предварительного просмотра. Подробнее о клонировании версий…

  1. Выполните следующую команду в любом каталоге:

    firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:live

    Замените каждый плейсхолдер следующим образом:

    • SOURCE_SITE_ID и TARGET_SITE_ID – идентификаторы сайтов Hosting, на которых размещены каналы.

      • Для сайта Hosting по умолчанию используйте идентификатор проекта Firebase.
      • Вы можете указать сайты, которые находятся в одном или разных проектах Firebase.
    • SOURCE_CHANNEL_ID – идентификатор канала, на котором сейчас размещена версия, которую вы хотите развернуть на рабочем канале.

      • Для прямого канала используйте live в качестве идентификатора канала.
  2. Посмотрите внесенные изменения (следующий шаг).

Вариант 2. Развертывание из локального каталога проекта в активный канал

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

  1. В корневом каталоге локального проекта выполните следующую команду:

    firebase deploy --only hosting
  2. Посмотрите внесенные изменения (следующий шаг).

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

Шаг 4. Проверьте изменения на сайте

Оба варианта выше развертывают контент и конфигурацию Hosting на следующих сайтах:

  • Субдомены, предоставленные Firebase для вашего сайта Hosting по умолчанию и любых дополнительных сайтов Hosting:
    SITE_ID.web.app (например, PROJECT_ID.web.app)
    SITE_ID.firebaseapp.com (например, PROJECT_ID.firebaseapp.com)

  • Все собственные домены, которые вы подключили к сайтам Hosting.

Чтобы ограничить развертывание определенным сайтом Hosting, укажите цель развертывания в команде CLI.

Другие действия и информация, связанные с развертыванием

Добавьте комментарий к развертыванию.

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

firebase deploy --only hosting -m "Deploying the best new feature ever."

Добавление скриптовых задач до и после развертывания

Вы можете подключить сценарии командной строки к команде firebase deploy, чтобы выполнять задачи до или после развертывания. Например, хук postdeploy может уведомлять администраторов о развертывании нового контента сайта. Подробную информацию можно найти в документации по CLI Firebase.

Кеширование развернутого контента

Когда поступает запрос на статический контент, Firebase Hosting автоматически кеширует его в CDN. При повторном развертывании контента сайта Firebase автоматически очищает весь кешированный статический контент в CDN, чтобы новые запросы получали новый контент.

Обратите внимание, что вы можете настроить кеширование динамического контента.

Передача по протоколу HTTPS

Убедитесь, что все внешние ресурсы, которые не размещены на Firebase Hosting, загружаются по протоколу SSL (HTTPS), включая внешние скрипты. Большинство браузеров не позволяют пользователям загружать смешанный контент (трафик SSL и не-SSL).

Удаление файлов

В Firebase Hosting основной способ удалить выбранные файлы с развернутого сайта – удалить их локально, а затем повторно развернуть сайт.

Дальнейшие действия