官方文件

Understanding GitHub Actions - GitHub Docs

專有名詞

1. Workflow: 一個你定義的工作流程。
   • 當指定的 event 被觸發時便會啟動 workflow；也可以手動觸發 workflow
   • 通常一份 .yml 就是一個 workflow， .yml 要放在 /github/workflows 路徑下
2. Event: 觸發事件。
   • 可能是指偵測到新的 issue、或新的 PR。我們會指定當某事件發生時要執行某 workflow
   • 執行新 workflow 時會啟動一個全新的 Runner
3. Job: 工作。
   • 一個 workflow 內會指派多個工作 (Job)
   • 多個工作之間可以是同時進行，也可以是順序執行的。預設是同時進行
   • 一個工作底下有多個步驟，所有步驟只能在同個 Runner 底下執行
   • 不同的 Job 使用不同 Runner，不能指定要使用同一個 Runner
4. Step: 步驟。
   • 一個工作內包含多個步驟，每個步驟可能是去做某件事 (action)，或是執行某腳本 (script)
   • 因為步驟都在同個 Runner 底下執行，所以步驟之間可以共享機台內的資料
5. Action: (不知道怎麼翻譯，行動??)
   • 看起來只是執行一行指令，實際上這是 Github 已經幫你寫好的腳本，背後去執行很複雜的動作。你也可以寫屬於自己的 action

觸發時機 — on

任何時刻都能觸發 Github Action，只要你有先設定好指令，例如：

1. 有人發送 issue 時
2. 有人發送 PR 時
3. 有人 fork 專案時
4. 有人 push new commit 時
5. 總共有哪些時機可以使用，可以看官方文件

• 實際例子：當 push 或 PR 到 main

  on:
  	push:
  		branches: [ main ]
  	pull_request:
  		branches: [ main ]
  

詳細：on 的一百個哲學

On 的哲學