Si tienes habilitados los lanzamientos automáticos, cada vez que envías una confirmación nueva a la rama activa de tu repositorio de GitHub, App Hosting lanza automáticamente una versión nueva de tu app. Puedes verificar el estado del lanzamiento en la Firebase consola 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 desees forzar un lanzamiento.
Cómo ver los lanzamientos
La consola Firebase proporciona acceso a información detallada sobre todos los lanzamientos de tu app.
Navega a Hosting & Serverless> App Hosting y, luego, selecciona Ver para el backend cuyos lanzamientos deseas 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 de 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.
Cómo activar un lanzamiento de forma manual
Si deseas activar un lanzamiento de forma manual desde tu fuente de GitHub sin enviar una confirmación nueva, puedes crear un lanzamiento desde la Firebase consola o la Firebase CLI. Esto es útil en casos como los siguientes:
- Forzar la regeneración de contenido estático
- Permitir que un sistema de CI/CD active lanzamientos
- Limitar los lanzamientos de producción a fechas o horas específicas
Para activar un lanzamiento en la Firebase console, haz lo siguiente:
- En la Firebase console, navega a Hosting & Serverless > App Hosting.
- Haz clic en Ver para el backend para el que deseas crear un lanzamiento.
- En el resumen del panel del backend, selecciona Crear lanzamiento.
- Selecciona la rama que deseas implementar.
- Selecciona la confirmación que deseas implementar, ya sea la más reciente o una anterior especificada por su ID de confirmación.
- Selecciona Crear. El estado y un número de compilación para el lanzamiento se muestran en la tabla del historial de lanzamientos. Cuando se completa el proceso de lanzamiento, este lanzamiento se muestra como el lanzamiento actual.
Para activar un lanzamiento en la Firebase CLI, 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 con 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 un lanzamiento anterior:
- Revertir al instante sin volver a compilar
- 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 a una versión anterior de tu app, por ejemplo, si descubriste un error crítico en un lanzamiento recién implementado 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 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, haz lo siguiente:
- En la Firebase console, navega a Hosting & Serverless > App Hosting.
- Haz clic en Ver para el backend para el que deseas crear una reversión.
- Selecciona la pestaña Lanzamientos.
- En la tabla Historial del backend, selecciona el menú de tres puntos para una compilación anterior.
- Selecciona Revertir a esta compilación y confirma.
Cómo volver a compilar y revertir
Si deseas revertir 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, la recompilación 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:
- En la Firebase console, navega a Hosting & Serverless > App Hosting.
- Haz clic en Ver panel para el backend para el que deseas crear una reversión.
- Selecciona la pestaña Lanzamientos.
- Selecciona Crear lanzamiento.
- En el diálogo Crear un lanzamiento , selecciona Confirmación anterior y, luego, ingresa el ID de confirmación de la versión a la 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,que se encuentra entre paréntesis en la etiqueta.
- Selecciona Crear para iniciar la reversión.
Cómo cambiar la configuración de 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.
- En la Firebase console, navega a Hosting & Serverless > App Hosting.
- Haz clic en Ver para el backend en el que deseas actualizar la configuración de lanzamiento.
- En el panel del backend, selecciona Configuración. En la vista predeterminada, se muestra información sobre dominios y dominios personalizados.
- 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 para el backend (consulta Cómo realizar implementaciones en varios entornos).