跳到主要内容

Gitea

Woodpecker 内置支持 Gitea。要启用 Gitea，您应该使用以下环境变量配置 Woodpecker 容器：

WOODPECKER_GITEA=true
WOODPECKER_GITEA_URL=YOUR_GITEA_URL
WOODPECKER_GITEA_CLIENT=YOUR_GITEA_CLIENT
WOODPECKER_GITEA_SECRET=YOUR_GITEA_CLIENT_SECRET

同一主机上的 Gitea 与容器​

如果您的 Gitea 也在同一主机的容器内运行，请确保代理可以访问它。 代理尝试使用 Gitea 通过其 API 报告的 URL 进行克隆。为了简化连接，您应该将 Woodpecker 代理添加到 Gitea 所在的同一 docker 网络中。 否则，通信应该通过 docker0 网关（通常是 172.17.0.1）进行。

如果网络名称为 gitea，要配置 Docker 网络，请这样配置：

docker-compose.yaml
 services:
   [...]
   woodpecker-agent:
     [...]
     environment:
       - [...]
+      - WOODPECKER_BACKEND_DOCKER_NETWORK=gitea

注册​

在 Gitea 中注册您的应用程序以创建您的客户端 ID 和密钥。您可以在 https://gitea.<host>/user/settings/ 找到 Gitea 的 OAuth 应用程序设置。非常重要的是，授权回调 URL 必须与您的 http(s) 方案和主机名完全匹配，路径为 https://<host>/authorize。

如果您在与 Gitea 实例相同的主机上运行 Woodpecker CI 服务器，从 v1.16 版本开始，您可能还需要在 Gitea 中允许本地连接。否则 webhook 将失败。将以下行添加到您的 Gitea 配置（通常在 /etc/gitea/conf/app.ini）。

[webhook]
ALLOWED_HOST_LIST=external,loopback

参考请参阅配置备忘单。

gitea oauth 设置

注意

确保您的 Gitea 配置允许以固定页面长度 50 请求 API。最大页面大小的默认值为 50，但如果您设置的值低于 50，某些 Woodpecker 功能将无法正常工作。另请参阅配置备忘单。

配置​

这是配置选项的完整列表。请注意，这些选项中的许多使用默认配置值，应该适用于大多数安装。

GITEA​

  • 名称：WOODPECKER_GITEA
  • 默认值：false

启用 Gitea 驱动程序。

GITEA_URL​

  • 名称：WOODPECKER_GITEA_URL
  • 默认值：https://try.gitea.io

配置 Gitea 服务器地址。

GITEA_CLIENT​

  • 名称：WOODPECKER_GITEA_CLIENT
  • 默认值：无

配置 Gitea OAuth 客户端 ID。这用于授权访问。

GITEA_CLIENT_FILE​

  • 名称：WOODPECKER_GITEA_CLIENT_FILE
  • 默认值：无

从指定的文件路径读取 WOODPECKER_GITEA_CLIENT 的值

GITEA_SECRET​

  • 名称：WOODPECKER_GITEA_SECRET
  • 默认值：无

配置 Gitea OAuth 客户端密钥。这用于授权访问。