---
date: "2023-05-24T15:00:00+08:00"
slug: "comparison"
sidebar_position: 15
---

# 與GitHub Actions的對比

Gitea Actions 旨在與 GitHub Actions 相容，差異如下。

## 額外功能

<a id="absolute-action-urls"></a>
### Action URL絕對路徑

`uses:` 接受指向任意 Git 主機的絕對 URL，例如 `uses: https://gitea.com/actions/checkout@v4`。

<a id="action-prefixes"></a>
### Action 前綴

`uses:` 接受以下前綴：

- `self:` 參照您自己的 Gitea 實例，例如 `uses: self:owner/repo@v1` 或 `uses: self:owner/repo/.gitea/workflows/build.yml@v1`
- `builtin:` 執行 Gitea Runner 內建的 Action，無需下載，Job 映像檔中也不需要 Node，例如 `uses: builtin:checkout`

`builtin:checkout` 支援 `actions/checkout` 的 `repository`、`ref`、`token`、`path` 和 `fetch-depth` 輸入，預設值相同，其他輸入會使步驟失敗。

<a id="workflow-relative-actions"></a>
### 相對於工作流的 Actions

`$/` 參照工作流（或外層複合 Action）所在的儲存庫與提交，例如 `uses: $/.gitea/actions/build`。
與 `./` 不同，它不需要事先簽出程式碼。

### 使用Go編寫Actions

請參閱[建立 Go Actions](https://blog.gitea.com/creating-go-actions/)。

### 支援非標準的調度語法 @yearly, @monthly, @weekly, @daily, @hourly

`schedule` 也接受 `@yearly`、`@monthly`、`@weekly`、`@daily` 和 `@hourly`，[GitHub 則不支援](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#schedule)。

## 不支援的工作流語法

### `jobs.<job_id>.environment`

[`jobs.<job_id>.environment`](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idenvironment) 會被忽略。

### 複雜的`runs-on`

[`runs-on`](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idruns-on) 支援：

- 靜態字串：`runs-on: self-hosted`
- 標籤陣列：`runs-on: [linux, self-hosted]`
- 字串表達式：`runs-on: ${{ github.event_name == 'push' && 'ubuntu-latest' || 'self-hosted' }}`
- 包含表達式的陣列：`runs-on: [linux, "${{ github.event_name == 'push' && 'ubuntu-latest' || 'self-hosted' }}"]`

## 缺失的功能

### 套件儲存庫授權

`GITEA_TOKEN` 無法發佈到其所屬儲存庫的套件註冊表，例如無法推送 OCI 鏡像。
請改用個人存取權杖，參見[這個工單](https://github.com/go-gitea/gitea/issues/23642#issuecomment-2119876692)。

### 問題匹配器

[問題匹配器](https://github.com/actions/toolkit/blob/main/docs/problem-matchers.md)會被忽略。

### 為錯誤建立註釋

[錯誤註釋](https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#example-creating-an-annotation-for-an-error)會被忽略。

### 表達式

[表達式](https://docs.github.com/en/actions/learn-github-actions/expressions)支援 GitHub 的標準函式與上下文。

## 缺失的UI功能

### 預處理和後處理步驟

預處理和後處理步驟在 Job 日誌中沒有各自獨立的區塊。

### 服務步驟

服務步驟在 Job 日誌中沒有各自獨立的區塊。

## 不一樣的行為

### `permissions`和`jobs.<job_id>.permissions`

`permissions` 和 `jobs.<job_id>.permissions` 控制 `GITEA_TOKEN` 的權限，其權限受儲存庫與所有者設定的限制，對於來自 fork 的拉取請求和跨儲存庫存取還會進一步受限。
不支援 `statuses`、`checks`、`deployments`、`id-token`、`security-events` 和 `pages` 等 GitHub 專屬範圍，而 Gitea 另外提供 `code`、`releases`、`wiki` 和 `projects`。
請參閱 [Actions Job 令牌權限](token-permissions.md)。

### 下載Actions

未指定主機的 Actions，例如 `uses: actions/checkout@v4`，會從 `https://github.com` 下載，若 `[actions].DEFAULT_ACTIONS_URL` 為 `self`，則從您自己的實例下載。
請參閱[設定速查表](../../administration/config-cheat-sheet.md#actions-actions)。
其他來源請參閱 [Action URL絕對路徑](#absolute-action-urls)、[Action 前綴](#action-prefixes)和[相對於工作流的 Actions](#workflow-relative-actions)。

### 上下文可用性

不檢查[上下文可用性](https://docs.github.com/en/actions/learn-github-actions/contexts#context-availability)，因此 `env` 等上下文可以在更多地方使用。