使用Bazel对OCI tarball执行container structure test失败求助

你遇到的错误核心原因有两点：

1. 格式不兼容：container_structure_test的tar驱动仅支持Docker Save格式的镜像tar包，而Aspect rules_oci的oci_tarball生成的是OCI规范格式的tar包，两者内部结构完全不同。
2. 规则检查逻辑：container_structure_test的内置规则在判断image目标时，无法识别oci_tarball类型的输出，触发了"必须是.tar文件"的校验错误。

方法1：切换为Docker驱动测试（推荐，实现最简单） #

通过docker_load将OCI tar包加载到Docker环境，再用Docker驱动执行结构测试：

# 在BUILD文件顶部添加rules_docker的加载语句
load("@rules_docker//docker:load.bzl", "docker_load")
load("@container_structure_test//:defs.bzl", "container_structure_test")
# ... 其他load语句保持不变 ...

# 添加docker_load目标，将OCI tar包加载到Docker
docker_load(
    name="loaded_genesis_image",
    tarball=":genesis_image_tarball",
)

# 修改container_structure_test配置
container_structure_test(
    name="genesis_image_tarball_test",
    configs=["genesis-test.yaml"],
    image=":loaded_genesis_image",
    driver="docker",  # 切换为docker驱动
)

方法2：转换OCI tar为Docker兼容格式（适用于必须用tar驱动的场景） #

通过genrule调用Docker命令，将OCI格式tar包转换为Docker Save格式：

genrule(
    name="docker_compatible_tar",
    srcs=[":genesis_image_tarball", "genesis-repo-tags.txt"],
    outs=["genesis_docker.tar"],
    cmd="""
        # 加载OCI镜像到Docker
        docker load < $(location :genesis_image_tarball)
        # 从tags文件读取镜像名称
        IMAGE_TAG=$(cat $(location genesis-repo-tags.txt))
        # 导出为Docker Save格式的tar包
        docker save "$${IMAGE_TAG}" -o $@
    """,
    tools=["@docker//:docker"],
)

container_structure_test(
    name="genesis_image_tarball_test",
    configs=["genesis-test.yaml"],
    image=":docker_compatible_tar",
    driver="tar",
)

方法3：显式引用OCI tarball的输出文件（尝试绕过规则校验） #

若container_structure_test仅检查文件扩展名，可直接引用oci_tarball生成的.tar文件路径：

container_structure_test(
    name="genesis_image_tarball_test",
    configs=["genesis-test.yaml"],
    image=":genesis_image_tarball.tar",  # 显式指定.tar后缀的输出文件
    driver="tar",
)

注意：此方法仅当规则仅校验扩展名时有效，若格式不兼容仍会执行失败。

• 确认目标输出：执行bazel query --output=files //abacus/genesis:genesis_image_tarball，查看生成的文件路径和实际格式。
• 检查tar包结构：构建完成后解压tar包，Docker Save格式包含manifest.json、layer.tar等文件；OCI格式包含index.json、blobs/目录等。
• 分析规则源码：找到external/container_structure_test~/bazel/container_structure_test.bzl文件，查看_structure_test_impl函数中校验tar文件的逻辑，明确规则对目标类型或格式的具体要求。

内容的提问来源于stack exchange，提问作者José Alvarado Torre