如何通过GitHub Actions编辑并存储GitHub Secrets中的版本变量？

核心限制说明 #

首先明确：GitHub Secrets在Workflow执行过程中是只读状态，无法直接通过Workflow里的命令修改或更新Secrets的值。你原本想直接在Actions里自增版本并写回Secrets的思路行不通，得换一种版本管理方案。

可行方案：用仓库文件存储版本号+自动更新+同步到Secrets（可选） #

下面是具体实现步骤：

1. 初始化版本文件 #

在仓库根目录创建一个VERSION文件，写入初始版本号，比如1.0.0。

2. 配置GitHub Actions Workflow #

修改你的Workflow文件（比如.github/workflows/deploy.yml），实现版本自增、构建镜像、更新版本文件并推回仓库，若需要同步到Secrets则用GitHub CLI（需额外配置权限）。

示例Workflow代码：

name: Deploy to DockerHub
on:
  push:
    branches: [ main ]

env:
  REPO: your-dockerhub-username/your-repo-name  # 替换为你的DockerHub仓库名

jobs:
  build-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Read current version
        id: get_version
        run: echo "version=$(cat VERSION)" >> $GITHUB_OUTPUT

      - name: Increment version (补丁版本自增，如1.0.0→1.0.1)
        id: increment_version
        run: |
          CURRENT_VERSION=${{ steps.get_version.outputs.version }}
          NEW_VERSION=$(echo $CURRENT_VERSION | awk -F. -v OFS=. '{$NF++; print}')
          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
          echo $NEW_VERSION > VERSION  # 更新本地VERSION文件

      - name: Build Docker Image
        run: |
          docker build -t ${{ env.REPO }}:${{ steps.increment_version.outputs.new_version }} \
                       -t ${{ env.REPO }}:${GITHUB_SHA::8} \
                       -t ${{ env.REPO }}:latest .

      - name: Push Docker Image to DockerHub
        run: |
          echo "${{ secrets.DOCKERHUB_TOKEN }}" | docker login -u "${{ secrets.DOCKERHUB_USERNAME }}" --password-stdin
          docker push -a ${{ env.REPO }}

      - name: Commit and push updated version file
        run: |
          git config --global user.name "GitHub Actions Bot"
          git config --global user.email "actions@github.com"
          git add VERSION
          git commit -m "Bump version to ${{ steps.increment_version.outputs.new_version }}"
          git push

      # 可选：若必须同步版本号到GitHub Secrets，需配置GitHub CLI权限
      - name: Update VERSION Secret (可选)
        if: github.ref == 'refs/heads/main'
        run: |
          gh secret set VERSION --body "${{ steps.increment_version.outputs.new_version }}"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

3. 必要的权限配置 #

• 若要执行git push，需确保Workflow的GITHUB_TOKEN有写权限：在仓库的「Settings → Actions → General → Workflow permissions」里，选择「Read and write permissions」。
• 若要更新Secrets（可选步骤），GITHUB_TOKEN需要有admin:repo_hook权限，或者直接用拥有仓库管理员权限的Personal Access Token（PAT）替换GH_TOKEN。

替代方案：用GitHub Release标签管理版本 #

如果不想维护版本文件，也可以直接用GitHub的Release标签作为版本号：

• 在Workflow里触发Release时，获取标签名作为版本号。
• 或者每次推送后自动创建带版本号的Release，用Release的tag作为Docker镜像的标签。

示例代码片段：

- name: Get release version
  id: get_release_version
  run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT

- name: Build Docker Image
  run: docker build -t ${{ env.REPO }}:${{ steps.get_release_version.outputs.version }} -t ${{ env.REPO }}:${GITHUB_SHA::8} .

关键注意事项 #

• 不要在Workflow里直接尝试修改GitHub Secrets，这是官方限制的操作，只能通过GitHub API或CLI在拥有足够权限的情况下更新。
• 版本自增的逻辑可根据需求调整：比如主版本、次版本、补丁版本的自增，可通过脚本实现更复杂的规则。

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