---
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`等上下文可以在更多地方使用。