Процесс сборки в App Hosting

Firebase App Hosting использует Cloud Build для преобразования исходного кода приложения в контейнеризированный формат, подходящий для развертывания в Cloud Run.

Процесс сборки состоит из следующих основных этапов:

  1. ubuntu: инициализация рабочей области.

  2. preparer – собирает исходный код и конфигурацию приложения;

  3. pre-buildpack – подготовка среды buildpack.

  4. build – устанавливает зависимости и создает приложение.

  5. publisher – завершает создание рабочего контейнера Cloud Run.

Эти пять шагов соответствуют шагам сборки, которые отображаются в Cloud Build в консоли Google Cloud:

Скриншот консоли Google Cloud с этапами Cloud Build

Инициализация рабочей области

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

Специалист по подготовке налоговой отчетности

На этом этапе обрабатывается логика предварительной сборки. Она считывает, очищает и записывает пользовательские переменные среды. Он также разыменовывает и закрепляет все секреты, указанные в файле apphosting.yaml.

Объекты Pre-buildpack

На этом этапе подготавливается среда для жизненного цикла Cloud Native Buildpacks. Для этого запускается прослойка, которая преобразует конфигурации и переменные среды, подготовленные на предыдущем этапе, в формат, ожидаемый инструментами CNB.

Сборка

Это основной этап процесса сборки, на котором создается образ контейнера, готовый к запуску, и файл bundle.yaml, определяющий конфигурацию сборки. Для эффективной упаковки приложения используются пакеты Cloud Native Buildpacks и двоичный файл lifecycle creator. Дополнительную информацию о файле bundle.yaml можно найти на сайте GitHub.

Пакеты сборки отвечают за преобразование исходного кода приложения в готовые к работе образы контейнеров. Firebase App Hosting объединяет несколько пакетов сборки, чтобы завершить процесс сборки:

  1. Пакет сборки среды выполнения. Обеспечивает включение всех необходимых компонентов для запуска базового приложения Node.js и установку зависимостей.
  2. Monorepo Buildpack настраивает последующие пакеты сборки для обработки различных сценариев монорепозитория.
  3. Framework Buildpack устанавливает нужный адаптер фреймворка (например, Angular или Next.js) и подготавливает последующие пакеты сборки.

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

  4. Package Manager Buildpack устанавливает зависимости и создает приложение с помощью npm, yarn или pnpm.

  5. Output Bundle Buildpack определяет команду запуска и подготавливает выходной пакет к выполнению.

Издатель

На этом заключительном этапе вся информация, извлеченная из исходного кода приложения, упаковывается вместе с образом контейнера сборки и отправляется в серверную часть App Hosting. Затем серверная часть App Hosting использует эту информацию для настройки Cloud Run с правильными конфигурациями.

Создать правило очистки

Firebase App Hosting применяет автоматизированные правила хранения и удаления сборок. В соответствии с этим правилом App Hosting сохраняет успешные сборки и связанные с ними версии Cloud Run за последние 14 дней. Кроме того, чтобы у вас всегда была сборка, к которой можно вернуться, App Hosting сохраняет пять последних успешных сборок и внедрений независимо от их возраста.

App Hosting не удалит сборку, которая сейчас используется в активном разделении трафика или связана с текущим выпуском.

Когда срок хранения старых сборок истекает, их внутренний статус меняется на EXPIRED. Вы не можете выполнить мгновенный откат до сборки EXPIRED, и возможность отката до таких сборок будет удалена из консоли Firebase. Вместо этого вам нужно будет создать новую сборку, нацеленную на тот же источник (фиксацию git, контейнер в Artifact Registry или сегмент Google Cloud Storage), и развернуть ее.

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

Подробнее

Весь процесс сборки App Hosting открыт.