跳到主要内容

Bitbucket

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

WOODPECKER_BITBUCKET=true
WOODPECKER_BITBUCKET_CLIENT=... # 在 Bitbucket 中称为 "Key"
WOODPECKER_BITBUCKET_SECRET=...

注册​

您必须在 Bitbucket 注册 OAuth 应用程序以获得 Woodpecker 的密钥和密钥组合。导航到您的工作空间设置，从菜单中选择 OAuth consumers，最后点击 Add Consumer（URL 应该类似于：https://bitbucket.org/[your-project-name]/workspace/settings/api）。

请设置名称并像这样设置 Callback URL：

https://<your-woodpecker-address>/authorize

bitbucket oauth 设置

另请确保检查以下权限：

  • Account: Email, Read
  • Workspace membership: Read
  • Projects: Read
  • Repositories: Read
  • Pull requests: Read
  • Webhooks: Read and Write

bitbucket 权限

配置​

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

BITBUCKET​

  • 名称：WOODPECKER_BITBUCKET
  • 默认值：false

启用 Bitbucket 驱动程序。

BITBUCKET_CLIENT​

  • 名称：WOODPECKER_BITBUCKET_CLIENT
  • 默认值：无

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

BITBUCKET_CLIENT_FILE​

  • 名称：WOODPECKER_BITBUCKET_CLIENT_FILE
  • 默认值：无

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

BITBUCKET_SECRET​

  • 名称：WOODPECKER_BITBUCKET_SECRET
  • 默认值：无

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

BITBUCKET_SECRET_FILE​

  • 名称：WOODPECKER_BITBUCKET_SECRET_FILE
  • 默认值：无

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

已知问题​

Bitbucket 构建密钥限制为 40 个字符：问题 #5176。如果作业超过此限制，您可以通过修改 WOODPECKER_STATUS_CONTEXT 或 WOODPECKER_STATUS_CONTEXT_FORMAT 变量来调整密钥。有关更多详细信息，请参阅环境变量文档。

缺失功能​

不支持拉取请求的路径过滤器。我们有兴趣接受补丁来包含此功能。 如果您有兴趣为 Woodpecker 做出贡献并提交补丁，请通过 Discord 或 Matrix 联系我们。