Если у вас включено автоматическое развертывание, то каждый раз, когда вы отправляете новый коммит в активную ветку в репозитории GitHub, App Hosting автоматически развертывает новую версию приложения. Статус развертывания можно проверить в консоли Firebase или в проверке GitHub App Hosting.
Кроме того, App Hosting поддерживает развертывания, запускаемые вручную, для интеграции CI/CD или любого другого случая, когда вы хотите принудительно выполнить развертывание.
Посмотреть выпуски
В консоли Firebase можно найти подробную информацию обо всех выпусках приложения.
Перейдите в раздел Hosting & Serverless (Хостинг и бессерверная архитектура) > App Hosting (Хостинг приложений) и нажмите View (Посмотреть) рядом с нужным бэкендом. На вкладке Развертывания для серверной части показана таблица с историей всех развертываний для этой серверной части.
Каждая запись о развертывании содержит ссылки на задание Cloud Build и изменение или фиксацию, которые инициировали развертывание, а также основную информацию об авторе, дате создания и статусе развертывания.
- Задача Cloud Build – это среда сборки, в которой App Hosting выполняет команду сборки приложения. Чтобы посмотреть журналы Cloud Build, нажмите на идентификатор сборки.
- Изменение – это коммит GitHub или другое действие, которое запустило развертывание.
Как запустить выпуск вручную
Если вы хотите вручную запустить развертывание из источника GitHub, не отправляя новый коммит, вы можете создать развертывание в консоли Firebase или CLI Firebase. Это может быть полезно в следующих случаях:
- Принудительное повторное создание статического контента.
- Разрешение системе CI/CD запускать развертывания.
- Ограничение выпуска рабочих версий определенными датами или временем.
Чтобы запустить развертывание в консоли Firebase:
- В консоли Firebase перейдите в раздел Hosting & Serverless (Хостинг и бессерверная архитектура) > App Hosting (Хостинг приложений).
- Нажмите Просмотр для серверной части, для которой вы хотите создать развертывание.
- В сводке на панели управления выберите Создать выпуск.
- Выберите ветвь для развертывания.
- Выберите фиксацию для развертывания: последнюю или более раннюю, указав ее идентификатор.
- Нажмите Создать. Статус и номер сборки для выпуска отображаются в таблице истории выпусков. После завершения процесса внедрения оно будет отображаться как текущее.
Чтобы запустить развертывание в CLI Firebase, выполните следующую команду и выберите ветку для развертывания, когда появится запрос:
firebase apphosting:rollouts:create BACKEND_ID
Вы также можете запустить развертывание для последней фиксации в определенной ветке, используя параметр --git-branch:
firebase apphosting:rollouts:create BACKEND_ID
--git-branch BRANCH_NAME
Вы также можете создать развертывание с определенным коммитом, используя параметр --git-commit:
firebase apphosting:rollouts:create BACKEND_ID
--git-commit COMMIT_ID
Как восстановить предыдущую версию
В App Hosting есть два способа восстановить предыдущий выпуск:
- Мгновенный откат без пересборки
- Как пересобрать и откатить до предыдущей версии
Как создать мгновенный откат
Иногда может потребоваться быстро вернуться к более ранней версии приложения. Например, если вы обнаружили критическую ошибку в новой версии или у вас возникли проблемы со сборкой, которые мешают выпуску новых версий. В таких случаях вы можете восстановить существующий образ контейнера из предыдущего развертывания. Этот образ не перестраивается, а использует код и конфигурацию среды, которые были при его первой сборке.
Чтобы создать мгновенный откат:
- В консоли Firebase перейдите в раздел Hosting & Serverless (Хостинг и бессерверная архитектура) > App Hosting (Хостинг приложений).
- Нажмите Посмотреть для бэкенда, для которого нужно создать откат.
- Выберите вкладку Внедрения.
- В таблице История для бэкенда нажмите на значок меню в виде трех точек рядом с предыдущей сборкой.
- Выберите Откатить до этой сборки и подтвердите действие.
Перестройка и откат
Если вы хотите вернуться к более старой версии приложения, но сохранить текущую конфигурацию, вы можете пересобрать приложение в процессе отката. Например, если в последней версии вы обновили значение ключа API в файле Secret Manager, то после отката пересборка обеспечит использование нового ключа в приложении.
Чтобы пересобрать и откатить:
- В консоли Firebase перейдите в раздел Hosting & Serverless (Хостинг и бессерверная архитектура) > App Hosting (Хостинг приложений).
- Нажмите View dashboard (Посмотреть панель управления) для серверной части, для которой вы хотите создать откат.
- Выберите вкладку Внедрения.
- Выберите Создать выпуск.
- В диалоговом окне Create a rollout (Создание развертывания) выберите Earlier commit (Предыдущая фиксация) и введите идентификатор фиксации для версии, которую нужно пересобрать и к которой нужно выполнить откат. Идентификатор фиксации – это часть сведений об изменении для каждого развертывания, перечисленного в истории развертываний. Он указан в скобках в ярлыке.
- Чтобы начать откат, нажмите Создать.
Изменить настройки внедрения
Вы можете изменить активную ветку для развертываний, а также включить или отключить автоматические развертывания. Для этого используйте элементы управления в разделе Настройки > Развертывание на панели управления для бэкенда.
- В консоли Firebase перейдите в раздел Hosting & Serverless (Хостинг и бессерверная архитектура) > App Hosting (Хостинг приложений).
- Нажмите Посмотреть для серверной части, в которой вы хотите обновить настройки развертывания.
- На панели управления выберите Settings (Настройки). В представлении по умолчанию отображается информация о доменах и собственных доменах.
- Выберите представление Развертывание. Здесь можно изменить активную ветвь для внедрения, а также включить или отключить автоматическое внедрение. Также можно задать корневой каталог приложения и среду для бэкенда (см. раздел Развертывание в нескольких средах).
Как управлять автоматическим развертыванием
По умолчанию App Hosting считает, что список "обязательных" файлов включает все файлы. Это означает, что каждая новая фиксация в репозитории запускает новую сборку и развертывание. Однако, чтобы сэкономить время и избежать ненужных развертываний, вы можете настроить App Hosting так, чтобы пропускать сборки на основе определенных путей к файлам, измененных в коммите.
Это можно сделать в разделе Настройки > Развертывания > Триггеры развертывания. Поле Обязательные пути можно оставить пустым, если вы хотите, чтобы каждая новая фиксация в репозитории запускала новую сборку и развертывание. Также можно указать, какие именно каталоги или файлы должны всегда запускать развертывание. Если вы указываете каталоги, обязательно добавьте все пути, по которым изменения должны запускать развертывание.
Каталоги и файлы, добавленные в Игнорируемые пути, никогда не будут запускать автоматическое развертывание. Если подкаталог попадает в оба списка, автоматическое развертывание не запускается. Если вы заполните только список игнорируемых путей, App Hosting автоматически подставит "*" в список обязательных путей.
Если вы отправите коммит, в котором ни один из измененных файлов не соответствует требуемым путям (или если все изменения явно исключены игнорируемыми путями), App Hosting по-прежнему будет подтверждать получение события GitHub, но пометит состояния сборки и развертывания как SKIPPED, и автоматическое развертывание не будет запущено.