Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Administre canales, lanzamientos y versiones en vivo y de vista previa para su sitio

Firebase Hosting proporciona herramientas a través de la consola de Firebase y la CLI de Firebase para administrar los canales, lanzamientos y versiones de su sitio de Hosting.

Descripción general de la infraestructura de alojamiento

Comprender la infraestructura de alojamiento le ayuda a comprender las opciones de administración que se describen en esta página.

Cada proyecto de Firebase tiene un sitio de alojamiento predeterminado con acceso a todos los recursos del proyecto (bases de datos, autenticación, funciones, etc.). Un sitio contiene uno o más canales , donde cada canal está asociado con una URL que ofrece contenido específico y una configuración de alojamiento.

una imagen de la jerarquía de Firebase Hosting

Cada sitio de alojamiento tiene un canal "en vivo" que ofrece contenido y una configuración de alojamiento en (1) los subdominios provistos por Firebase del sitio ( SITE_ID .web.app y SITE_ID .firebaseapp.com ) y (2) cualquier dominio personalizado conectado. Opcionalmente, también puede crear canales de "vista previa" que ofrezcan su propio contenido y configuración en "URL de vista previa" temporales y compartibles ( SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app ).

El contenido y la configuración que ofrece cada canal se empaquetan en un objeto de versión que tiene un identificador único. Cuando implementas en tu sitio, Firebase crea un objeto de lanzamiento que apunta a una versión específica. Una versión contiene metadatos sobre la implementación, como quién implementó y cuándo lo hizo.

Desde el panel de Hosting de tu proyecto de Firebase, puedes ver un historial completo de los lanzamientos de tu canal en vivo en una tabla del historial de lanzamientos . Si tiene varios sitios de alojamiento , haga clic en Ver en el sitio deseado para ver su historial de versiones. Si tiene canales de vista previa, también se muestran en el panel de Hosting.

Administrar la configuración de un canal

Para cada canal de su sitio, puede controlar su configuración. Algunas configuraciones, como la caducidad del canal, solo se aplican a los canales de vista previa.

Limite la cantidad de lanzamientos para mantener

Cada vez que implementas en un canal (y creas una versión), Hosting mantiene la versión asociada con la versión anterior en el almacenamiento de Hosting de tu proyecto. Puede establecer la cantidad de lanzamientos que desea conservar para cada canal de su proyecto, tanto en vivo como en vista previa.

  • ¿Por qué Hosting mantiene versiones anteriores?
    Para su canal en vivo, mantener las versiones anteriores le permite volver a una versión anterior de su sitio, si es necesario. Para sus canales de vista previa, la reversión aún no está disponible.

  • ¿Por qué limitar el número de lanzamientos a conservar?
    Esta función puede ayudarlo a controlar el nivel de uso del almacenamiento de alojamiento de su proyecto , ya que el contenido de las versiones anteriores se mantiene en este almacenamiento. Puede monitorear su almacenamiento de Hosting desde la pestaña Almacenamiento en la consola.

  • ¿Qué pasa cuando limitas las liberaciones para mantener?
    Cuando establece un límite para mantener las publicaciones, se programa la eliminación del contenido de las publicaciones que superen el límite establecido, comenzando por las publicaciones más antiguas .

A continuación, se explica cómo establecer el límite de almacenamiento de versiones para un canal:

  1. En Firebase console , accede al cuadro de diálogo de configuración de almacenamiento de la versión:

    • Para tu canal en vivo
      En la tabla Historial de versiones de su sitio, haga clic en y luego seleccione Liberar configuración de almacenamiento .

    • Para cualquier canal de vista previa
      En la fila del canal de vista previa, haga clic en y luego seleccione Configuración del canal .

  2. Ingresa la cantidad de lanzamientos que te gustaría conservar y luego haz clic en Guardar .

Establecer la expiración de un canal de vista previa

De forma predeterminada, un canal de vista previa caduca a los 7 días de su fecha de creación, pero el canal en vivo de su sitio nunca caducará.

Cuando un canal de vista previa caduca, el canal, junto con sus lanzamientos y versiones asociadas, está programado para su eliminación dentro de las 24 horas. La URL de vista previa asociada también está desactivada. Una excepción a esta eliminación de versión es si una versión está asociada con otra versión (esto sucede, por ejemplo, si clona una versión de un canal a otro dentro del mismo sitio ).

El alojamiento admite dos formas diferentes de controlar la expiración de un canal:

  • Consola de Firebase
    En la fila del canal de vista previa, haga clic en y luego seleccione Configuración del canal . Ingrese la fecha y hora de vencimiento.

  • Firebase CLI
    Cuando implementes en tu canal de vista previa, pasa la --expires DURATION , por ejemplo:

    firebase hosting:channel:deploy new-awesome-feature --expires 7d

    El vencimiento puede ser de hasta 30 días a partir de la fecha de implementación. Utilice h para horas, d para días w para semanas (por ejemplo, 12h , 7d , 2w , respectivamente).

Clonar una versión de un canal a otro

Puede clonar una versión implementada de un canal a un canal diferente. Puede clonar en canales en vivo o de vista previa, en sitios de alojamiento o incluso en proyectos de Firebase.

El comando de clonación también se implementa en el canal "objetivo" para que el contenido y la configuración de Hosting clonados se sirvan automáticamente en la URL asociada del canal "objetivo".

