Administrar lanzamientos y versiones

Si tienes habilitados los lanzamientos automáticos, cada vez que envíes una confirmación nueva a la rama activa de 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 App Hosting de GitHub.

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

Consulta los lanzamientos

La consola de Firebase proporciona acceso a información detallada sobre todos los lanzamientos de tu app. En App Hosting, selecciona Ver para el backend cuyos lanzamientos quieras ver. En la pestaña Lanzamientos del backend, se muestra una tabla con el historial de todos los lanzamientos de este backend.

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

  • El trabajo Cloud Build es el entorno de compilación en el que App Hosting ejecuta el comando de compilación de tu app. Para acceder a los registros de Cloud Build, haz 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 manualmente 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
  • Permite que un sistema de CI/CD active lanzamientos.
  • Limitar los lanzamientos de producción a fechas u horas específicas

Para activar un lanzamiento en la consola de Firebase, haz lo siguiente:

  1. En App Hosting, selecciona Ver para el backend para el que deseas crear un lanzamiento.
  2. En el resumen del panel de backend, selecciona Crear lanzamiento.
  3. Selecciona la rama que se implementará.
  4. Selecciona la confirmación que deseas implementar, ya sea la más reciente o una anterior especificada por su ID de confirmación.
  5. Seleccione Crear. En la tabla de historial de lanzamientos, se muestran el estado y el número de compilación del lanzamiento. Cuando se completa el proceso de lanzamiento, este lanzamiento 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 una implementación 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

Cómo restablecer un lanzamiento anterior

App Hosting te ofrece dos opciones para restablecer una versión anterior:

  • Revierte los cambios al instante sin volver a compilar
  • Cómo volver a compilar y revertir a una versión anterior

Cómo crear una reversión instantánea

A veces, es posible que debas revertir rápidamente tu app a una versión anterior, por ejemplo, si descubriste un error crítico en un lanzamiento implementado recientemente o si tienes una compilación inestable que bloquea los lanzamientos nuevos. En esos casos, puedes restablecer una imagen de contenedor existente de tu elección desde una versión 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, haz lo siguiente:

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

Recompila y revierte

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

Para volver a compilar y revertir, haz lo siguiente:

  1. En App Hosting, selecciona Ver panel para el backend del que deseas crear una reversión.\
  2. Selecciona la pestaña Lanzamientos.
  3. Selecciona Crear lanzamiento.
  4. En el diálogo Crear un lanzamiento, marca Confirmación anterior y, luego, ingresa el ID de confirmación de la versión a la que deseas volver y restablecer. El ID de confirmación forma parte de los "Detalles del cambio" de cada lanzamiento que se muestra en tu Historial de lanzamientos y se incluye entre paréntesis en la etiqueta.
  5. Selecciona Crear para comenzar la reversión.

Cómo cambiar la configuración del lanzamiento

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

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