docs(README): 補充測試標籤參數用法

This commit is contained in:
2026-06-26 15:07:00 +00:00
parent 21ab5c1487
commit 265049a96f
+5 -3
View File
@@ -1,6 +1,6 @@
# Release Tag Version
更新時間:2026/06/26 10:47:20
更新時間:2026/06/26 10:56:00
本專案為 Gitea Actions 的 **composite action**,用來自動計算版本號、建立 release 並標註對應 tag,最後清理舊成品。
@@ -43,6 +43,8 @@ steps:
with:
# files 為非必填;指定要隨 release 一起釋出(上傳)的成品檔案,可省略。
files: dist/*
# is_debug 為非必填;設為 true 時,會轉傳給 calculate-version 產生測試標籤版本。
is_debug: 'false'
```
### 本 repo 內的 CD workflow`.gitea/workflows/cd.yaml`
@@ -68,7 +70,7 @@ jobs:
引用後,composite action 會依序執行:
1. **版本號計算**:呼叫 `docker-actions/calculate-version` 算出本次版本號。
1. **版本號計算**:呼叫 `docker-actions/calculate-version` 算出本次版本號,並轉傳 `is_debug` 以支援測試標籤版本
2. **組合釋出參數**:版本號非空時,組出 release 的 `name`(格式 `<repo 名稱> v<版本>`)與 `tag_name`(格式 `v<版本>`)。
3. **檢查版本號輸出**:版本號為空時輸出錯誤訊息並 `exit 1`,中止流程,避免建立錯誤的 release/tag。
4. **釋出並標註成品版本**:以 `akkuman/gitea-release-action` 建立 release 並打 tag,附帶 `files` 指定的成品。
@@ -78,4 +80,4 @@ jobs:
- 變數 `vars.ACTION_CALCULATE_VERSION``vars.ACTION_GITEA_RELEASE_VERSION``vars.ACTION_RELEASE_CLEANUP_VERSION``vars.ACTION_CHECKOUT_VERSION` 皆需設定且值有效。
- runner 需有 `ubuntu` label。
- 預期結果:在 Gitea 上建立 `v<版本>` 的 release 與 tag,並清理舊成品。
- 預期結果:在 Gitea 上建立 `v<版本>` 的 release 與 tag`is_debug``true` 時使用測試標籤版本,最後清理舊成品。