diff --git a/docs/external/registry.mdx b/docs/external/registry.mdx index 45ce13b3763a5c..b2a0c88885d210 100644 --- a/docs/external/registry.mdx +++ b/docs/external/registry.mdx @@ -94,12 +94,12 @@ field, which defaults to `archive`. extracted archive. The patch files are located under the `/modules/$MODULE/$VERSION/overlay` directory. The keys are the overlay file names, and the values are the integrity checksum of - the overlay files. The overlays are applied before the patch files. + the overlay files (must be non-empty). The overlays are applied before the patch files. * `patches`: A JSON object containing patch files to apply to the extracted archive. The patch files are located under the `/modules/$MODULE/$VERSION/patches` directory. The keys are the patch file names, and the values are the integrity checksum of - the patch files. The patches are applied after the overlay files and in + the patch files (must be non-empty). The patches are applied after the overlay files and in the order they appear in `patches`. * `patch_strip`: A number; the same as the `--strip` argument of Unix `patch`. @@ -116,7 +116,7 @@ field, which defaults to `archive`. cloned repository. The patch files are located under the `/modules/$MODULE/$VERSION/patches` directory. The keys are the patch file names, and the values are the integrity checksum of - the patch files. The patches are applied in the order they appear in + the patch files (must be non-empty). The patches are applied in the order they appear in `patches`. * If `type` is `local_path`, this module version is backed by a [`local_repository`](/rules/lib/repo/local#local_repository) repo rule; diff --git a/docs/remote/bep.mdx b/docs/remote/bep.mdx index bafdaa9e6e81e3..f68944d49e1a8f 100644 --- a/docs/remote/bep.mdx +++ b/docs/remote/bep.mdx @@ -45,8 +45,9 @@ if the build aborted prematurely. All build events form a directed acyclic graph through their parent and child relationship. Every build event except for the initial build event has one or -more parent events. Please note that not all parent events of a child event must -necessarily be posted before it. When a build is complete (succeeded or failed) +more parent events. BEP events are written respecting parent-child ordering +constraints, ensuring that parent events are always posted before their +children. When a build is complete (succeeded or failed) all announced events will have been posted. In case of a Bazel crash or a failed network transport, some announced build events may never be posted. diff --git a/docs/remote/caching.mdx b/docs/remote/caching.mdx index 415925d21a99f7..9acd75eeaf07d7 100644 --- a/docs/remote/caching.mdx +++ b/docs/remote/caching.mdx @@ -287,6 +287,11 @@ domain socket: This feature is unsupported on Windows. +### Chunked transfer + +Use the `--experimental_remote_cache_chunking` flag to read and write large +blobs to/from the remote cache in chunks. This requires server support. + ## Disk cache Bazel can use a directory on the file system as a remote cache. This is diff --git a/docs/run/bazelrc.mdx b/docs/run/bazelrc.mdx index f71aabb3cf0437..9bca4701d19f7b 100644 --- a/docs/run/bazelrc.mdx +++ b/docs/run/bazelrc.mdx @@ -141,6 +141,11 @@ try-import-if-bazel-version ~1.2 %workspace%/configs/1.2_flags.rc try-import-if-bazel-version ~1 %workspace%/configs/v1_flags.rc ``` +Imports may be chained recursively up to a maximum depth of 512. If Bazel +reports "Maximum import depth exceeded parsing config file", check for +unexpectedly long import chains. Set the `BAZEL_UNLIMITED_IMPORT_DEPTH` +environment variable to any value to disable this limit. + Import precedence: - Options in the imported file take precedence over options specified before diff --git a/site/en/external/registry.md b/site/en/external/registry.md index 7d6dcf8df78a76..ff4967a759b929 100644 --- a/site/en/external/registry.md +++ b/site/en/external/registry.md @@ -97,12 +97,12 @@ field, which defaults to `archive`. extracted archive. The patch files are located under the `/modules/$MODULE/$VERSION/overlay` directory. The keys are the overlay file names, and the values are the integrity checksum of - the overlay files. The overlays are applied before the patch files. + the overlay files (must be non-empty). The overlays are applied before the patch files. * `patches`: A JSON object containing patch files to apply to the extracted archive. The patch files are located under the `/modules/$MODULE/$VERSION/patches` directory. The keys are the patch file names, and the values are the integrity checksum of - the patch files. The patches are applied after the overlay files and in + the patch files (must be non-empty). The patches are applied after the overlay files and in the order they appear in `patches`. * `patch_strip`: A number; the same as the `--strip` argument of Unix `patch`. @@ -119,7 +119,7 @@ field, which defaults to `archive`. cloned repository. The patch files are located under the `/modules/$MODULE/$VERSION/patches` directory. The keys are the patch file names, and the values are the integrity checksum of - the patch files. The patches are applied in the order they appear in + the patch files (must be non-empty). The patches are applied in the order they appear in `patches`. * If `type` is `local_path`, this module version is backed by a [`local_repository`](/rules/lib/repo/local#local_repository) repo rule; diff --git a/site/en/remote/bep.md b/site/en/remote/bep.md index 35470e9591463d..b19395b73df9eb 100644 --- a/site/en/remote/bep.md +++ b/site/en/remote/bep.md @@ -46,8 +46,9 @@ if the build aborted prematurely. All build events form a directed acyclic graph through their parent and child relationship. Every build event except for the initial build event has one or -more parent events. Please note that not all parent events of a child event must -necessarily be posted before it. When a build is complete (succeeded or failed) +more parent events. BEP events are written respecting parent-child ordering +constraints, ensuring that parent events are always posted before their +children. When a build is complete (succeeded or failed) all announced events will have been posted. In case of a Bazel crash or a failed network transport, some announced build events may never be posted. diff --git a/site/en/remote/caching.md b/site/en/remote/caching.md index d3a6de21391b85..fc72fc21db3a43 100644 --- a/site/en/remote/caching.md +++ b/site/en/remote/caching.md @@ -288,6 +288,11 @@ domain socket: This feature is unsupported on Windows. +### Chunked transfer {:#chunked-transfer} + +Use the `--experimental_remote_cache_chunking` flag to read and write large +blobs to/from the remote cache in chunks. This requires server support. + ## Disk cache {:#disk-cache} Bazel can use a directory on the file system as a remote cache. This is diff --git a/site/en/run/bazelrc.md b/site/en/run/bazelrc.md index 5c3295ae3461b2..94310193c06468 100644 --- a/site/en/run/bazelrc.md +++ b/site/en/run/bazelrc.md @@ -142,6 +142,11 @@ try-import-if-bazel-version ~1.2 %workspace%/configs/1.2_flags.rc try-import-if-bazel-version ~1 %workspace%/configs/v1_flags.rc ``` +Imports may be chained recursively up to a maximum depth of 512. If Bazel +reports "Maximum import depth exceeded parsing config file", check for +unexpectedly long import chains. Set the `BAZEL_UNLIMITED_IMPORT_DEPTH` +environment variable to any value to disable this limit. + Import precedence: - Options in the imported file take precedence over options specified before