Hoja de referencia de la bandera de Bazel

Informar un problema Ver código fuente

Nightly · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 7.7

Navegar por la extensa lista de marcas de línea de comandos de Bazel puede ser un desafío. En esta página, se describen las marcas más importantes que debes conocer.

Sugerencia: Selecciona el nombre de la marca en la tabla para navegar a su entrada en la referencia de la línea de comandos.

Opciones generales útiles

Las siguientes marcas deben establecerse de forma explícita en la línea de comandos.

Marcar	Descripción
--config	Puedes organizar las marcas en un archivo .bazelrc en configuraciones, como las de depuración o compilaciones de lanzamiento. Se pueden seleccionar grupos de configuración adicionales con --config=<group>.
--keep_going	Bazel debería intentar continuar con la ejecución de compilación y prueba tanto como sea posible. De forma predeterminada, Bazel falla con rapidez.
--remote_download_outputs	Cuando usas la ejecución o el almacenamiento en caché remotos (tanto en disco como remotos), puedes indicarle a Bazel que deseas descargar todos los artefactos de compilación (intermedios) de la siguiente manera: --remote_download_outputs=all De forma predeterminada, Bazel solo descarga artefactos de nivel superior, como el objeto binario final, y artefactos intermedios que son necesarios para las acciones locales.
--stamp	Agrega información de compilación (usuario, marca de tiempo) a los objetos binarios. Nota: Debido a que esto aumenta el tiempo de compilación, solo está destinado a las compilaciones de lanzamiento.

Descubre problemas de compilación y prueba

Las siguientes marcas pueden ayudarte a comprender mejor los errores de compilación o prueba de Bazel.

Marcar	Descripción
--announce_rc	Muestra qué marcas se establecen de forma implícita a través de archivos .bazelrc definidos por el usuario, la máquina o el proyecto.
--auto_output_filter	De forma predeterminada, Bazel intenta evitar el spam de registros y solo imprime advertencias del compilador y resultados de depuración de Starlark para los paquetes y subpaquetes solicitados en la línea de comandos. Para inhabilitar todo el filtrado, establece --auto_output_filter=none.
--sandbox_debug	Te permite profundizar en los errores de la zona de pruebas. Para obtener detalles sobre por qué Bazel usa zonas de pruebas de forma predeterminada y qué se incluye en la zona de pruebas, consulta nuestra documentación sobre zonas de pruebas. Sugerencia: Si crees que el error puede deberse a la zona de pruebas, intenta desactivarla de forma temporal. Para ello, agrega --spawn_strategy=standalone a tu comando.
--subcommands (-s)	Muestra una lista completa de todos los comandos que ejecuta Bazel durante una compilación, independientemente de si se realiza correctamente o no.

Inicio

Precaución: Las marcas de inicio deben pasarse antes del comando y provocar un reinicio del servidor. Activa y desactiva estas marcas con precaución.

Marcar	Descripción
--bazelrc	Puedes especificar las opciones predeterminadas de Bazel en .bazelrc archivos. Si existen varios archivos .bazelrc, puedes seleccionar qué archivo .bazelrc se usa agregando --bazelrc=<path to the .bazelrc file>. Sugerencia: --bazelrc=dev/null inhabilita la búsqueda de archivos .bazelrc. Esto es ideal para situaciones en las que deseas garantizar un entorno de compilación limpio, como las compilaciones de lanzamiento, y evitar cualquier cambio de configuración no deseado de los archivos .bazelrc.
--host_jvm_args	Limita la cantidad de RAM que usa el servidor de Bazel. Por ejemplo, lo siguiente limita el tamaño de montón de Bazel a 3GB: --host_jvm_args=-Xmx3g Nota: -Xmx se usa para establecer el tamaño máximo de montón para Java Virtual Machine (JVM). El montón es el área de memoria en la que se asignan los objetos. El formato correcto para esta opción es -Xmx<size> , en el que <size> es el tamaño máximo de montón, especificado con una unidad como: m para megabytes g para gigabytes k para kilobytes
--output_base	Controla el árbol de salida de Bazel. Bazel no almacena resultados de compilación, incluidos los registros, dentro del árbol fuente. En su lugar, usa un árbol de salida distinto para este propósito. Sugerencia: Usar varias bases de salida en un espacio de trabajo de Bazel te permite ejecutar varios servidores de Bazel de forma simultánea. Esto puede ser útil cuando se intenta evitar la pérdida de análisis. Para obtener más información, consulta Cómo elegir la base de salida.

