能否基于GitHub Actions运行时数据修改GitHub Enterprise的运行标题？

AI 小北

2026-6-19

在GitHub Enterprise Actions中动态修改工作流运行标题

GitHub官方的run-name确实只能在工作流启动阶段确定，无法直接在运行过程中动态更新，但可以通过调用GitHub Enterprise API来实现修改运行标题的需求，具体步骤如下：

1. 配置工作流权限

首先需要为工作流分配修改Actions运行的权限，在Workflow文件顶部添加：

permissions:
  actions: write  # 必须，用于修改工作流运行信息
  contents: read  # 基础权限，按需调整

2. 生成动态标题内容

在工作流步骤中生成运行过程中才会产生的信息（比如构建版本、测试结果摘要等），并将其输出为环境变量供后续步骤使用：

- name: 生成动态标题
  id: gen-title
  run: |
    # 示例：基于运行编号和提交哈希生成标题
    DYNAMIC_CONTENT="构建版本 v1.0.${{ github.run_number }} | 提交哈希 ${{ github.sha:0:7 }}"
    echo "title=$DYNAMIC_CONTENT" >> $GITHUB_OUTPUT

3. 调用API更新运行标题

使用GITHUB_TOKEN调用GitHub Enterprise的API来修改当前运行的标题，推荐使用GitHub CLI（已预装在GitHub托管的运行器中）：

- name: 更新工作流运行标题
  run: |
    gh api \
      --method PATCH \
      -H "Accept: application/vnd.github+json" \
      /repos/${{ github.repository }}/actions/runs/${{ github.run_id }} \
      -f name="${{ steps.gen-title.outputs.title }}"
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

如果你的环境没有GitHub CLI，也可以用curl实现：

- name: 更新工作流运行标题（curl版）
  run: |
    curl -X PATCH \
      -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
      -H "Accept: application/vnd.github+json" \
      https://<你的GHE域名>/api/v3/repos/${{ github.repository }}/actions/runs/${{ github.run_id }} \
      -d '{"name": "${{ steps.gen-title.outputs.title }}"}'