如何正确将GitHub Action中的变量传递至Docker容器？

1. 修正docker/build-push-action@v1的args参数格式 #

v1版本的args参数要求以空格分隔的键值对或数组形式传递，单个KEY=VALUE字符串可能因YAML解析问题不生效。调整为以下两种写法之一：

# 写法1：数组形式
args:
  - SOFTWARE_VERSION=${{ steps.vars.outputs.tag }}

# 写法2：带引号的字符串形式
args: "SOFTWARE_VERSION=${{ steps.vars.outputs.tag }}"

2. 确认steps.vars.outputs.tag的有效性 #

在构建步骤前添加调试环节，验证tag变量是否存在有效值：

- name: 验证tag值
  run: echo "当前tag值：${{ steps.vars.outputs.tag }}"

如果输出为空，需先修复vars步骤的tag生成逻辑，确保能正确获取提交标签。

3. 检查Dockerfile中ARG的作用域 #

ARG指令的作用域默认局限于当前构建阶段（多阶段构建场景），若你的Dockerfile包含多个阶段，需在每个需要使用该变量的阶段重新声明ARG SOFTWARE_VERSION。同时ENV引用ARG可简化写法：

ARG SOFTWARE_VERSION
ENV SOFTWARE_VERSION=$SOFTWARE_VERSION

4. docker-compose运行的影响排查 #

• 若直接拉取已构建好的镜像，docker-compose默认会继承镜像内的ENV变量，无需额外配置；
• 若docker-compose.yml中重新定义了SOFTWARE_VERSION环境变量，会覆盖镜像原有值，需检查compose文件是否存在相关配置；
• 若用docker-compose重新构建，需在build配置中显式传递ARG：

services:
  app:
    build:
      context: frontend/
      args:
        SOFTWARE_VERSION: ${TAG_VALUE}

快速验证方法 #

拉取构建后的镜像，直接运行容器查看环境变量：

docker run --rm my_repo/my_image:develop env | grep SOFTWARE_VERSION

若此处能看到正确值，说明镜像构建无问题，问题大概率出在docker-compose的配置或运行逻辑上。

内容的提问来源于stack exchange，提问作者Karol Borkowski