Pruebas de Bazel

Las siguientes marcas están relacionadas con la prueba de Bazel

Marcar	Descripción
--java_debug	Hace que las pruebas de Java esperen una conexión de depurador antes de ejecutarse.
--runs_per_test	Es la cantidad de veces que se deben ejecutar las pruebas. Por ejemplo, para ejecutar pruebas N veces, agrega --runs_per_test=N. Esto puede ser útil para depurar pruebas inestables y ver si una corrección hace que una prueba se apruebe de forma coherente.
--test_output	Especifica el modo de salida. De forma predeterminada, Bazel captura el resultado de la prueba en archivos de registro locales. Cuando iteras en una prueba interrumpida, por lo general, deseas usar --test_output=streamed para ver el resultado de la prueba en tiempo real.

Ejecución de Bazel

Las siguientes marcas están relacionadas con la ejecución de Bazel.

Marcar	Descripción
--run_under	Cambia la forma en que se invocan los ejecutables. Por ejemplo, --run_under="strace -c" se usa con frecuencia para la depuración.

Opciones de bazelrc específicas del usuario

Las siguientes marcas están relacionadas con las opciones .bazelrc específicas del usuario.

Marcar	Descripción
--disk_cache	Es una ruta de acceso a un directorio en el que Bazel puede leer y escribir acciones y resultados de acciones. Si el directorio no existe, se creará. Puedes compartir artefactos de compilación entre varias ramas o espacios de trabajo y acelerar las compilaciones de Bazel agregando --disk_cache=<path> a tu comando.
--jobs	Es la cantidad de trabajos simultáneos que se deben ejecutar. Por lo general, solo se requiere cuando se usa la ejecución remota, en la que un clúster de compilación remota ejecuta más trabajos de los que tienes núcleos de forma local.
--local_resources	Limita la cantidad de CPU o RAM que consumen las acciones que se ejecutan de forma local. Nota: Esto no afecta la cantidad de CPU o RAM que consume el servidor de Bazel para tareas como el análisis y la organización de la compilación.
--sandbox_base	Permite que la zona de pruebas cree sus directorios de zona de pruebas debajo de esta ruta de acceso. De forma predeterminada, Bazel ejecuta acciones locales en la zona de pruebas, lo que agrega una sobrecarga a la compilación. Sugerencia: Especifica una ruta de acceso en tmpfs, por ejemplo, /run/shm, para mejorar el rendimiento cuando tu compilación o pruebas tienen muchos archivos de entrada.

Opciones de bazelrc específicas del proyecto

Las siguientes marcas están relacionadas con las opciones .bazelrc específicas del proyecto.

Marcar	Descripción
--flaky_test_attempts	Vuelve a intentar cada prueba hasta la cantidad especificada de veces en caso de cualquier falla de prueba. Esto es especialmente útil en la integración continua. Las pruebas que requieren más de un intento para aprobarse se marcan como FLAKY en el resumen de la prueba.
--remote_cache	Es un URI de un extremo de almacenamiento en caché. Configurar el almacenamiento en caché remoto puede ser una excelente manera de acelerar las compilaciones de Bazel. Se puede combinar con una caché de disco local.
--remote_download_regex	Fuerza la descarga de los resultados de compilación remotos cuya ruta de acceso coincida con este patrón, independientemente de la configuración de --remote_download_outputs. Se pueden especificar varios patrones repitiendo esta marca.
--remote_executor	HOST o HOST:PORT de un extremo de ejecución remota. Pasa esto si usas un servicio de ejecución remota. A menudo, deberás agregar --remote_instance_name=<name>.
--remote_instance_name	Es el valor que se debe pasar como instance_name en la API de ejecución remota.
--show-timestamps	Si se especifica, se agrega una marca de tiempo a cada mensaje generado por Bazel que especifica la hora en la que se mostró el mensaje. Esto es útil en los sistemas de CI para comprender rápidamente qué paso tardó cuánto tiempo.
--spawn_strategy	Incluso con la ejecución remota, ejecutar algunas acciones de compilación de forma local puede ser más rápido. Esto depende de factores como la capacidad del clúster de compilación, la velocidad de la red y las demoras de la red. Sugerencia: Para ejecutar acciones de forma local y remota, y aceptar el resultado más rápido, agrega --spawn_strategy=dynamic a tu comando de compilación.