buchgr/bazel-remote-cache

bazel-remote 镜像文档

概述

bazel-remote 是一款支持HTTP/1.1和gRPC协议的服务器，主要用途是作为Bazel构建工具的远程构建缓存。它通过集中存储构建产物，加速Bazel构建过程，减少重复编译工作，提升开发和CI/CD效率。

核心功能与特性

• 多协议支持：同时兼容HTTP/1.1和gRPC协议，满足不同场景下的通信需求。
• 磁盘存储：缓存内容存储在指定的磁盘目录中，支持持久化保存。
• 自动缓存管理：可配置最大缓存大小，当超出限制时，基于文件最后访问时间自动清理旧缓存。
• 安全认证：支持两种认证机制：
  • HTTP基本认证（通过.htpasswd文件配置用户名和密码）
  • 双向TLS认证（需配置TLS证书）

使用场景

适用于使用Bazel进行构建的开发环境或CI/CD流水线，尤其适合需要跨团队、跨机器共享构建缓存的场景，可显著减少重复构建时间，提升构建效率。

使用方法与配置说明

基本部署示例

通过Docker快速启动bazel-remote服务：

bash
docker run -d \
  -p 8080:8080 \  # HTTP端口
  -p 9090:9090 \  # gRPC端口（若启用）
  -v /host/path/to/cache:/data \  # 挂载本地目录作为缓存存储
  -e MAX_SIZE=20G \  # 设置最大缓存大小（支持单位：K, M, G）
  buchgr/bazel-remote

核心配置参数

认证配置

HTTP基本认证

1. 准备.htpasswd文件（使用htpasswd工具生成）：

   bash
   htpasswd -c .htpasswd username
   

2. 启动容器时挂载该文件并启用认证：

   bash
   docker run -d \
     -p 8080:8080 \
     -v /host/path/to/cache:/data \
     -v /host/path/to/.htpasswd:/etc/bazel-remote/.htpasswd \
     -e MAX_SIZE=10G \
     buchgr/bazel-remote --http-auth-file /etc/bazel-remote/.htpasswd
   

双向TLS认证

需挂载TLS证书和密钥文件，并指定相关参数（具体配置见GitHub文档）。

更多配置

完整配置说明及高级用法请参考官方文档：
https://github.com/buchgr/bazel-remote