跳到主要内容

Forgejo

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

WOODPECKER_FORGEJO=true
WOODPECKER_FORGEJO_URL=YOUR_FORGEJO_URL
WOODPECKER_FORGEJO_CLIENT=YOUR_FORGEJO_CLIENT
WOODPECKER_FORGEJO_SECRET=YOUR_FORGEJO_CLIENT_SECRET

同一主机上的 Forgejo 与容器​

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

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

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

注册​

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

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

[webhook]
ALLOWED_HOST_LIST=external,loopback

参考请参阅配置备忘单。

forgejo oauth 设置

注意

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

配置​

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

FORGEJO​

  • 名称：WOODPECKER_FORGEJO
  • 默认值：false

启用 Forgejo 驱动程序。

FORGEJO_URL​

  • 名称：WOODPECKER_FORGEJO_URL
  • 默认值：https://next.forgejo.org

配置 Forgejo 服务器地址。

FORGEJO_CLIENT​

  • 名称：WOODPECKER_FORGEJO_CLIENT
  • 默认值：无

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

FORGEJO_CLIENT_FILE​

  • 名称：WOODPECKER_FORGEJO_CLIENT_FILE
  • 默认值：无

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

FORGEJO_SECRET​

  • 名称：WOODPECKER_FORGEJO_SECRET
  • 默认值：无

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

FORGEJO_SECRET_FILE​

  • 名称：WOODPECKER_FORGEJO_SECRET_FILE
  • 默认值：无

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

FORGEJO_SKIP_VERIFY​

  • 名称：WOODPECKER_FORGEJO_SKIP_VERIFY
  • 默认值：false

配置是否应跳过 SSL 验证。