基于Bazel与Cloud Build实现单体仓库容器化部署自动化求助

我来一步步帮你拆解这个流程，结合你的Monorepo结构给出具体的配置和实现方案：

一、前置准备 #

先确保你已经安装好 Bazelisk（推荐用它自动管理Bazel版本，避免版本兼容问题），同时用gcloudCLI完成GCP账号配置，给后续操作的服务账号分配好GCR推送、GKE部署的权限。

二、根目录WORKSPACE文件配置 #

这个文件是Bazel的依赖声明核心，需要引入Node.js、Docker、GCP相关的官方规则，直接用下面的模板替换即可（记得更新sha256和GCP项目信息）：

# WORKSPACE
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

# 引入Node.js构建规则
http_archive(
    name = "build_bazel_rules_nodejs",
    sha256 = "替换为对应版本的sha256值",
    urls = ["https://github.com/bazelbuild/rules_nodejs/releases/download/6.4.0/rules_nodejs-6.4.0.tar.gz"],
)

load("@build_bazel_rules_nodejs//:repositories.bzl", "rules_nodejs_dependencies", "rules_nodejs_dev_dependencies")
rules_nodejs_dependencies()
rules_nodejs_dev_dependencies()

# 引入Docker构建规则
http_archive(
    name = "io_bazel_rules_docker",
    sha256 = "替换为对应版本的sha256值",
    urls = ["https://github.com/bazelbuild/rules_docker/releases/download/v0.25.0/rules_docker-v0.25.0.tar.gz"],
)

load("@io_bazel_rules_docker//repositories:repositories.bzl", "repositories")
repositories()

# 引入GCP规则（用于GCR推送、GKE部署）
http_archive(
    name = "bazel_gcp",
    sha256 = "替换为对应版本的sha256值",
    urls = ["https://github.com/bazelbuild/rules_gcp/releases/download/v0.1.0/rules_gcp-v0.1.0.tar.gz"],
)

load("@bazel_gcp//:deps.bzl", "gcp_dependencies")
gcp_dependencies()

# 注册Node.js工具链（指定你项目用的Node版本）
load("@build_bazel_rules_nodejs//:index.bzl", "nodejs_register_toolchains")
nodejs_register_toolchains(
    name = "nodejs",
    node_version = "18.17.0",
)

三、各模块的BUILD文件配置 #

1. 基础共用包（packages/enums、packages/utils） #

这些是纯Node模块，用js_library规则声明即可：

packages/enums/BUILD

load("@build_bazel_rules_nodejs//:index.bzl", "js_library")

js_library(
    name = "enums",
    srcs = glob(["*.ts"]),
    declaration = True, # 生成类型声明文件
    deps = [],
)

packages/utils/BUILD

load("@build_bazel_rules_nodejs//:index.bzl", "js_library")

js_library(
    name = "utils",
    srcs = glob(["*.ts"]),
    declaration = True,
    deps = ["//packages/enums"], # 依赖enums包
)

2. Gateway服务（services/gateway） #

这里要完成TS编译、Docker镜像构建、GCR推送三个环节，直接在services/gateway/BUILD里添加：

load("@build_bazel_rules_nodejs//:index.bzl", "nodejs_binary")
load("@io_bazel_rules_docker//nodejs:image.bzl", "nodejs_image")
load("@bazel_gcp//gcr:gcr.bzl", "gcr_push")

# 1. 编译TS代码为可执行的Node二进制文件
nodejs_binary(
    name = "gateway",
    srcs = glob(["*.ts"]),
    deps = [
        "//packages/enums",
        "//packages/utils",
    ],
    entry_point = "index.ts", # 指定服务入口文件
)

# 2. 基于编译后的二进制文件构建Docker镜像
# 如果你想用自己的Dockerfile，替换成docker_build规则（下面有示例）
nodejs_image(
    name = "gateway_image",
    binary = ":gateway",
    base = "@nodejs//image", # 用官方Node镜像作为基础
    env = {
        "NODE_ENV": "production",
    },
)

# 自定义Dockerfile的替代方案
# load("@io_bazel_rules_docker//docker:docker.bzl", "docker_build")
# docker_build(
#     name = "gateway_image",
#     dockerfile = "Dockerfile",
#     srcs = [":gateway"], # 把编译后的代码传入镜像上下文
#     context = ".",
# )

# 3. 推送镜像到GCR
gcr_push(
    name = "push_gateway_image",
    image = ":gateway_image",
    repository = "gcr.io/你的GCP项目ID/gateway", # 替换为你的GCR仓库地址
    tag = "{BUILD_TIMESTAMP}", # 用构建时间戳作为镜像标签，也可以自定义
)

3. Kubernetes部署配置（kubernetes/） #

用k8s_deploy规则实现自动将配置应用到GKE集群，创建kubernetes/BUILD：

load("@bazel_gcp//k8s:k8s.bzl", "k8s_deploy")

k8s_deploy(
    name = "deploy_gateway",
    manifests = glob(["*.yaml"]), # 加载所有K8s配置文件
    cluster = "你的GKE集群名称",
    location = "us-central1", # 替换为你的集群区域
    # 关联镜像：K8s配置里的镜像地址要和这里一致
    images = {
        "gcr.io/你的GCP项目ID/gateway:latest": ":gateway_image",
    },
)

四、集成Cloud Build实现全流程自动化 #

在根目录创建cloudbuild.yaml，定义Cloud Build的执行步骤：

steps:
  # 步骤1：初始化Bazel
  - name: 'gcr.io/cloud-builders/bazelisk'
    args: ['version']

  # 步骤2：运行所有测试（如果有单元测试的话）
  - name: 'gcr.io/cloud-builders/bazelisk'
    args: ['test', '//...', '--test_output=all']

  # 步骤3：构建并推送Gateway镜像到GCR
  - name: 'gcr.io/cloud-builders/bazelisk'
    args: ['run', '//services/gateway:push_gateway_image']

  # 步骤4：将变更应用到GKE集群
  - name: 'gcr.io/cloud-builders/bazelisk'
    args: ['run', '//kubernetes:deploy_gateway']

# 给Cloud Build服务账号分配权限（需要Storage Admin、Kubernetes Engine Developer角色）
serviceAccount: 'projects/你的GCP项目ID/serviceAccounts/cloud-build@你的GCP项目ID.iam.gserviceaccount.com'

# 开启构建缓存，加快后续构建速度
options:
  cache:
    enabled: true

之后在GCP Cloud Build控制台创建触发器，关联你的代码仓库，设置触发条件（比如main分支推送时自动执行）即可。

五、关键注意事项 #

• 权限配置：务必确保Cloud Build的服务账号拥有GCR推送、GKE部署的对应权限，否则会执行失败。
• 版本兼容：Bazel规则和Node.js版本要匹配，用Bazelisk可以自动适配最合适的Bazel版本。
• Angular前端适配：如果需要构建Angular前端，可以引入@bazel/angular规则，类似Node.js的配置流程，把构建后的静态文件打包进Docker镜像。

内容的提问来源于stack exchange，提问作者Florian Ludewig