Administrar lanzamientos y versiones

Si tienes habilitados los lanzamientos automáticos, cada vez que envíes una confirmación nueva a la rama activa en tu repositorio de GitHub, App Hosting lanzará automáticamente una versión nueva de tu app. Puedes verificar el estado del lanzamiento en la consola de Firebase o en la verificación de GitHub de App Hosting.

Además, App Hosting admite lanzamientos activados de forma manual para la integración de CI/CD o cualquier otro caso en el que quieras forzar un lanzamiento.

Consulta los lanzamientos

La consola de Firebase proporciona acceso a información detallada sobre todos los lanzamientos de tu app.

Navega a Hosting y Serverless> App Hosting, luego, selecciona Ver para el backend cuyos lanzamientos quieras ver. En la pestaña Lanzamientos del backend, se muestra una tabla con un historial de todos los lanzamientos de este backend.

Cada entrada de lanzamiento contiene vínculos al trabajo de Cloud Build y al cambio o la confirmación que activó el lanzamiento, junto con información básica sobre el autor, la fecha de creación y el estado del lanzamiento.

  • El trabajo Cloud Build es el entorno de compilación en el que App Hosting ejecuta el comando de compilación de tu app. Puedes acceder a los registros de Cloud Build haciendo clic en el ID de compilación.
  • El Cambio es la confirmación de GitHub o cualquier otra acción que activó el lanzamiento.

Activa un lanzamiento de forma manual

Si deseas activar de forma manual un lanzamiento desde tu fuente de GitHub sin enviar una confirmación nueva, puedes crear un lanzamiento desde la consola de Firebase o la CLI de Firebase. Esto es útil en casos como los siguientes:

  • Forzar la regeneración del contenido estático
  • Permitir que un sistema de CI/CD active lanzamientos
  • Limitar los lanzamientos de producción a fechas o momentos específicos.

Para activar un lanzamiento en la consola de Firebase, sigue estos pasos:

  1. En la consola de Firebase, navega a Hosting y Serverless > App Hosting.
  2. Haz clic en Ver en el backend para el que quieras crear un lanzamiento.
  3. En el resumen del panel de backend, selecciona Crear lanzamiento.
  4. Selecciona la rama que quieres implementar.
  5. Selecciona la confirmación que deseas implementar, ya sea la más reciente o una anterior especificada por su ID de confirmación.
  6. Selecciona Crear. El estado y el número de compilación del lanzamiento se muestran en la tabla del historial de lanzamientos. Cuando se completa el proceso de lanzamiento, este se muestra como el lanzamiento actual.

Para activar un lanzamiento en la CLI de Firebase, ejecuta el siguiente comando y selecciona la rama para el lanzamiento cuando se te solicite:

firebase apphosting:rollouts:create BACKEND_ID

Como alternativa, puedes iniciar un lanzamiento para la confirmación más reciente de una rama específica con la opción --git-branch:

firebase apphosting:rollouts:create BACKEND_ID
--git-branch BRANCH_NAME

También puedes crear un lanzamiento con una confirmación específica usando la opción --git-commit:

firebase apphosting:rollouts:create BACKEND_ID
--git-commit COMMIT_ID

Restablece un lanzamiento anterior

App Hosting te ofrece dos opciones para restablecer un lanzamiento anterior:

  • Revierte al instante sin volver a compilar
  • Vuelve a compilar y revierte a una versión anterior

Crea una reversión instantánea

En ocasiones, es posible que debas revertir rápidamente a una versión anterior de tu app, por ejemplo, si descubriste un error crítico en un lanzamiento nuevo o si tienes una compilación inestable que bloquea los lanzamientos nuevos. En esos casos, puedes restablecer una imagen de contenedor existente que elijas de un lanzamiento anterior. Esta imagen no se vuelve a compilar, sino que usa el código y la configuración del entorno de cuando se compiló por primera vez.

