Modelo de lanzamiento

Como se anunció en la publicación de blog original, Bazel 4.0 y las versiones posteriores admiten dos pistas de lanzamiento: lanzamientos continuos y lanzamientos 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 major.minor.patch.

• Los lanzamientos continuos se coordinan con el lanzamiento de Google Blaze y se realizan desde HEAD aproximadamente cada dos semanas. Es una versión preliminar de la próxima versión de LTS de Bazel.
• Las versiones continuas pueden incluir cambios incompatibles. Las marcas incompatibles se recomiendan para los cambios rotundos importantes, y el lanzamiento de cambios incompatibles debe seguir nuestra política de compatibilidad con versiones anteriores.

Versiones de LTS

• Versión principal: Se espera que se cree una nueva versión LTS a partir de HEAD aproximadamente cada 12 meses. Una vez que se lanza una nueva versión de LTS, esta ingresa de inmediato en la etapa Activa, y la versión de LTS anterior ingresa en la etapa de Mantenimiento.
• Versión secundaria: Se espera que las nuevas versiones secundarias en el segmento de LTS activo se lancen una vez cada 2 meses.
• Lanzamiento de parches: Se espera que se lancen nuevas versiones de parches para las versiones LTS en las etapas Activa y de Mantenimiento a pedido para correcciones de errores críticos.
• Una versión de LTS de Bazel entra en la etapa de desuso 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.

Procedimiento y políticas de lanzamiento

En el caso de los lanzamientos continuos, el proceso es sencillo: cada dos semanas, aproximadamente, se crea un nuevo lanzamiento que se alinea con la misma versión de referencia que el lanzamiento interno de Blaze de Google. Debido al cronograma de lanzamientos rápidos, no realizamos portaciones inversas de ningún cambio a los lanzamientos continuos.

En el caso de las versiones de 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.
   • En el caso de una nueva versión principal de LTS, la confirmación de referencia es el HEAD de la rama principal.
   • En el caso de una versión secundaria o de parche, la confirmación de referencia es el HEAD de la versión más reciente actual de la misma versión de LTS.
2. Crea una rama de lanzamiento con el nombre release-<version> a partir de la confirmación de referencia.
3. Realiza un backport de los cambios a través de PR en la rama de lanzamiento.
   • La comunidad puede sugerir que se realice un backport de ciertas confirmaciones respondiendo "@bazel-io flag" en los problemas o las PR pertinentes de GitHub para marcarlos como posibles bloqueadores de lanzamientos. El equipo de Bazel los clasifica y decide si se debe realizar un backport de las confirmaciones.
   • Solo se pueden transferir a versiones anteriores los commits compatibles con versiones anteriores en la rama principal. Se aceptan cambios menores adicionales para resolver conflictos de combinación.
4. Identificar los bloqueadores de la versión y corregir los problemas que se encuentren en la rama de la versión
   • La rama de lanzamiento se prueba con el mismo conjunto de pruebas en la canalización de pruebas posterior al envío y descendente en la CI de Bazel. El equipo de Bazel supervisa los resultados de las pruebas de la rama de lanzamiento y corrige cualquier regresión que se encuentre.
5. Crea un nuevo candidato para lanzamiento a partir de la rama de lanzamiento cuando se resuelvan todos los bloqueadores de lanzamiento conocidos.
   • El candidato a 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 bloqueadores de la versión nueva, vuelve al último paso y crea una nueva versión candidata después de resolver todos los problemas.
   • No se permite agregar funciones nuevas a la rama de la versión después de crear la primera versión candidata.
6. Publica la versión candidata como la versión oficial si no se encuentran más bloqueadores de lanzamientos.
   • En el caso de las versiones de parche, publícalas 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, lanza 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 envía en un día en el que el día siguiente es un día hábil.
   • El lanzamiento se anuncia en bazel-discuss, y el equipo de Bazel supervisa y aborda los informes de errores de la comunidad para el nuevo lanzamiento.

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, debe informar un error en GitHub. Puedes usar Bazelisk para aislar la confirmación infractora e 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 realizar una búsqueda binaria con

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 bisección de Bazelisk.

Recuerda actualizar Bazelisk a la versión más reciente para usar la función de 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.