应用介绍
OVERVIEW介绍
Woodpecker 是一款 CI/CD 工具。它设计轻量、操作简便且运行迅捷。
安装时需要配置托管平台: 以 GitHub 为例,点开设置,进入开发者设置,再进入 OAuth 应用中,注册一个新应用: 其他随意填写,回调网址必须填写
https://<Woodpecker实例地址>/authorize。
特点
- Woodpecker 使用 Docker 容器执行管道步骤。若您需要超越常规 Docker 镜像的功能,可创建插件来扩展管道功能。
- Woodpecker 始终是完全免费的。由于 Woodpecker 的源代码是开源的,您可以贡献力量来帮助项目发展。
- Woodpecker 让您能够轻松为项目创建多个工作流。这些工作流甚至可以相互依赖。
构成
Woodpecker 由核心组件(server 和 agent)及可选组件(autoscaler)构成。
server 提供用户界面,处理发往底层 forge (托管平台)的 Webhook 请求,提供 API 服务,并解析 YAML 文件中的管道配置。
agent 通过特定后端(Docker、 Kubernetes、 本地)执行工作流,并通过 GRPC 连接至服务器。多个代理可同时存在,从而针对单个实例精细调整作业限制、后端选择及其他代理相关设置。
autoscaler 可在选定的云服务商上启动新虚拟机处理待处理构建任务。构建完成后,虚拟机将在短暂过渡期后自动销毁。
版本与部署参数
VERSIONS以下信息来自开源应用包模板,仅用于技术参考;尚未转换成可直接使用的 Cockpit 安装配置。
版本 3.19.0-alpine↓ 下载 docker-compose.yaml
配置字段
参数说明属性
PANEL_APP_PORT_HTTP端口必填WOODPECKER_AGENT_SECRET主密钥敏感信息WOODPECKER_HOST外部访问地址必填FORGE_TYPE托管平台必填FORGE_URL托管服务器地址必填FORGE_CLIENT客户端 ID必填FORGE_SECRET客户端密钥敏感信息原始模板存在特定平台的网络或环境变量依赖,不能直接作为 Cockpit 安装文件使用。