体验 Gitea Actions

即将推出的 Gitea Actions 致力于打造一个 CI/CD 工具的标准协议，第三方 CI 系统可以基于actions 协议与 Gitea 平台集成，提供一站式管理方案。Gitea Actions 为此走出了第一步。

回顾 GitHub Actions

GitHub Actions 是一种持续集成和持续交付 (CI/CD) 平台，可用于自动执行任务、测试和部署。用户可以创建工作流程来构建和测试存储库的每个拉取请求，或将合并的拉取请求部署到生产环境。

GitHub Actions 不仅仅是 DevOps，还允许用户在存储库中发生其他事件时运行工作流程。 例如，可以运行工作流程，以便在有人创建新问题时自动添加相应的标签。

GitHub 提供 Linux、Windows 和 macOS 虚拟机来运行工作流程，或者在自有的数据中心或云基础架构中托管运行器。

Gitea 的 DevOps 生态

得益于广大开源社区的支持，目前 Gitea 可以良好适配以下 DevOps 工具。

• Agola
• AppVeyor
• AWS Cloud Integration(webhook-to-s3)
• buildbot-gitea
• buildkite-connector
• Concourse
• Dex
• Drone
• Ghorg
• gickup
• Jenkins
• 建木 CI
• Metroline
• Monitoring mixin
• mvoCI
• Renovate
• Tea Runner
• Woodpecker

经过长期的社区互动，我们获得了大量第三方CI系统的集成方案。但我们始终发现，独立搭建并运维一整套CI系统只是一小部分极客的专长，对于更广泛的用户而言这并不是个简单的工作，于是我们开始尝试为此努力，让工具更好地为人服务。

打造 Gitea Actions

不可否认 GitHub Actions 打造了一套很棒的工作环境，它的设计理念使仓库与 CI 工具之间有了更加紧密的集成，实现了代码即配置，同时平台用户为整套系统提供了丰富的应用扩展，相比传统模式来说，易用性上更胜一筹。如果能将它的优点移植到 Gitea 将是件很棒的事情。

好消息是，经过两年的调研与讨论，我们终于将 Gitea 内置CI/CD系统的开发任务提上了日程。（#13539）

开发进展

https://github.com/go-gitea/gitea/issues/13539

Gitea Actions 实现了一个内置的 CI/CD 系统框架，兼容 GitHub Actions 的 YAML 工作流编排格式，兼容 GitHub Marketplace 中大部分现有的 Actions 插件。

系统由三部分组成：

• Gitea Actions 协议的定义和 Golang实现
• Actions Runner: 基于 nektos/act 实现的任务子系统
• 在 Gitea 主程序上实现 Runner 任务管理和调度模块

运行截图

1.系统管理员可以访问 Runners 管理界面，创建、编辑和删除 Runner。

2.通过仓库顶部的导航打开 Actions，查看 CI 构建信息。

3.点击某个 CI 构建结果，查看日志。

尝鲜体验

⚠ 实验性功能，请勿用于生产环境

准备环境

• 内存：至少 4GB，用于编译 Gitea
• Docker：可执行 docker 命令，用于拉取和运行容器

搭建

1.编译运行 Gitea

下载带有 Actions 模块的 Gitea 源代码：

# 目前可以从 @wolfogre 的开发分支克隆带有 Actions 模块的源代码到本地编译。
git clone https://github.com/wolfogre/gitea.git --branch=feature/bots
cd gitea

编译方法可以参考从源代码安装。这里我们需要准备开发环境 Node.js LTS (nvm instal --lts) 和 Golang。

以下是推荐的打包方法（带有SQLite，方便本地测试）

TAGS="bindata sqlite sqlite_unlock_notify" make build

启动 Gitea 主程序。这里先走完初始化步骤，会生成一个配置文件，位于当前目录下的

./custom/conf/app.ini

编辑上述配置文件，打开 Actions 功能。

[actions]
ENABLED = true

重新启动程序：./gitea web

2.启动 Runner

首先编译 act_runner 程序

git clone https://gitea.com/gitea/act_runner.git
cd act_runner
make build

然后将 Runner 注册到 Gitea 服务器。

• 方法一：使用交互命令配置

$ ./act_runner register

INFO Registering runner, arch=amd64, os=linux, version=0.1.5.
WARN Runner in user-mode.
INFO Enter the Gitea instance URL (for example, https://gitea.com/): [输入服务器地址]
INFO Enter the runner token: [输入 Runner 令牌]
INFO Enter the runner name (if set empty, use hostname:ubuntu ): [输入 Runner 名称]
INFO Enter the runner labels, leave blank to use the default labels (comma-separated, for example, ubuntu-20.04:docker://node:16-bullseye,ubuntu-18.04:docker://node:16-buster): [输入 Runner 标签]

...
DEBU Successfully pinged the Gitea instance server
INFO Runner registered successfully.

• 方法二：非交互式命令
  • --no-interactive
  • --instance 填写服务器地址
  • --token 填写管理员从服务器获取的 Actions 令牌（/admin/runners）

./act_runner register --instance http://<your_gitea_instance> --token <my_runner_token> --no-interactive

启动程序

./act_runner daemon

3.为仓库启用 Actions 功能

您可以新建一个仓库并手动开启仓库设置中的 Actions 功能。

刷新页面后，我们可以发现仓库的顶部功能导航栏中多了一个 Actions 功能，点击 Actions 进入可以看到目前为空的 All Workflows 任务列表。

4.上传 Workflows 配置到仓库目录 .gitea/workflows/build.yaml。由于 Gitea Actions 兼容 GitHub Actions，因此您可以从 GitHub 文档中复制示例。开始学习使用 Gitea Actions 吧！

🚀 阅读文档
https://docs.github.com/en/actions/quickstart

以下是一个示例，将它保存到 .gitea/workflows/build.yaml 时会触发 CI 工作：

name: Gitea Actions Demo
run-name: ${{ github.actor }} is testing out Gitea Actions 🚀
on: [push]
jobs:
  Explore-Gitea-Actions:
    runs-on: ubuntu-latest
    steps:
      - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event."
      - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by Gitea!"
      - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
      - name: Check out repository code
        uses: actions/checkout@v3
      - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner."
      - run: echo "🖥️ The workflow is now ready to test your code on the runner."
      - name: List files in the repository
        run: |
          ls ${{ github.workspace }}
      - run: echo "🍏 This job's status is ${{ job.status }}."

与此同时，我们再次导航到 Actions 功能面板，可以看到刚刚创建 Workflow 已经执行并且记录下了运行日志。

5.检查 CI 执行过程产生的日志。不难看出 Gitea Runner 拉取了 Docker 镜像作为 CI 构建过程所需的基础环境。

6.从 GitHub 文档中了解更多 Actions 用法，同时可以为我们提出改进意见!

🤖 Implement actions
https://github.com/go-gitea/gitea/pull/21937

🔧 GitHub Actions
https://docs.github.com/zh/actions/using-workflows