探索活動

已完成

事件是由工作流程定義中 子句上的 所實作。

有數種類型的事件可以觸發工作流程。

排程的事件

使用這種類型的觸發程式時,必須提供cron排程。

on:
    schedule:

        - cron: '0 8-17 * * 1-5'

Cron 排程是以五個值為基礎:

  • 分鐘數 (0 - 59)
  • 小時 (0 - 23)
  • 每月中的某一天(1 - 31)
  • 月 (1 - 12)
  • 一周中的一天 (0 - 6)

月份的別名是 JAN-DEC,星期的別名是 SUN-SAT。

通配符表示任何。 (* 是 YAML 中的特殊值,因此必須加上 cron 字串的引號)

因此,在上述範例中,排程會是星期一至星期五上午 8 點至下午 5 點。

程式事件

程式代碼事件會觸發大部分的動作。 當存放庫中發生感興趣的事件時,就會發生此事件。

on:
    pull_request

當發生拉取請求時,會觸發上述事件。

on:
    [push, pull_request]

當發生推送或拉取請求時,會觸發上述事件。

on:
    pull_request:
        branches:

            - develop

此事件顯示如何針對相關程式碼的 區段進行特定設定。

在此情況下,當在開發分支中建立拉取請求時會觸發。

手動事件

有一個用來手動觸發工作流程執行的獨特事件。 您應該使用 workflow_dispatch 事件。

您的工作流程必須位於存放庫的預設分支中。

Webhook 事件

呼叫 GitHub Webhook 時,可以執行工作流程。

on:
    gollum

當有人更新(或第一次建立)Wiki 頁面時,就會引發此事件。

外部事件

事件可以在 repository_dispatch上。 這允許事件從外部系統引發。

如需事件的詳細資訊,請參閱 觸發工作流程的事件