Como se anunció en la entrada de blog original, Bazel 4.0 y versiones posteriores proporcionan compatibilidad con dos segmentos de versiones: versiones continuas y versiones de asistencia a largo plazo (LTS). En esta página, se incluye la información más reciente sobre el modelo de versiones 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 compatibles con versiones anteriores. Cada versión principal de Bazel es una versión de LTS.
- Una versión secundaria contiene correcciones de errores compatibles con versiones anteriores y funciones transferidas desde la rama principal.
- Una versión de parche contiene correcciones de errores críticos.
Además, las versiones previas al lanzamiento se indican agregando un guion y un sufijo de fecha al siguiente número de versión principal.
Por ejemplo, una versión nueva de cada tipo generaría los siguientes números de versión:
- Principal: 6.0.0
- Secundaria: 6.1.0
- Parche: 6.1.2
- Antes del lanzamiento: 7.0.0-pre.20230502.1
Etapas de compatibilidad
Para cada versión principal de Bazel, hay cuatro etapas de compatibilidad:
- Continuo: Esta versión principal aún está en la etapa previa al lanzamiento. El equipo de Bazel publica versiones continuas desde HEAD.
- Activa: Esta versión principal es la versión de LTS activa actual. El equipo de Bazel transfiere funciones importantes y correcciones de errores a sus versiones secundarias.
- Mantenimiento: Esta versión principal es una versión de LTS antigua en modo de mantenimiento. El equipo de Bazel solo promete transferir correcciones de errores críticos para problemas de seguridad y problemas de compatibilidad con el SO a esta versión de LTS.
- Obsoleta: El equipo de Bazel ya no proporciona compatibilidad con esta versión principal . Todos los usuarios deben migrar a versiones de LTS de Bazel más recientes.
Frecuencia de actualización
Bazel publica versiones periódicamente para dos segmentos de versiones.
Versiones continuas
- Las versiones continuas se coordinan con la versión de Blaze de Google y se lanzan desde HEAD aproximadamente cada dos semanas. Es una vista previa de la próxima versión de LTS de Bazel.
- Las versiones continuas pueden enviar cambios incompatibles. Se recomiendan marcas incompatibles para cambios rotundos importantes. 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 corte una nueva versión de LTS desde HEAD aproximadamente cada 12 meses. Una vez que se lanza una nueva versión de LTS, ingresa de inmediato a la etapa Activa y la versión de LTS anterior ingresa a la etapa Mantenimiento.
- Versión secundaria: Se espera que las nuevas versiones secundarias en el segmento de LTS activo se lancen una vez cada 2 meses.
- Versión de parche: Se espera que las nuevas versiones de parche para las versiones de LTS en las etapas Activa y Mantenimiento se lancen a pedido para correcciones de errores críticos.
- Una versión de LTS de Bazel ingresa a la etapa Obsoleta 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
| Versión de LTS | Etapa de compatibilidad | Última versión | Fin de la compatibilidad |
|---|---|---|---|
| Bazel 7 | Continuo | Consulta la página de versiones de GitHub | N/A |
| Bazel 6 | Activa | 6.4.0 | Diciembre de 2025 |
| Bazel 5 | Mantenimiento | 5.4.1 | Enero de 2025 |
| Bazel 4 | Mantenimiento | 4.2.4 | Enero de 2024 |
Todas las versiones de Bazel se pueden encontrar en la página de versiones en GitHub.
Procedimiento y políticas de versiones
Para las versiones continuas, el proceso es sencillo: aproximadamente cada dos semanas, se crea una versión nueva, que se alinea con la misma línea de base que la versión interna de Blaze de Google. Debido al programa de versiones rápidas, no transferimos ningún cambio a las versiones continuas.
Para las versiones de LTS, se siguen los siguientes procedimientos y políticas:
- Determina una confirmación de línea de base para la versión.
- Para una nueva versión principal de LTS, la confirmación de línea de base es el HEAD de la rama principal.
- Para una versión secundaria o de parche, la confirmación de línea de base es el HEAD de la versión más reciente actual de la misma versión de LTS.
- Crea una rama de versión con el nombre
release-<version>a partir de la confirmación de línea de base. - Transfiere los cambios a través de las RP a la rama de versión.
- La comunidad puede sugerir que se transfieran ciertas confirmaciones respondiendo "
@bazel-io flag" en los problemas o las RP de GitHub pertinentes para marcarlos como posibles bloqueadores de versiones. El equipo de Bazel los clasifica y decide si transferir las confirmaciones. - Solo se pueden transferir las confirmaciones compatibles con versiones anteriores en la rama principal. Se aceptan cambios secundarios adicionales para resolver conflictos de combinación.
- La comunidad puede sugerir que se transfieran ciertas confirmaciones respondiendo "
- Identifica los bloqueadores de versiones y corrige los problemas que se encuentran en la rama de versión.
- La rama de versión se prueba con el mismo conjunto de pruebas en postsubmit y descendente en Bazel CI. El equipo de Bazel supervisa los resultados de las pruebas de la rama de versión y corrige cualquier regresión que se encuentre.
- Crea una nueva versión candidata para lanzamiento desde la rama de versión cuando se resuelvan todos los bloqueadores de versiones conocidos.
- La versión candidata para lanzamiento se anuncia en bazel-discuss, el equipo de Bazel supervisa los informes de errores de la comunidad para el candidato.
- Si se identifican nuevos bloqueadores de versiones, vuelve al último paso y crea una nueva versión candidata para lanzamiento después de resolver todos los problemas.
- No se permite agregar funciones nuevas a la rama de versión después de crear la primera versión candidata para lanzamiento.
- Envía la versión candidata para lanzamiento como la versión oficial si no se encuentran más bloqueadores de versiones.
- Para las versiones de parche, envía la versión al menos dos días hábiles después de que se publique la última versión candidata para lanzamiento.
- Para 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 para lanzamiento, pero no antes de una semana después de que se publique la primera versión candidata para lanzamiento.
- La versión solo se envía en un día en el que el día siguiente es un día hábil.
- La versión 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 para lanzamiento o incluso Bazel en HEAD, envía un error en GitHub. Puedes usar Bazelisk para dividir la confirmación culpable y 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 para lanzamiento de 6.2.0, puedes hacer una división a través de
bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar
Puedes configurar la variable de entorno BAZELISK_SHUTDOWN o BAZELISK_CLEAN para ejecutar los comandos de bazel correspondientes para restablecer el estado de la compilación si es necesario reproducir el problema. Para obtener más detalles, consulta la documentación sobre la función de división de Bazelisk
bisect.
Recuerda actualizar Bazelisk a la versión más reciente para usar la función de división.
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.