Gitea Runner 1.0.0 已发布

本文由 AI 翻译，如有歧义请以 英文原文 为准。

我们很高兴宣布 Gitea Runner 1.0.0 的发布。

这是官方 Gitea Actions runner 以其新名称发布的首个稳定版本。之前名为 act_runner 的项目已重命名为 Gitea Runner，该仓库现可在 gitea/runner 获取。

为什么要更名？

原先的 act_runner 名称反映了项目早期的实现历史及其与 nektos/act 的关系。从那以后，Gitea Actions 与 runner 已成长为 Gitea 生态的核心组成部分。

新名称让目的更加明确：它就是 Gitea Actions 的官方 runner。

注意：最后的几个 act_runner 发布均属于 v0.6.x 版本线。Gitea Runner v1.0.0 是一次有意的版本重置，并将在新名称下启用新的稳定版本方案。

有哪些变化？

最明显的变化体现在项目名称、二进制文件和容器镜像命名上：

• 仓库：gitea/runner
• 二进制文件：gitea-runner
• 下载路径：https://dl.gitea.com/gitea-runner/
• Docker 镜像：gitea/runner

例如，现在注册并启动 runner 的方式如下：

./gitea-runner register
./gitea-runner daemon

Docker 用户可以使用新的镜像名称：

docker run \
  -e GITEA_INSTANCE_URL=https://gitea.example.com \
  -e GITEA_RUNNER_REGISTRATION_TOKEN=<your_token> \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --name gitea-runner \
  gitea/runner:1.0.0

配置

Gitea Runner 继续支持熟悉的注册流程，同时鼓励使用显式的 YAML 配置文件来配置 runner 设置。

你可以通过以下命令生成初始配置：

./gitea-runner generate-config > config.yaml

然后将其传递给加载 runner 配置的命令：

./gitea-runner -c config.yaml register
./gitea-runner -c config.yaml daemon
./gitea-runner -c config.yaml cache-server

如果你更倾向于仅使用环境变量进行设置（不使用配置文件），runner 仍然支持上述环境变量（GITEA_INSTANCE_URL 和 GITEA_RUNNER_REGISTRATION_TOKEN）。不过，推荐使用配置文件来管理 runner 的行为。

升级说明

如果你已经运行 act_runner，请计划将脚本、服务文件、Docker Compose 文件、Kubernetes 清单以及监控引用更新为新的 gitea-runner 和 gitea/runner 名称。

对于许多部署来说，迁移就是直接重命名。例如：

- act_runner daemon
+ gitea-runner daemon

- gitea/act_runner:0.2.x
+ gitea/runner:1.0.0

旧的仓库 URL 会重定向到新仓库，但新的文档和发布产物会使用新的命名。

请务必在广泛部署前，先在您的环境中测试新的 runner，尤其是在您的工作流依赖于自定义标签、Docker-in-Docker 设置、无根 Docker 或外部缓存配置的情况下。

下载

预编译的二进制文件可从 Gitea Runner 下载页面 获取。

该发布版本也可从 Gitea Runner 发布页面 获取。

感谢

感谢大家在 runner 从最初发布到 1.0.0 版本逐渐成熟的过程中，贡献代码、测试、错误报告、文档以及反馈。

我们还要感谢 https://github.com/nektos/actnektos/act 项目及其贡献者，他们的工作始终是 Gitea Actions runner 的重要组成部分。