无GitHub访问权限的离线环境下如何用Bazel结合jsonnet rules构建Jsonnet项目
核心问题原因
你之前构建失败的核心是两个认知偏差和操作错误:
- 执行命令的参数笔误,多打了一个短横,Bazel根本没有触发
--distdir的离线缓存逻辑 - 完全搞错了Bazel
--distdir对git类型外部仓库的匹配规则,不是把源码文件夹丢进distdir就能被识别的,这也是为啥放了jsonnet rules代码还是会触发GitHub拉取报错的原因。
第一步:按规范准备离线distdir目录的内容
Bazel的distdir对git仓库的匹配有严格要求,不是任意打包的源码就能命中:
- 首先要拉全jsonnet rules的所有传递依赖,从报错信息看,你现在连第一个依赖
@jsonnet_go(也就是google/go-jsonnet仓库)都没有准备对 - git类仓库的离线包必须满足两个硬要求:
- 必须是对应commit/tag的完整git仓库打的
.tar.gz压缩包,不能是解压的源码文件夹 - 压缩包命名必须严格匹配Bazel内部的生成规则:把git远程地址里的
/、:等特殊字符全部替换为%,拼接上对应的commit hash,后缀为.tar.gz。举个例子,远程地址为https://github.com/google/go-jsonnet.git、commit为abc123的仓库,压缩包名必须为https:%github.com%google%go-jsonnet.git%abc123.tar.gz - 压缩包内的第一层目录必须和仓库名一致,比如go-jsonnet仓库的压缩包解开后第一层必须是
go-jsonnet/,不能多套一层冗余目录
- 必须是对应commit/tag的完整git仓库打的
- 注意:jsonnet rules的依赖是树形结构,你需要把所有通过
git_repository声明的外部仓库(包括传递依赖的go rules、平台规则、protobuf等)全部按上面的规则打包放进distdir,不能只放jsonnet rules本身的代码。
第二步:修正构建命令的参数
你之前的命令多打了一个短横,正确的执行格式是:
bazel test //project --distdir=/你的离线资源目录绝对路径
参数名是两个短横开头的--distdir,四个短横的写法会被bash识别为无效参数,完全不会触发distdir的缓存匹配
第三步:更稳定的全离线兜底方案
如果按distdir规则打包太繁琐,可以直接跳过Bazel的远程拉取逻辑,在项目的WORKSPACE文件里把所有引用的git_repository规则替换为new_local_repository,直接指向你本地提前拉好的源码目录:
- 把原有类似的规则:
git_repository( name = "jsonnet_go", remote = "https://github.com/google/go-jsonnet.git", commit = "xxxxxx", ) - 替换为本地仓库规则:
这个方案不依赖distdir的匹配规则,完全不会触发任何GitHub远程请求,是纯离线场景下稳定性最高的方案。new_local_repository( name = "jsonnet_go", path = "/你本地拉取的go-jsonnet源码的绝对路径", build_file = "//:BUILD.go-jsonnet", # 这里要和原仓库自带的BUILD文件路径匹配,避免出现找不到包的错误 )
必踩的两个坑提醒
- 不要把未压缩的源码文件夹直接放进distdir,Bazel的distdir只会识别符合命名规则的压缩包,不会扫描目录里的源码
- 如果之前在有网环境执行过Bazel命令,本地会残留在线拉取的仓库缓存,需要先执行
bazel clean --expunge清空所有本地缓存,再走离线构建流程,否则会优先命中缓存里的远程仓库配置,继续尝试拉取GitHub资源。
内容的提问来源于stack exchange,提问作者djamaile
相关产品推荐
相关产品推荐

