SuperAPI AI 工具集

dotnet-cli-release-pipeline

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 .NET CLI 工具搭建统一的发布 CI/CD 流水线,从单个版本标签触发,产出全部发行格式。基线假设 .NET 8.0+,示例使用 GitHub Actions 工作流语法 v2,模式可迁移到其他 CI 系统。

主要能力:标签触发的发布工作流;按运行时标识符(RID)的构建矩阵;CI 作业间的制品暂存;带 SHA-256 校验和的 GitHub Releases;自动创建 Homebrew formula 与 winget 清单 PR;基于 git 标签的 SemVer 版本策略。

版本策略:以 SemVer 加 git 标签为唯一版本来源,标签格式 v{major}.{minor}.{patch},例如: git tag -a v1.2.3 -m "Release v1.2.3" git push origin v1.2.3 版本从标签提取后传入 dotnet publish /p:Version=1.2.3,嵌入二进制并写入各包清单。预发布标签(如 v1.3.0-rc.1)仍创建 GitHub Release 为预发布,但跳过包管理器提交。

构建矩阵:每个 RID 一个制品,在对应 runner 上运行,如 linux-x64、linux-arm64、osx-arm64、win-x64;可选扩展 osx-x64、linux-musl-x64。托管构建支持在 x64 runner 上交叉编译 linux-arm64;Native AOT 交叉编译需 ARM64 工具链;macOS ARM64 不支持从 Linux 交叉编译。

制品与发布:各矩阵作业以 release-{rid} 名称上传制品,发布作业用 actions/download-artifact@v4 的 merge-multiple 合并下载,生成 checksums-sha256.txt,再用 softprops/action-gh-release@v2 创建 Release 并附上压缩包与校验和。

包管理器更新:发布后自动更新 Homebrew tap、winget-pkgs、Scoop bucket,通过 peter-evans/create-pull-request@v6 等创建 PR,均以稳定版本为条件。

安全与限制:需配置 NUGET_API_KEY、TAP_GITHUB_TOKEN、WINGET_GITHUB_TOKEN、SCOOP_GITHUB_TOKEN、CHOCO_API_KEY 等密钥;权限最小化为 contents: write,禁止 write-all;生产环境应将第三方 action 固定到 commit SHA。bash 步骤须用 set -euo pipefail;不要硬编码 .NET 版本路径;不要跳过预发布检测;merge-multiple 需 v4 版本;中间制品设置 retention-days: 1。范围外内容:通用 CI/CD 模式、Native AOT 配置、分发策略、包格式细节、容器镜像发布,分别参见对应技能。