Esta función es útil para el seguimiento de versiones o si desea tener la confianza de que está implementando el contenido exacto que ha visto y / o probado en otro canal. Aquí hay unos ejemplos:

  • Clonar desde un canal de vista previa de "QA" al canal en vivo de su sitio (¡en vivo!)

  • Clonar del canal en vivo de su sitio a un canal de vista previa de "depuración" (como antes de una reversión)

  • Clona de un canal en tu proyecto de Firebase "provisional" a un canal de vista previa en tu proyecto de Firebase "prod"

Para clonar una versión, ejecute el siguiente comando desde cualquier directorio:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

Reemplace cada marcador de posición con lo siguiente:

  • SOURCE_SITE_ID y TARGET_SITE_ID : estos son los ID de los sitios de alojamiento que contienen los canales.

    • Para su sitio de alojamiento predeterminado, use su ID de proyecto de Firebase.
    • Puede especificar sitios de alojamiento que estén en el mismo proyecto de Firebase o incluso en diferentes proyectos de Firebase.
  • SOURCE_CHANNEL_ID y TARGET_CHANNEL_ID : estos son los identificadores de los canales.

    • Para un canal en vivo, use live como ID de canal.
    • Si el canal "objetivo" especificado aún no existe, este comando crea el canal antes de implementarlo.

Regrese a una versión anterior de su sitio

Puede retroceder para publicar una versión anterior del canal en vivo de su sitio. Esta acción es útil si su versión actual tiene un problema y desea revertir para ofrecer una versión de trabajo conocida de su sitio. O tal vez su sitio ofreció contenido temporal para un día festivo o un evento especial, pero ahora desea volver a publicar su contenido "habitual".

Al revertir, crea una nueva versión que ofrece la misma versión de contenido que una versión anterior. En la tabla del historial de versiones, ambas versiones mostrarán el mismo identificador de versión.

A continuación, le indicamos cómo retroceder:

  1. En Firebase console , en la tabla Historial de versiones de tu sitio, coloca el cursor sobre la entrada de la versión anterior a la que deseas retroceder.

  2. Haga clic en , luego seleccione Revertir .

Eliminar manualmente una versión

Es posible que deba eliminar manualmente una versión de su canal en vivo para liberar almacenamiento de Hosting para su proyecto. Solo puede eliminar versiones anteriores, no la versión que se publica actualmente en su sitio en vivo.

Cuando elimina una versión, en realidad está eliminando su contenido, que está programado para eliminarse dentro de las 24 horas. El objeto de publicación en sí se conserva para que aún pueda ver sus metadatos (quién implementó y cuándo lo hizo).

A continuación, se explica cómo eliminar una versión:

  1. En Firebase console , en la tabla Historial de versiones de tu sitio, coloca el cursor sobre la entrada de la versión anterior que deseas eliminar.

  2. Haga clic en , luego seleccione Delete .

Eliminar manualmente un canal de vista previa

Puede eliminar un canal de vista previa, pero no puede eliminar el canal en vivo de su sitio.

Cuando elimina un canal de vista previa, el canal, junto con sus lanzamientos y versiones asociadas, está programado para su eliminación dentro de las 24 horas. La URL de vista previa asociada también está desactivada. Una excepción a la eliminación de la versión es si una versión está asociada con otra versión (esto sucede, por ejemplo, si clona una versión de un canal a otro dentro del mismo sitio ).

El alojamiento admite dos formas diferentes de eliminar un canal de vista previa:

  • Consola de Firebase
    En la fila del canal de vista previa, haga clic en y luego seleccione Eliminar canal . Confirma la eliminación.

  • Firebase CLI
    Ejecute el siguiente comando desde cualquier directorio:

    firebase hosting:channel:delete CHANNEL_ID

Comandos CLI para canales de vista previa y clonación

Comandos para canales de vista previa

Todos los comandos para los canales de vista previa son compatibles con los destinos de implementación si tiene varios sitios de alojamiento .

Mando Descripción
firebase hosting:channel:create CHANNEL_ID

Crea un nuevo canal de vista previa en el sitio de alojamiento predeterminado utilizando el CHANNEL_ID especificado

Este comando no se implementa en el canal.

firebase hosting:channel:delete CHANNEL_ID

Elimina el canal de vista previa especificado

No puede eliminar el canal en vivo de un sitio.

firebase hosting:channel:deploy CHANNEL_ID

Implementa su contenido y configuración de Hosting en el canal de vista previa especificado

Si el canal de vista previa aún no existe, este comando crea el canal en el sitio de alojamiento predeterminado antes de implementarlo en el canal.

firebase hosting:channel:list Enumera todos los canales (incluido el canal "en vivo") en el sitio de alojamiento predeterminado
firebase hosting:channel:open CHANNEL_ID Abre un navegador a la URL del canal especificado o devuelve la URL si no es posible abrirla en un navegador

Comandos para la clonación de versiones

Mando Descripción
firebase hosting:clone \
SOURCE_SITE_ID : SOURCE_CHANNEL_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

Clona la versión implementada más recientemente en el canal "fuente" especificado en el canal "objetivo" especificado

Este comando también se implementa en el canal "objetivo" especificado. Si el canal "objetivo" aún no existe, este comando crea un nuevo canal de vista previa en el sitio de alojamiento "objetivo" antes de implementarlo en el canal.

firebase hosting:clone \
SOURCE_SITE_ID :@ VERSION_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

Clona la versión especificada en el canal "objetivo" especificado

Este comando también se implementa en el canal "objetivo" especificado. Si el canal "objetivo" aún no existe, este comando crea un nuevo canal de vista previa en el sitio de alojamiento "objetivo" antes de implementarlo en el canal.

Puedes encontrar VERSION_ID en el panel de Hosting de Firebase console.