Modelo de lanzamiento

Como se anunció en la entrada de blog original, Bazel 4.0 y versiones posteriores admiten dos segmentos de lanzamiento: lanzamientos continuos y de asistencia a largo plazo (LTS). En esta página, se incluye la información más reciente sobre el modelo de lanzamiento de Bazel.

Control de versiones de actualización

Bazel usa un esquema de control de versiones semántico major.minor.patch.

• Una versión principal contiene funciones que no son retrocompatibles con la versión anterior. Cada versión principal de Bazel es una versión LTS.
• Una versión secundaria contiene correcciones de errores retrocompatibles y funciones que se portaron desde la rama principal.
• Una versión del parche contiene correcciones de errores críticas.

Además, las versiones previas al lanzamiento se indican con un guion y un sufijo de fecha al siguiente número de versión principal.

Por ejemplo, un lanzamiento nuevo de cada tipo generaría los siguientes números de versión:

• Mayor: 6.0.0
• Menor: 6.1.0
• Parche: 6.1.2
• Versión preliminar: 7.0.0-pre.20230502.1

Etapas de asistencia

Para cada versión principal de Bazel, hay cuatro etapas de asistencia:

• Continua: Esta versión principal aún está en versión preliminar. El equipo de Bazel publica versiones continuas desde HEAD.
• Activo: Esta versión principal es la versión LTS activa actual. El equipo de Bazel realiza portabilidad a versiones anteriores de funciones importantes y correcciones de errores en sus versiones menores.
• Mantenimiento: Esta versión principal es una versión LTS anterior en modo de mantenimiento. El equipo de Bazel solo promete realizar la portabilidad a versiones anteriores de las correcciones de errores críticas para problemas de seguridad y compatibilidad con el SO en esta versión LTS.
• Obsoleto: El equipo de Bazel ya no brinda asistencia para esta versión principal. Todos los usuarios deben migrar a versiones LTS de Bazel más recientes.

Frecuencia de actualización

Bazel publica versiones de forma periódica para dos segmentos.

Lanzamientos continuos

• Las versiones continuas se coordinan con el lanzamiento de Google Blaze y se lanzan desde HEAD aproximadamente cada dos semanas. Es una vista previa de la próxima versión LTS de Bazel.
• Las versiones continuas pueden enviar cambios incompatibles. Se recomiendan marcas incompatibles para los cambios rotundos importantes. El lanzamiento de cambios incompatibles debe seguir nuestra política de retrocompatibilidad.

Versiones LTS

• Lanzamiento importante: Se espera que una nueva versión de LTS se corte de HEAD aproximadamente cada 12 meses. Una vez que se lanza una nueva versión de LTS, esta entra de inmediato a la etapa Activa, y la versión de LTS anterior entra a la etapa de Mantenimiento.
• Versión menor: Se espera que las nuevas versiones menores del segmento de LTS activo se lancen una vez cada 2 meses.
• Lanzamiento de parches: Se espera que las nuevas versiones de parches para las versiones LTS en las etapas Activa y de mantenimiento se lancen a pedido para corregir errores críticos.
• Una versión de Bazel LTS entra a la etapa Obsoleto después de estar en la etapa de mantenimiento durante 2 años.

Para las versiones planificadas, consulta nuestros problemas de versiones en GitHub.

Matriz de compatibilidad

Todas las versiones de Bazel se pueden encontrar en la página de versiones en GitHub.

Políticas y procedimientos de lanzamiento

En el caso de los lanzamientos progresivos, el proceso es sencillo: aproximadamente cada dos semanas, se crea una versión nueva que se alinea con el mismo modelo de referencia de la versión Blaze interna de Google. Debido al programa de lanzamientos rápidos, no llevamos a cabo la portabilidad a versiones anteriores de los cambios a las versiones continuas.

En el caso de las versiones LTS, se siguen los procedimientos y las políticas que se indican a continuación:

1. Determina una confirmación de referencia para la versión.
   • Para una nueva versión importante de LTS, la confirmación del modelo de referencia es el ENCABEZADO de la rama principal.
   • En el caso de una versión secundaria o de parche, la confirmación del modelo de referencia es el ENCABEZADO de la versión más reciente de la misma versión de LTS.
2. Crea una rama de la versión en el nombre de release-<version> a partir de la confirmación del modelo de referencia.
3. Portabilidad a versiones anteriores de los cambios a través de PR a la rama de la versión
   • La comunidad puede sugerir que se lleven a cabo portabilidad a versiones anteriores de ciertas confirmaciones. Para ello, debe responder “@bazel-io flag” en los problemas o las PR relevantes de GitHub para marcarlas como posibles bloqueadores de lanzamientos. El equipo de Bazel las prioriza y decide si llevar a cabo la portabilidad a versiones anteriores de las confirmaciones.
   • Solo se pueden portar las confirmaciones retrocompatibles en la rama principal. Se aceptan cambios menores adicionales para resolver conflictos de combinación.
4. Identifica los bloqueos de lanzamiento y corrige los problemas que se encuentran en la rama de lanzamiento.
   • La rama de la versión se prueba con el mismo conjunto de pruebas en postsubmit y en la canalización de prueba descendente en Bazel CI. El equipo de Bazel supervisa los resultados de las pruebas de la rama de lanzamiento y corrige las regresiones que se encuentren.
5. Crea una nueva versión candidata a partir de la rama de versión cuando se resuelvan todos los bloqueadores de versión conocidos.
   • La versión candidata para el lanzamiento se anuncia en bazel-discuss y el equipo de Bazel supervisa los informes de errores de la comunidad para el candidato.
   • Si se identifican nuevos bloqueadores de lanzamiento, vuelve al último paso y crea una nueva versión candidata después de resolver todos los problemas.
   • No se pueden agregar funciones nuevas a la rama de lanzamiento después de que se crea la primera versión candidata.
6. Publica la versión candidata como la versión oficial si no se encuentran más bloqueadores de lanzamiento.
   • En el caso de las versiones de parches, envía la versión al menos dos días hábiles después de que se publique la última versión candidata.
   • En el caso de las versiones principales y secundarias, envía la versión dos días hábiles después de que se publique la última versión candidata, pero no antes de una semana después de que se publique la primera versión candidata.
   • La versión solo se publica en un día en que el día siguiente es un día hábil.
   • El lanzamiento se anuncia en bazel-discuss. El equipo de Bazel supervisa y aborda los informes de errores de la comunidad para la nueva versión.

Cómo informar regresiones

Si un usuario encuentra una regresión en una nueva versión de Bazel, una versión candidata o incluso Bazel en HEAD, informa un error en GitHub. Puedes usar Bazelisk para dividir la confirmación del error y, luego, incluir esta información en el informe de errores.

Por ejemplo, si tu compilación se realiza correctamente con Bazel 6.1.0, pero falla con la segunda versión candidata de 6.2.0, puedes hacer una bisección a través de

bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar

Puedes establecer la variable de entorno BAZELISK_SHUTDOWN o BAZELISK_CLEAN para ejecutar los comandos de Bazel correspondientes y restablecer el estado de compilación si es necesario para reproducir el problema. Para obtener más detalles, consulta la documentación sobre la función de biseccionamiento de Bazelisk.

Recuerda actualizar Bazelisk a la versión más reciente para usar la función bisect.

Compatibilidad de reglas

Si eres autor de reglas y deseas mantener la compatibilidad con diferentes versiones de Bazel, consulta la página Compatibilidad de reglas.