2.9 KiB

Raw Blame History

Workflow

本目录包含 Gitea Actions 的自动化工作流示例，展示如何使用 Gitea Actions 实现 CI/CD 自动化。

📂 文件结构

.gitea/workflows/
├── changelog-and-release.yml    # CHANGELOG 生成 + Release 创建
└── ...                          # 更多 workflow 待添加

🎯 功能列表

✅ 已实现

1. 📦 自动发布工作流 (`changelog-and-release.yml`)

功能：在推送 tag 时自动生成 CHANGELOG 并创建 Release

特性：

🏷️ 自动识别语义版本号（SemVer）
📝 智能生成 CHANGELOG 条目
🔄 支持多个开发版本内容叠加
👥 自动提取贡献者列表
🚀 创建 GitHub/Gitea Release
📎 上传附件到 Release
🏷️ 自动识别 Pre-release 标记

触发方式：

git tag 1.0.0
git push origin 1.0.0

文件：changelog-and-release.yml

💡 详细配置：查看 changelog-and-release.yml 文件顶部的 env 区域，所有配置项都有详细注释说明

🔜 待扩展

更多自动化场景：

🧪 自动测试 - 推送代码时运行单元测试
🏗️ 自动构建 - 构建并发布 Docker 镜像
📊 代码质量 - 运行代码检查和静态分析
🌐 自动部署 - 部署到生产环境
📧 通知集成 - 发送构建结果到 Slack/邮件
🔐 安全扫描 - 依赖漏洞扫描

❓ 常见问题

Q1: 如何配置 Token？

步骤：

Gitea → 设置 → 应用 → 生成新令牌
权限：勾选 repo
仓库 → Settings → Actions → Secrets → 添加 Secret
名称：WORKFLOW，值：你的 Token

💡 提示：一个 Token 即可完成所有操作（Git + API）

Q2: `changelog_and_release` 没有触发？

检查清单：

Workflow 文件在 .gitea/workflows/ 目录
文件名正确（如 changelog-and-release.yml）
Token 已正确配置（Secret 名称为 WORKFLOW）
Tag 格式正确（数字开头，如 1.0.0）
Gitea Actions 已启用
Runner 正常运行

Q3: `changelog_and_release` 版本号格式有要求吗？

推荐使用语义化版本号（SemVer）：

✅ 推荐格式：
1.0.0           # 正式版本
1.0.0-beta1     # 预发布版本

❌ 不推荐：
v1.0.0          # 不要使用 v 前缀
1.0.0-b1        # 后缀要完整

详细规范请参考 workflow 文件中的注释说明。

Q4: 如何查看执行日志？

仓库 → Actions → 点击对应的 workflow 运行记录 → 查看详细日志

Q5: Token 权限不足怎么办？

确保 Token 具有以下权限：

✅ repo - 完整仓库访问权限
- 用于读取代码
- 用于推送提交
- 用于创建 Release

如果还是失败，尝试重新生成 Token。

🤝 贡献

欢迎提交更多实用的 Workflow 示例！

2.9 KiB Raw Blame History Unescape Escape