🚀 GitHub Actions Workflow 產生器

視覺化設定 CI/CD 流程，自動產生 GitHub Actions YAML 設定檔。支援 Node.js、Python、Docker、GitHub Pages 等常見範本，無需手動撰寫 YAML，點選即可下載。

什麼是 GitHub Actions 設定產生器？

GitHub Actions 設定產生器讓你以視覺化方式設定 CI/CD 流程，自動產生 GitHub Actions 的 YAML 設定檔。CI/CD 能在你每次推送程式時自動執行測試、建置與部署，但 YAML 語法縮排敏感、容易寫錯，這個工具幫你正確產生工作流程設定。

你只要選擇觸發條件、執行環境與步驟，工具就會產生可放進 .github/workflows 的設定檔，降低語法出錯的機會。

適用情境

• 為專案建立自動測試與建置流程
• 設定推送或 PR 時觸發的 CI 工作流程
• 產生自動部署的 workflow 設定
• 學習 GitHub Actions 的 YAML 結構

如何使用

1. 選擇觸發條件（push、pull_request 等）。
2. 設定執行環境與要執行的步驟。
3. 工具即時產生 GitHub Actions YAML。
4. 把設定檔放進專案的 .github/workflows 目錄。

使用技巧

• YAML 對縮排極敏感，用工具產生比手寫更不易出錯。
• 先從簡單的測試流程開始，確認跑通再加上部署等步驟。
• 善用快取（cache）加速相依套件安裝。
• 機密（如部署金鑰）用 GitHub Secrets，別寫死在 YAML 裡。

名詞解釋

CI/CD

持續整合與持續部署，自動化測試、建置與發布的流程。

Workflow

GitHub Actions 中由觸發條件與步驟組成的自動化流程。

YAML

以縮排表示結構的設定檔格式，GitHub Actions 採用。

常見問題 FAQ

生成的 YAML 可以直接用於 GitHub Actions 嗎？

是的。將下載的 .yml 檔案放入專案根目錄的 .github/workflows/ 資料夾，推送至 GitHub 後即會自動觸發。建議先在測試分支驗證工作流程是否符合預期再合入主分支。

如何安全地使用 Secrets（密鑰）？

在本工具中勾選「Secret」的環境變數，會以 ${{ secrets.KEY_NAME }} 格式輸出，實際密鑰值需到 GitHub Repo → Settings → Secrets and variables → Actions 中新增。切勿將密鑰直接寫入 YAML 檔案。

排程 Cron 的時區是哪裡？

GitHub Actions 的 Cron 排程採用 UTC 時間。台灣時間（UTC+8）需減去 8 小時。例如台灣時間每天早上 9 點，對應 UTC 01:00，Cron 表達式為 0 1 * * *。

如何在 Workflow 中使用矩陣測試多個 Node.js 版本？

在 Node.js CI 範本中，matrix.node-version 陣列可加入多個版本號（如 [18.x, 20.x, 22.x]）。GitHub Actions 會為每個版本並行執行一次完整的 build 流程，確保程式在不同環境下都能運行。可在本工具下載 YAML 後手動修改 strategy.matrix 欄位。

產生的設定檔放哪裡？

放進專案的 .github/workflows 目錄（如 ci.yml）。GitHub 會自動偵測並依設定的觸發條件執行工作流程。

為什麼用工具而不手寫 YAML？

YAML 對縮排極敏感，一個空格錯誤就可能讓整個流程失效。視覺化設定能大幅降低語法出錯的機會。

機密資訊怎麼處理？

部署金鑰、密碼等請存進 GitHub Secrets，並在 YAML 中以變數引用，切勿把機密直接寫死在設定檔裡。

資料會上傳嗎？

不會。設定檔在你的瀏覽器本機產生，內容不會上傳或儲存。