如何在GitHub Actions中读取YAML/JSON文件动态传递API镜像标签？

核心思路 #

通过GitHub Actions的环境变量/输出变量传递镜像标签，结合yq工具修改类Helm values.yaml配置文件，打造通用化CI/CD流程。

具体实现步骤 #

1. 生成并传递镜像标签 #

在Workflow中根据提交哈希、分支名或版本号生成镜像标签，通过输出变量传递给后续步骤：

jobs:
  build-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 设置镜像标签
        id: set-tag
        run: |
          # 示例：用短提交哈希作为标签，可替换为版本号、分支名等
          TAG=$(git rev-parse --short HEAD)
          echo "image_tag=$TAG" >> $GITHUB_OUTPUT

2. 安装YAML修改工具yq #

GitHub Actions的Ubuntu环境可直接安装：

- name: 安装yq
  run: sudo apt-get install yq -y

3. 修改values.yaml中的镜像标签 #

假设你的values.yaml结构如下：

api:
  image:
    tag: "latest" # 需要替换的目标标签

添加步骤用yq替换标签：

- name: 更新values.yaml中的镜像标签
  run: |
    yq eval '.api.image.tag = "${{ steps.set-tag.outputs.image_tag }}"' -i ./path/to/values.yaml

4. 验证修改结果（可选） #

添加步骤确认标签替换是否成功：

- name: 验证修改后的values.yaml
  run: cat ./path/to/values.yaml

通用化扩展方案 #

• 支持自定义输入标签：通过Workflow输入参数让标签可手动指定，适配不同场景：

on:
  workflow_dispatch:
    inputs:
      api_image_tag:
        description: 'API服务镜像标签'
        required: true
        default: 'latest'

后续步骤直接使用${{ github.event.inputs.api_image_tag }}作为标签值。

• 联动Docker构建：将生成的标签直接用于Docker镜像构建，再同步到values.yaml：

- name: 构建Docker镜像
  run: |
    docker build -t my-api:${{ steps.set-tag.outputs.image_tag }} ./api

内容的提问来源于stack exchange，提问作者Sunil N