GitHub Release终极指南：3分钟掌握命令行发布神器

GitHub Release终极指南3分钟掌握命令行发布神器【免费下载链接】github-releaseCommandline app to create and edit releases on Github (and upload artifacts)项目地址: https://gitcode.com/gh_mirrors/gi/github-release还在为GitHub版本发布而烦恼吗每次都要登录网页、点击多个界面、手动上传文件今天我要分享一个GitHub Release命令行工具的完整教程让你在3分钟内掌握这个高效的发布神器彻底告别繁琐的手动操作 为什么你需要这个GitHub发布工具想象一下这样的场景你刚刚完成了一个重要的版本更新代码已经推送到GitHub现在需要创建一个正式发布。传统方式需要登录GitHub网站导航到仓库的Release页面点击Draft a new release填写版本信息手动上传编译好的二进制文件等待上传完成整个过程耗时又容易出错。而使用github-release命令行工具这一切都可以在终端中一键完成小贴士这个工具特别适合CI/CD流程可以自动化整个发布过程让你的开发工作流更加顺畅。 快速安装两种方式任选方法一Go环境一键安装最简单如果你已经安装了Go环境安装过程就像喝水一样简单go install github.com/github-release/github-release这条命令会自动从GitHub下载源码、编译并安装完成后你就能在终端直接使用github-release命令了。方法二预编译二进制文件没有Go环境没关系你可以直接下载预编译好的二进制文件# Linux用户 wget https://gitcode.com/gh_mirrors/gi/github-release/releases/latest/download/github-release-linux-amd64 # macOS用户 wget https://gitcode.com/gh_mirrors/gi/github-release/releases/latest/download/github-release-darwin-amd64 # 添加执行权限 chmod x github-release-* # 移动到PATH目录 sudo mv github-release-* /usr/local/bin/github-release 配置GitHub访问令牌在使用之前你需要一个GitHub访问令牌来授权工具操作你的仓库登录GitHub进入Settings → Developer settings → Personal access tokens点击Generate new token至少勾选repo权限包含所有仓库权限生成并复制令牌将令牌设置为环境变量这样每次使用就不需要重复输入了export GITHUB_TOKEN你的令牌 # 永久保存到bashrc echo export GITHUB_TOKEN你的令牌 ~/.bashrc 创建你的第一个GitHub Release场景一发布稳定版本假设你刚刚完成v1.0.0版本的开发现在要创建一个正式的发布# 首先确保标签已经推送到GitHub git tag v1.0.0 git push origin v1.0.0 # 创建正式发布 github-release release \ --user 你的用户名 \ --repo 你的仓库名 \ --tag v1.0.0 \ --name v1.0.0 稳定版 \ --description 这是我们的第一个稳定版本包含以下重要更新 - 新增用户认证系统 - 优化数据库查询性能 - 修复了10个已知bug场景二上传发布文件发布创建后你需要上传编译好的二进制文件# 上传单个文件 github-release upload \ --user 你的用户名 \ --repo 你的仓库名 \ --tag v1.0.0 \ --name app-v1.0.0-linux-amd64 \ --file ./dist/app-linux-amd64 # 批量上传多个文件 for file in ./dist/*; do github-release upload \ --user 你的用户名 \ --repo 你的仓库名 \ --tag v1.0.0 \ --name $(basename $file) \ --file $file done 高级功能编辑和删除发布编辑现有发布有时候发布后才发现描述有误或者需要更新发布信息# 修改发布标题和描述 github-release edit \ --user 你的用户名 \ --repo 你的仓库名 \ --tag v1.0.0 \ --name v1.0.0 重大更新版 \ --description 修复了发布说明中的拼写错误更新了安装指南删除不需要的发布如果创建了错误的发布可以轻松删除github-release delete \ --user 你的用户名 \ --repo 你的仓库名 \ --tag v1.0.0 查看发布信息想要查看仓库的所有标签和发布信息github-release info \ --user 你的用户名 \ --repo 你的仓库名这会显示所有git标签和对应的发布信息包括发布名称和描述发布日期和时间是否为草稿或预发布版上传的文件列表和下载次数️ 集成到CI/CD流程GitHub Actions自动化发布创建一个.github/workflows/release.yml文件name: Release on: push: tags: - v* jobs: release: runs-on: ubuntu-latest steps: - uses: actions/checkoutv2 - name: Set up Go uses: actions/setup-gov2 with: go-version: 1.19 - name: Install github-release run: go install github.com/github-release/github-release - name: Build project run: go build -o myapp ./cmd/myapp - name: Create GitHub Release env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | github-release release \ --user ${{ github.repository_owner }} \ --repo ${{ github.event.repository.name }} \ --tag ${{ github.ref_name }} \ --name Release ${{ github.ref_name }} \ --description Automated release via GitHub Actions - name: Upload binaries env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | github-release upload \ --user ${{ github.repository_owner }} \ --repo ${{ github.event.repository.name }} \ --tag ${{ github.ref_name }} \ --name myapp-${{ github.ref_name }}-linux-amd64 \ --file myapp 实用技巧和最佳实践1. 语义化版本控制遵循语义化版本规范让你的用户更容易理解版本变化# 主版本号不兼容的API修改 github-release release --tag v2.0.0 # 次版本号向下兼容的功能性新增 github-release release --tag v1.1.0 # 修订号向下兼容的问题修正 github-release release --tag v1.0.12. 预发布版本管理对于还在测试中的版本使用预发布标记# 创建预发布版本 github-release release \ --tag v1.0.0-rc.1 \ --name v1.0.0 候选版本 1 \ --pre-release3. 企业级GitHub支持如果你使用的是GitHub Enterprise只需设置环境变量export GITHUB_APIhttp://github.company.com/api/v3 常见问题解答Q: 为什么我的上传失败了A: 检查以下几点GITHUB_TOKEN环境变量是否正确设置令牌是否具有足够的权限至少需要repo权限标签是否已经推送到GitHub远程仓库Q: 可以上传哪些类型的文件A: 支持所有类型的文件二进制文件、文档、配置文件、安装脚本等。Q: 如何更新已上传的文件A: 目前需要先删除文件再重新上传或者创建一个新的发布版本。Q: 支持私有仓库吗A: 完全支持只要你的令牌有相应权限。 开始你的自动化发布之旅现在你已经掌握了GitHub Release命令行工具的所有核心功能。无论是个人项目还是团队协作这个工具都能显著提升你的发布效率。记住好的工具不仅要会用还要用得巧。结合CI/CD流程你可以实现完全自动化的发布管道让版本发布变得像推送代码一样简单。立即尝试创建你的第一个自动化发布体验命令行带来的高效与便捷吧【免费下载链接】github-releaseCommandline app to create and edit releases on Github (and upload artifacts)项目地址: https://gitcode.com/gh_mirrors/gi/github-release创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考