GitHub Action 自动生成tag

### 使用 GitHub Actions 自动生成 Tag 的教程 GitHub Actions 可以通过配置工作流文件来实现自动化的任务，例如生成版本标签（tag）。以下是一个完整的教程和配置示例，帮助用户实现这一目标。 #### 1. 自动生成 Tag 的基本原理 GitHub Actions 的核心是事件驱动机制。通过监听特定的事件（如 `push` 或 `pull_request`），可以触发一系列操作。生成 tag 的关键步骤包括： - 检测代码仓库中的最新提交。 - 根据规则生成新的版本号。 - 创建并推送一个新的 Git tag 到远程仓库。 此过程可以通过多个 action 实现，例如 `actions/checkout` 和自定义脚本[^1]。 #### 2. 配置 Workflow 文件 在 `.github/workflows/` 目录下创建一个新的 YAML 文件，例如 `auto-tag.yml`。以下是生成 tag 的完整示例： ```yaml name: Auto Generate Tag on: push: branches: - main # 监听 main 分支的推送事件 jobs: generate-tag: runs-on: ubuntu-latest steps: - name: Checkout Repository uses: actions/checkout@v4 - name: Get Latest Tag id: get_latest_tag run: | latest_tag=$(git describe --tags --abbrev=0) echo "latest_tag=$latest_tag" >> $GITHUB_ENV - name: Increment Version id: increment_version run: | latest_tag=${{ env.latest_tag }} if [ -z "$latest_tag" ]; then new_version="v1.0.0" else major=$(echo $latest_tag | cut -d'.' -f1) minor=$(echo $latest_tag | cut -d'.' -f2) patch=$(echo $latest_tag | cut -d'.' -f3) new_patch=$((patch + 1)) new_version="${major}.${minor}.${new_patch}" fi echo "new_version=$new_version" >> $GITHUB_ENV - name: Create New Tag run: | git config --global user.name "GitHub Actions" git config --global user.email "[email protected]" git tag ${{ env.new_version }} git push origin ${{ env.new_version }} ``` #### 3. 工作流详解 - **Checkout Repository**: 使用官方提供的 `actions/checkout` 动作检出代码仓库[^2]。 - **Get Latest Tag**: 通过 `git describe` 命令获取最新的 Git tag，并将其存储到环境变量中。 - **Increment Version**: 根据现有的最新 tag 自动递增版本号。如果不存在任何 tag，则默认从 `v1.0.0` 开始。 - **Create New Tag**: 创建新的 tag 并推送到远程仓库。这里需要设置 Git 的用户名和邮箱信息，以便推送成功[^3]。 #### 4. 注意事项 - 确保仓库中已经启用了 Git tag 功能。 - 如果需要更复杂的版本控制规则（如语义化版本管理 SemVer），可以引入第三方工具或脚本[^4]。 - 在实际使用中，可以根据需求调整监听的分支或事件类型。 ###