如何从GitHub Action工作流向Docker Compose传递参数？

方法1：直接通过Shell环境变量传递 #

GitHub Action步骤中env块定义的变量会自动注入当前Shell环境，docker-compose执行时会直接读取Shell中的环境变量，无需额外重复赋值。

修改你的Action构建步骤：

- name: Build Compose Images
  env: 
    IMAGE_TAG: ${{ steps.preamble.outputs.releasetag }}
  run: docker compose -f compose.yaml build

docker-compose文件可简化（注：services.db.environment下的IMAGE_TAG是容器运行时变量，与构建镜像标签的变量无关，若构建阶段无需向Dockerfile传递该变量，可移除该配置）：

version: "3"
services:
  db:
    build: MySQL
    image: "repo/image:${IMAGE_TAG}"
    ports: 
     - '3306:3306'

方法2：通过.env文件传递 #

若需要更明确的变量管理，可在Action中动态生成.env文件，docker-compose默认会自动读取当前目录下的.env文件：

添加生成.env文件的步骤：

- name: Generate .env file
  run: echo "IMAGE_TAG=${{ steps.preamble.outputs.releasetag }}" > .env

- name: Build Compose Images
  run: docker compose -f compose.yaml build

docker-compose文件保持原有的变量引用即可，无需额外配置。

问题说明 #

你之前的写法run: IMAGE_TAG=${{env.IMAGE_TAG }} docker compose...逻辑本身正确，但可能因Shell变量展开优先级或docker-compose版本问题导致不生效。上述两种方法能避免此类问题，且更符合最佳实践。

内容的提问来源于stack exchange，提问作者2deviate