36 lines
2.1 KiB
YAML
36 lines
2.1 KiB
YAML
# =============================================================================
|
||
# 用途：CD（Continuous Delivery）持續交付 workflow。
|
||
# 當有 commit push 到 master 分支時觸發，呼叫 release-tag-version
|
||
# composite action 進行「釋出並標註正式成品版本」（建立 release / 打 tag），
|
||
# 將 master 上的成果標記為一個正式可發布的版本。
|
||
# 更新日期：2026/06/29 14:18:26
|
||
# =============================================================================
|
||
|
||
# workflow 顯示名稱，會出現在 Gitea Actions 的 workflow 清單與執行紀錄中，方便辨識。
|
||
name: CD
|
||
# 觸發條件：監聽 push 事件。
|
||
on:
|
||
push:
|
||
# 只在指定分支發生 push 時觸發，避免其他分支誤觸發正式釋出流程。
|
||
branches:
|
||
# 僅限 master 分支：master 視為正式（穩定）分支，push 進來代表要正式釋出成品版本。
|
||
- master
|
||
# 此 workflow 包含的 job 清單。
|
||
jobs:
|
||
# job 識別碼：release-tag-version，負責釋出並標註成品版本。
|
||
release-tag-version:
|
||
# job 顯示名稱，呈現於 Actions 執行畫面，便於辨識此 job 的職責。
|
||
name: Release Tag Version
|
||
# 指定執行此 job 的 runner 標籤；使用 ubuntu runner 執行後續步驟。
|
||
runs-on: ubuntu
|
||
# 此 job 的執行步驟序列。
|
||
steps:
|
||
# 步驟名稱：釋出並標註成品版本（建立 release / 打版本 tag）。
|
||
- name: 釋出並標註成品版本
|
||
# 呼叫外部 composite action「release-tag-version」執行實際的釋出與 tag 標註邏輯。
|
||
# 版本以變數 vars.ACTION_RELEASE_TAG_VERSION 釘選，確保使用指定版本的 action，
|
||
# 避免上游 action 變動造成釋出行為不可預期。
|
||
# 副作用：此步驟會在遠端建立 release 或推送版本 tag（正式釋出動作）。
|
||
# 需人工確認：vars.ACTION_RELEASE_TAG_VERSION 變數需在 repo / org 層級正確設定，否則 action 解析會失敗。
|
||
uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}
|