gitea-actions

Gitea Actions 与 act_runner

补充说明

Gitea Actions 兼容 GitHub Actions 的工作流语法，由 act_runner 执行。工作流可放在 .gitea/workflows/，也可复用 .github/workflows/。

常用示例

act_runner --version
act_runner register --no-interactive \
  --instance https://gitea.example.com \
  --token "$RUNNER_TOKEN" \
  --labels ubuntu-latest:docker://node:20
act_runner daemon
act_runner exec -j test

工作流：

name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

易错点与排错

• 不是所有 GitHub Actions 特性都兼容；依赖 GitHub 专属上下文或服务的 action 可能失败。
• Runner 的 labels 必须和 runs-on 匹配；不匹配时 job 一直等待。
• .gitea/workflows/ 和 .github/workflows/ 的发现规则要确认；重复定义会产生歧义。
• Runner token 来自 Gitea 管理界面；用错实例或过期 token 会注册失败。
• 自托管环境的网络要能拉取 action 和镜像；内网需要镜像代理。
• secrets 在 fork PR 中默认不可用；不要假设和 GitHub 行为完全一致。
• act_runner 版本要和 Gitea 版本匹配；升级后重新验证。
• Docker 执行器需要访问 Docker socket；权限和隔离策略要单独设计。

相关命令

• github-actions — 工作流语法参考
• act — 本地运行工作流
• woodpecker — 另一种自托管 CI