Comprende el hosting de apps y cómo funciona

App Hosting controla una serie compleja de tareas en segundo plano para simplificar la implementación de tu app. En esta página, se describen las partes clave de ese flujo de tareas y se proporciona información sobre los puntos en los que quizás quieras personalizar el flujo según las necesidades de tu app.

Nota: App Hosting es una versión preliminar. Esto significa que Hosting de apps está sujeto a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Compatibilidad con el framework

App Hosting proporciona asistencia de compilación e implementación sin configuración para apps web desarrolladas en estos marcos de trabajo:

• Next.js 13 y versiones posteriores
• Angular 17.2 y versiones posteriores

App Hosting identifica qué framework estás usando mediante la inspección del archivo package-lock.json o algún otro archivo de bloqueo en tu repositorio. Si intentas implementar una app de Node.js al que le falta un archivo de bloqueo, App Hosting no podrá compilar ni ejecutar tu app. Para crear package-lock.json, ejecuta npm install en tu directorio raíz.

Los adaptadores de framework de App Hosting tienen dos funciones clave:

1. Analizan tu código fuente y cualquier archivo de configuración específico del framework (como next.config.js) para comprender el comportamiento configurado de tu app.
2. Ejecutan el comando de compilación de la app para generar elementos estáticos y crear una versión optimizada de la app para producción.

Los adaptadores de framework compilan tu app de Node.js con npm run build y funcionan mejor con las secuencias de comandos de compilación predeterminadas para cada framework: next build para Next.js y ng build para Angular. App Hosting intentará compilar compilaciones con comandos de compilación personalizados, pero no puede garantizar el éxito de manera confiable.

Cómo funciona la integración del repositorio de App Hosting

Developer Connect, la plataforma de conectividad de Google Cloud para herramientas externas de DevOps, controla la conexión importante entre tu repositorio de GitHub y el backend de App Hosting. Durante la creación de un backend de App Hosting, el flujo de trabajo de la IU de Developer Connect te guía en la instalación de la app de GitHub de Firebase. Los pasos clave en este proceso son los siguientes:

1. Le otorgas a Developer Connect la función Administrador de Secret Manager. Esto permite que el sistema almacene credenciales de forma segura como “Secrets” en Cloud Secret Manager.
2. Debes autorizar a la app de GitHub de Firebase para que acceda a tu repositorio de GitHub.
3. Developer Connect almacena un token de autorización de GitHub dedicado en el repositorio de Secret Manager de tu proyecto. No modifiques ni borres este token.

Además, App Hosting se integra en la API de verificaciones de GitHub para proporcionar una verificación de los lanzamientos. Esta verificación te permite ver el estado del lanzamiento en GitHub y depurar el proceso de implementación en caso de que haya algún error.

Integración en Firebase y otros servicios de Google

App Hosting configura los entornos de compilación y de ejecución para que puedas inicializar el SDK de Firebase Admin con las credenciales predeterminadas de la aplicación de Google. De esa manera, tu backend puede comunicarse con otros productos de Firebase durante la compilación y la implementación.

La cuenta de servicio de backend de App Hosting

Durante la compilación y en el entorno de ejecución, el backend de Hosting de apps se autentica con otros servicios de Google con una cuenta de servicio. Para estos fines, se crea una cuenta de servicio predeterminada la primera vez que habilitas App Hosting en un proyecto de Firebase:

firebase-app-hosting-compute@PROJECT ID.iam.gserviceaccount.com

Esta cuenta de servicio se aplica a todos los backends de forma predeterminada y tiene un conjunto mínimo de permisos que te permiten compilar, ejecutar y supervisar tu app. También tiene permiso para autenticar el SDK de Admin con credenciales predeterminadas de la aplicación para realizar operaciones como cargar datos desde Cloud Firestore. Consulta los roles de Firebase App Hosting.

Si la app necesita interactuar con servicios adicionales de Google en el tiempo de compilación o desde un backend en ejecución, puedes agregar funciones para personalizar la cuenta de servicio predeterminada. Por ejemplo, si tu app requiere permisos para Vertex AI, es posible que debas agregar roles/aiplatform.user o algún rol relacionado.

Términos y definiciones clave

• Backend: Es la colección de recursos administrados que App Hosting crea para compilar y ejecutar la app web.
• Lanzamiento: Una versión específica de tu app activa, vinculada a una confirmación de Git.
• Rama activa: Es la rama de tu repositorio de GitHub que se implementa en tu URL publicada. A menudo, es la rama en la que se combinan las ramas de características o de desarrollo.

Problemas conocidos y limitaciones

La versión preliminar de Hosting de apps tiene algunas limitaciones conocidas:

• La optimización de imágenes aún no está disponible.
• En algunos casos, el backend de Hosting de apps puede mostrar mensajes de Intermittent connection error en la URL de tu app. Habrá una solución disponible en una versión posterior.
• Los encabezados de caché se modifican para limitar las cachés de CDN a 60 s. En el futuro, cuando App Hosting pueda borrar definitivamente la caché con rapidez durante la implementación, se levantará este límite.
• Los archivos estáticos no almacenados en caché se entregan desde Cloud Run. En una versión posterior, se almacenarán y se entregarán desde el origen de App Hosting para obtener un mejor rendimiento.
• Los subdominios de comodines como dominios personalizados estarán disponibles en una versión posterior.
• Es posible que los SKU de App Hosting no aparezcan en la página de uso del backend de Firebase console. Estarán disponibles en una versión posterior.
• Es posible que Firebase console muestre de forma intermitente el error “No se encontró la compilación y no es válida” durante la creación del backend.
• Por el momento, no se admiten los proyectos con archivos package.json anidados, independientemente de si root\_directory se configuró con Firebase console o la CLI. Habrá una solución disponible en una versión posterior.
• Actualmente, todos los backends en el mismo proyecto comparten una organización o cuenta de GitHub. Pueden conectarse a diferentes repositorios dentro de esa organización o cuenta. Para crear backends que estén conectados a diferentes cuentas de GitHub, colócalos en proyectos separados.
• Por el momento, solo se admite la región us-central1.