Para crear una reversión instantánea, sigue estos pasos:

  1. En la consola de Firebase, navega a Hosting y Serverless > App Hosting.
  2. Haz clic en Ver en el backend para el que deseas crear una reversión.
  3. Selecciona la pestaña Lanzamientos.
  4. En la tabla Historial del backend, selecciona el menú de tres puntos para una compilación anterior.
  5. Selecciona Revertir a esta compilación y confirma.

Vuelve a compilar y revertir

Si quieres volver a una versión anterior de tu app, pero mantener la configuración actual, puedes volver a compilar la app como parte del proceso de reversión. Por ejemplo, si tu versión más reciente actualizó un valor de clave de API en Secret Manager, volver a compilar puede garantizar que se use la clave nueva en tu app después de la reversión.

Para volver a compilar y revertir, haz lo siguiente:

  1. En la consola de Firebase, navega a Hosting y Serverless > App Hosting.
  2. Haz clic en Ver panel para el backend para el que deseas crear una reversión.
  3. Selecciona la pestaña Lanzamientos.
  4. Selecciona Crear lanzamiento.
  5. En el cuadro de diálogo Crear un lanzamiento, selecciona Confirmación anterior y, luego, ingresa el ID de confirmación de la versión que deseas volver a compilar y revertir. El ID de confirmación forma parte de los "Detalles del cambio" de cada lanzamiento que aparece en tu Historial de lanzamientos, entre paréntesis en la etiqueta.
  6. Selecciona Crear para comenzar la reversión.

Cambiar la configuración del lanzamiento

Puedes cambiar la rama activa para los lanzamientos y, además, inhabilitar o habilitar los lanzamientos automáticos con los controles de la vista Configuración > Implementación en el panel de un backend.

  1. En la consola de Firebase, navega a Hosting y Serverless > App Hosting.
  2. Haz clic en Ver en el backend en el que deseas actualizar la configuración de lanzamiento.
  3. En el panel de backend, selecciona Configuración. La vista predeterminada muestra información sobre los dominios y los dominios personalizados.
  4. Selecciona la vista Implementación. En esta vista, puedes cambiar la rama activa para los lanzamientos, y habilitar o inhabilitar los lanzamientos automáticos. Además, hay opciones para configurar el directorio raíz de la app y el entorno del backend (consulta Implementa en varios entornos).

Administra los lanzamientos automáticos

De forma predeterminada, App Hosting asume una lista "obligatoria" de todos los archivos, lo que significa que cada confirmación nueva en tu repositorio activa una compilación y un lanzamiento nuevos. Sin embargo, para ahorrar tiempo y evitar implementaciones innecesarias, puedes configurar App Hosting para omitir compilaciones según las rutas de acceso de archivos específicas modificadas en una confirmación.

Puedes configurar esto en Configuración > Lanzamientos > Activadores de lanzamiento. Aquí, puedes dejar en blanco las Rutas de acceso obligatorias si quieres que cada confirmación nueva en tu repositorio active una compilación y un lanzamiento nuevos, o puedes especificar exactamente qué directorios o archivos deben activar siempre un lanzamiento. Si especificas directorios, asegúrate de agregar todas las rutas de acceso en las que los cambios deberían activar un lanzamiento.

Los directorios o archivos que agregues a Rutas de acceso ignoradas nunca activarán un lanzamiento automático. En los casos en que un subdirectorio se encuentre en las listas obligatorias y las de elementos ignorados, no se activará un lanzamiento automático. Si solo completas la lista de rutas de acceso ignoradas, App Hosting completará automáticamente "*" para las rutas de acceso obligatorias.

Captura de pantalla de la IU que se describe en esta página.

Si envías una confirmación en la que ninguno de los archivos modificados coincide con las rutas de acceso requeridas (o si todos los cambios se excluyen de forma explícita por las rutas de acceso ignoradas), App Hosting seguirá confirmando la recepción del evento de GitHub, pero marcará los estados de compilación y lanzamiento como SKIPPED, y no se activará ningún lanzamiento automático.