# =============================================================================
# 用途：Gitea CD（持續部署）workflow
#   當有變更 push 到 master 分支時，自動釋出並標註（tag）一個成品版本。
# 更新日期：2026/06/26 11:34:46
# =============================================================================

# workflow 名稱，顯示於 Gitea Actions 介面
name: CD
# 觸發條件設定
on:
  # 以 push 事件觸發
  push:
    # 限定觸發的分支
    branches:
    # 只有當變更 push 到 master 分支時才會啟動此 workflow（CD 釋出版本）
    - master
# 此 workflow 包含的工作（jobs）
jobs:
  # job 識別碼：負責釋出並標註版本
  release-tag-version:
    # job 在 Gitea Actions 介面上顯示的名稱
    name: Release Tag Version
    # 指定執行此 job 的 runner 標籤（ubuntu runner）
    runs-on: ubuntu
    # 此 job 的執行步驟清單
    steps:
    # 步驟名稱（中文）：釋出並標註成品版本
    - name: 釋出並標註成品版本
      # 引用外部 composite action 來執行釋出與標註版本的流程；
      # @ 後方版本由 Gitea 變數 vars.ACTION_RELEASE_TAG_VERSION 動態指定，便於統一管理版本。
      uses: https://gitea.jsc.idv.tw/composite-actions/release-tag-version@${{ vars.ACTION_RELEASE_TAG_VERSION }}