在Bazel oci_image的entrypoint中引用环境变量的问题

问题原因 #

Dockerfile中字符串形式的ENTRYPOINT会通过shell解析环境变量，但rules_oci的oci_image规则中，数组形式的entrypoint是直接执行命令（exec形式），不会经过shell处理，因此$WORKER_IMAGE、$MAX_NUM_WORKERS会被当作字面量传递给程序，导致参数解析错误。

解决方案 #

要让环境变量被正确解析，需要通过shell中转执行命令，将entrypoint改为shell调用的形式：

修改后的Bazel配置 #

oci_image(
    name = "move_data_image",
    base = "@python_base",
    entrypoint = [
        "/bin/sh",
        "-c",
        "/opt/python/dataflow/move_data --worker_image=$WORKER_IMAGE --max_num_workers=$MAX_NUM_WORKERS --runner=DataflowRunner"
    ],
    env = {
        "WORKER_IMAGE": "",
        "MAX_NUM_WORKERS": "-1",  # 环境变量均为字符串类型，统一用字符串值更规范
    },
    tars = [":move_data_layer"],
)

关键说明 #

• 选择/bin/sh还是/bin/bash取决于基础镜像@python_base中包含的shell类型，确保镜像内存在对应可执行文件。
• 这种方式和你之前Dockerfile的行为完全一致：通过shell解析环境变量后再传递给目标程序，支持在不同执行场景下通过修改环境变量调整参数值的需求。

内容的提问来源于stack exchange，提问作者Tony Liao