能否为GitHub Actions工作流运行添加日期标签？求替代方案

核心问题解答 #

GitHub Actions 不支持直接为工作流运行添加自定义标签，工作流运行的关联标识仅包含内置字段（如运行ID、分支、提交SHA、触发事件等），没有开放自定义标签的接口。

实用替代方案 #

1. 修改工作流运行名称为日期格式 #

通过GitHub API动态修改工作流运行的名称，将日期嵌入名称中，之后即可通过搜索框筛选特定日期的运行。

示例工作流步骤：

- name: 设置运行名称为日期格式
  uses: actions/github-script@v7
  with:
    script: |
      // 生成YYYY-MM-DD格式的日期
      const deployDate = new Date().toISOString().split('T')[0];
      // 调用API更新运行名称
      await github.rest.actions.updateWorkflowRun({
        owner: context.repo.owner,
        repo: context.repo.repo,
        run_id: context.runId,
        name: `生产部署 - ${deployDate}`
      });

操作后，在工作流运行页面的搜索框输入2024-01-01，即可筛选出当天的所有部署运行。

2. 为提交添加日期格式的Git标签 #

每次部署成功后，给当前提交打一个带日期的Git标签，既可以标记部署版本，也能通过标签筛选关联的工作流运行。

示例工作流步骤：

- name: 创建部署日期标签
  if: success()
  run: |
    # 生成YYYY-MM-DD格式日期
    DEPLOY_DATE=$(date +%Y-%m-%d)
    # 标签格式：prod-deploy-日期-运行序号（避免同一天多次部署重复）
    TAG_NAME="prod-deploy-${DEPLOY_DATE}-$(printf "%03d" $GITHUB_RUN_NUMBER)"
    # 创建带注释的标签
    git tag -a $TAG_NAME -m "生产部署于 ${DEPLOY_DATE}"
    # 推送标签到远程仓库
    git push origin $TAG_NAME

之后可以通过仓库的标签页面筛选日期标签，也能在工作流运行页面通过"关联标签"字段查找对应运行。

3. 仓库内维护部署日志文件 #

在仓库中新增一个部署日志文件（如deploy-log.json或deploy-history.md），每次部署成功后将运行信息写入文件并提交，实现可搜索的部署历史记录。

示例写入JSON日志的步骤：

- name: 记录部署日志
  if: success()
  run: |
    DEPLOY_DATE=$(date +%Y-%m-%d)
    # 构造日志条目
    LOG_ENTRY='{
      "run_id": "${{ github.run_id }}",
      "deploy_date": "'${DEPLOY_DATE}'",
      "commit_sha": "${{ github.sha }}",
      "branch": "${{ github.ref_name }}"
    }'
    # 初始化日志文件（若不存在）
    if [ ! -f deploy-log.json ]; then
      echo "[]" > deploy-log.json
    fi
    # 追加日志条目到JSON数组
    jq --argjson entry "$LOG_ENTRY" '. += [$entry]' deploy-log.json > temp.json && mv temp.json deploy-log.json

- name: 提交部署日志
  uses: stefanzweifel/git-auto-commit-action@v5
  with:
    file_pattern: deploy-log.json
    commit_message: "记录部署日志: ${DEPLOY_DATE}"

后续可直接在仓库中查看该文件，通过文本搜索筛选特定日期的部署，甚至可以基于该文件生成自定义的部署可视化页面。

4. 利用GitHub Environments的部署历史 #

如果已配置GitHub Environments（将生产环境单独设置），可以进入环境的部署历史页面，这里会按时间顺序展示所有部署记录，虽然没有直接的日期筛选功能，但可以通过滚动或浏览器的页面搜索（Ctrl+F）快速定位到目标日期的部署。

内容的提问来源于stack exchange，提问作者Joey Yi Zhao