使用github 的 gh 指令, 在 repo 自動新增 tag 與 release

使用 GitHub CLI (gh) 自動化處理 tag 與 release 非常方便,這可以讓你在不離開終端機的情況下完成原本需要在網頁上點擊的操作。首先請確保你已經安裝 gh 並完成登入。

新增 Tag

雖然 gh 主要用於處理 GitHub 特有的功能,但新增 tag 通常建議直接使用 git 指令,再搭配 gh 進行後續操作。你可以先在本地建立標籤並推送到遠端。

git tag 1.0.0
git push origin 1.0.0

如果你想完全自動化,可以將這些指令寫在腳本中。

建立 Release

一旦 tag 存在於 GitHub 遠端,你就可以使用 gh release create 指令。最基本的用法是指定標籤名稱。

gh release create 1.0.0

如果你希望在建立時直接指定標題和說明內容,可以使用參數。

gh release create 1.0.0 --title "正式版更新" --notes "修正了已知錯誤並提升效能"

自動化與檔案上傳

在自動化流程中,你可能需要上傳編譯好的二進位檔或壓縮包,這時候只要在指令最後加上檔案路徑即可。

gh release create 1.0.0 ./dist/app.zip --generate-notes

加上 –generate-notes 參數會讓 GitHub 自動根據兩次 release 之間的 commit 紀錄產生說明內容。如果你在 CI/CD 環境中使用,記得確保環境變數中包含有效的 GITHUB_TOKEN。

常用參數說明

如果你想要建立的是預發佈版本,可以加上 –prerelease 參數。如果你想先建立草稿而不直接發佈,可以使用 –draft。

gh release create 1.0.1 --draft --title "開發中版本"

這組指令能幫你快速整合進 shell script 或 GitHub Actions,實現全自動的版號管理。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *