首页/新闻资讯/正文详情

Woodpecker 2.0.0 升级指南:破坏性变更、迁移要点与新特性深度解析

发布时间:2026/9/27 9:20:40 来源:云帆数科 栏目:资讯中心
Woodpecker 2.0.0 升级指南:破坏性变更、迁移要点与新特性深度解析
CI/CDDevOps【免费下载链接】woodpeckerWoodpecker is a simple, yet powerful CI/CD engine with great extensibility.项目地址https://gitcode.com/gh_mirrors/wo/woodpecker点击查看免费下载本篇技术指南围绕 Woodpecker 发布的 v2.0.0 展开系统梳理该大版本中超过 350 项变更的核心脉络从未来版本发布策略、全部破坏性变更及其迁移方案到 UI 配置校验、管理员概览、用户级 Secrets、Kubernetes 后端全面支持等新特性。结合当前仓库源码与 CHANGELOG.md 证据读者将能完整掌握从 v1.x 升级到 v2.0.0 所需的所有实操要点并理解这些变更在底层代码中的落地方式。版本发布策略的转变Woodpecker v2.0.0 发布的同时维护团队也宣布了未来版本发布策略的调整不再进行 backport回溯移植因为该机制需要投入大量维护成本。取而代之的是每隔几周直接从main分支的当前状态按 semver语义化版本规则打出版本号发布。关键缺陷修复与安全修复仍会尽快单独发布不受周期性发布节奏限制。为了避免过于频繁地发布新的主版本破坏性变更的 PR 会被刻意积压一段时间再集中放入下一个主版本中一次性放出。这意味着升级 v2.0.0 时遇到的破坏性变更是自 v1.0.0 以来累积的一次性大礼包而对使用者而言未来升级主版本时应重点查看集中发布的迁移说明。破坏性变更清单重命名的 API 路由部分 API 路由被重命名以保持命名一致性。具体而言/hook与/stream路径被迁移到了/api/(hook|stream)之下见 迁移指南 的 2.0.0 一节。迁移指南同时强调/hook和/stream这两个旧路径已被移除管理员可能需要使用仓库设置中的 Repair repository 按钮或管理设置中的 Repair all 按钮重新创建 Forge Webhook。这也是发布博客建议管理员点击管理设置中新增的Repair all repositories按钮来更新所有仓库 Webhook 的原因。该操作在 CLI 侧对应woodpecker-cli repo repair命令实现见 repo_repair.go用于修复仓库的 Webhook 配置。此外API 与数据模型中的link字段被统一重命名为url包括所有 API 字段。移除已弃用的环境变量与 CLI 命令在 v1.0.0 中Woodpecker 弃用了一批旧的构建环境变量如CI_BUILD_*并在 2.0.0 中正式移除必须改用新命名。根据 迁移指南 的 2.0.0 一节被彻底删除的内置环境变量包括CI_BUILD_*、CI_PREV_BUILD_*、CI_JOB_**_LINKCI_SYSTEM_ARCHCI_REPO_REMOTE对应的新命名体系在 environment.go 中有完整实现构建相关统一为CI_PIPELINE_*/CI_PREV_PIPELINE_*如CI_PIPELINE_NUMBER、CI_PIPELINE_EVENT任务相关统一为CI_STEP_*如CI_STEP_NAME、CI_STEP_NUMBERCI_REPO_REMOTE由CI_REPO_CLONE_URL取代*_LINK由*_URL取代。同一文件中也保留了部分旧变量作为兼容别名并标注Deprecated例如CI_COMMIT_PRERELEASE、CI_COMMIT_AUTHOR_AVATAR、CI_PREV_COMMIT_AUTHOR_AVATAR供后续大版本逐步清理。CLI 方面已弃用的build命令在 2.0.0 中被移除必须改用pipeline子命令对应 cli/pipeline 目录下的pipeline.go、list.go、show.go等实现。移除 SSH 后端由于 SSH 后端存在诸多问题Woodpecker 决定将其移除。官方给出的两种替代方案在远程机器上直接安装一个使用local 后端的 Agent在 Pipeline 中直接执行ssh命令连接远程服务器。从当前源码结构看后端体系已经收敛为 docker、kubernetes、local、dummy 四类入口定义见 backend.go不再包含 SSH 实现印证了这一移除决策的彻底性。弃用platform过滤器platform过滤器被移除应改用更强大的labels标签机制按平台等属性筛选 Agent。相关语法详见 workflow-syntax 文档 中按平台过滤的说明。迁移指南也明确记录platform:过滤器被弃用转而使用labels:。Docker 升级到 v24为了修复若干安全补丁Woodpecker 将依赖的 Docker 库升级到了 v24。如果 Agent 运行环境中的 Docker 版本过旧可能需要一并升级。这一变更同样记录在 CHANGELOG.md 的 v2.0.0 条目中fix(deps): update docker to v24。移除 Secrets 的 plugin-only 选项出于安全考虑Secrets 的plugin_only选项被移除。新的行为是如果你为 Secret 定义了镜像过滤器images该 Secret 将自动只对使用这些镜像名的插件可用不再需要单独开启 plugin-only 开关。迁移指南对此的补充说明包括Secrets 的event属性改名为eventsimage改名为images两者均为列表旧属性已删除已有带images列表的 Secret在作为插件使用时将仅对列表中的镜像可用。迁移要点总览除上述变更外v2.0.0 还包含若干需要管理员关注的迁移事项完整清单见 迁移指南 的 2.0.0 一节要点如下变更项说明内置环境变量清理CI_BUILD_*、CI_JOB_*、*_LINK、CI_SYSTEM_ARCH、CI_REPO_REMOTE已删除Secrets API 属性改名event→eventsimage→imagesSecretsplugin_only移除改用images过滤器自动限定插件可见性CLIbuild别名移除统一使用pipeline命令SSH 后端移除改用 local 后端 Agent 或 pipeline 内ssh命令/hook、/stream路径迁移移到/api/(hook\|stream)需 Repair 仓库重建 WebhookWOODPECKER_DOCS配置移除删除该配置变量link改名为url涉及全部 API 字段CI_COMMIT_URL弃用改用CI_PIPELINE_FORGE_URLCHANGELOG 中记录的其余破坏性变更还包括CLI 参数恢复为单数形式、客户端库中 ID 类型改为int64、Woodpecker-go 使用Feed替代Activity、不再对 3 个字符及以下的 Secrets 做脱敏等。完整条目可在 CHANGELOG.md 的 v2.0.0 段落中查阅。新特性详解UI 中的配置警告与错误Linter Warnings and Errorsv2.0.0 最实用的新特性之一配置校验结果直接呈现在 UI 中。过去排查Secret 为什么没生效YAML 里某个 key 写错了往往需要数小时调试现在 Woodpecker 会直接在 UI 中显示错误与 Linter 警告即时提示缺失的 Secret、错误的配置或已弃用的设置。这一能力在源码中有完整的实现支撑linter.go 定义了Linter类型其Lint方法L70-L80遍历每个工作流配置逐项检查steps段是否存在且非空缺失时报Invalid or missing steps sectionclone 步骤的镜像是否匹配受信任白名单各容器clone / steps / services的镜像、信任级别privileged、自定义 DNS、卷挂载等、settings 与 commands/entrypoint 的互斥关系服务名称是否唯一服务名会作为网络别名重名会导致随机解析depends_on依赖是否存在Schema 校验与弃用项检查如runs_on提示改用when.status旧环境变量提示改用新名不良习惯提示如缺少when事件过滤。newLinterError会区分错误级别IsWarning: true表示警告如 schema 问题、弃用用法IsWarning: false表示硬错误如缺少镜像、信任级别不足。这正是 UI 中错误与警告分类呈现的底层依据。管理员仓库与组织概览管理员现在可以在管理面板中查看服务器上注册的全部仓库与组织并直接执行常见操作如删除。CHANGELOG 中对应条目为Add repos list for admins与Add org list。仓库概览的界面截图如下这一功能对多仓库、多团队实例的运维尤其有价值——无需逐个仓库进入设置页即可完成批量治理。用户级 SecretsUser Secrets新增用户级 Secrets可以为自己名下的所有仓库添加 Secret作用范围介于组织级Org与仓库级RepoSecret 之间使用方式与组织级、全局 Secret 类似。结合同一版本中 Secrets 的镜像过滤器机制用户可以在自己拥有的仓库集合内安全共享凭据。Bitbucket Cloud 多工作流支持Bitbucket 支持得到增强现在可以像使用其他 Forge 一样使用多工作流multi-workflows即在.woodpecker/目录下组织多个工作流文件并按事件并行或串行执行。CHANGELOG 对应条目为Support bitbucket Dir() and support multi-workflows。Kubernetes 后端全面可用虽然许多用户此前已在大量使用 Kubernetes 后端v2.0.0 正式将其标记为生产就绪fully supported支持所有主要特性并提供了不少 Kubernetes 特有的配置选项。CHANGELOG 中记录的相关增强包括为 Kubernetes 后端增加 tolerations 配置选项Add option to configure tolerations in kubernetes backend。从当前仓库看Kubernetes 后端实现位于 pipeline/backend/kubernetes 目录约 18 个 Go 文件涵盖工作流、步骤、卷、服务、容器等完整执行路径。自动主题Auto ThemeUI 支持根据浏览器配置自动切换主题系统主题为暗色时界面自动变暗不再需要在深夜被亮瞎。更新通知Update Notification为了不让管理员错过重要的安全修复UI 在有新版本可用时会向管理员显示更新通知。CHANGELOG 对应条目为Add version and update notes。对自托管 CI 系统而言这是降低忘记升级导致安全漏洞滞留风险的重要改进。其他值得关注的变更v2.0.0 中还有若干增强值得了解详见 CHANGELOG.md安全方面绝不记录令牌token、仓库查询时校验权限、令牌日志降级为 trace 级别、Webhook 在修改任何数据前先完成校验错误与提示新增弃用警告、增强 Linter 与错误提示、缺失 Secret 时直接使 Pipeline 失败Agent 管理无状态 Agent 在终止时主动从服务器注销平台报告后端引擎可报告当前平台CI_SYSTEM_PLATFORM由后端实际填充见 environment.go 的注释本地执行local 后端支持自定义临时目录。升级建议综合以上内容从 v1.x 升级到 v2.0.0 的核心动作可以概括为五步修复 Webhook登录管理设置点击Repair all repositories按钮确保仓库 Webhook 指向新的/api/...路由更新环境变量引用将 Pipeline 配置与脚本中的CI_BUILD_*、CI_JOB_*、*_LINK等旧变量替换为CI_PIPELINE_*、CI_STEP_*、*_URL新命名迁移 Secrets将plugin_only与单数属性event/image改为images/events列表写法并确认镜像过滤器符合预期处理 SSH 后端在远程主机部署 local 后端 Agent或在 Pipeline 内改用ssh命令替换弃用语法将platform:过滤器改为labels:将woodpecker-cli build改为woodpecker-cli pipeline。若在迁移中遇到其他问题可对照 迁移指南 的 2.0.0 段落逐条核验完整变更列表则可在 CHANGELOG.md 中检索 v2.0.0 条目。赞分享CI/CDDevOps【免费下载链接】woodpeckerWoodpecker is a simple, yet powerful CI/CD engine with great extensibility.项目地址https://gitcode.com/gh_mirrors/wo/woodpecker点击查看免费下载相关推荐Falcon 1.0.0 版本深度解读破坏性变更、新特性与升级迁移指南Falcon 1.0.0 版本深度解读破坏性变更、新特性与升级迁移指南 Falcon 1.0.0 是这一no magic Python Web 框架走向成后端Web框架API设计AutoMapper 10.0 升级指南11 项破坏性变更与迁移要点AutoMapper 10.0 升级指南11 项破坏性变更与迁移要点 本指南基于仓库内 10.0 Upgrade Guide.md https://link.后端NumPy 2.0.0 迁移与升级全指南重大特性、破坏性变更与 C API 适配NumPy 2.0.0 迁移与升级全指南重大特性、破坏性变更与 C API 适配 NumPy 2.0.0 是自 2006 年 1.x 系列以来的首个主版本号升科学计算数据分析上一篇如何在本地AI编辑器中运行Claude Design完整指南下一篇如何利用Vuex管理vue-wordpress-pwa应用状态从入门到精通创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

别再问抖音seo优化软件报价,图解步骤揭秘3天上线全流程
别再问抖音seo优化软件报价,图解步骤揭秘3天上线全流程

别再问抖音seo优化软件报价,图解步骤揭秘3天上线全流程 改个需求建站公司拖一周,这种憋屈事儿谁还没经历过?上周给个做抖音知识付费的客户做站,首页Banner换张图,对方技术说“服务器在忙,下周再弄”。客户急得跳脚,说抖音流量窗口期就几天,… · 2026/9/27 9:20:40

考完网络营销师证别躺平,3招用源码下载撬动流量
考完网络营销师证别躺平,3招用源码下载撬动流量

考完网络营销师证别躺平,3招用源码下载撬动流量 模板网站太丑不够用,这大概是很多刚拿到 网络营销师证 的朋友最头疼的事。手里有证,脑子有货,结果一落地发现,自己花钱做的官网像个上世纪的PPT,客户看一眼就想关。别急,这锅不该你背,也不该怪模… · 2026/9/27 9:20:34

拒绝烂大街!网站开发的评论界面模板图解步骤与选型避坑
拒绝烂大街!网站开发的评论界面模板图解步骤与选型避坑

拒绝烂大街!网站开发的评论界面模板图解步骤与选型避坑 别再问那个“通用评论框”为什么总被用户吐槽丑了。打开后台看数据,评论区的跳出率高达40%,转化率却只有5%,这就是典型的 模板网站太丑不够用… · 2026/9/27 9:20:28

※〖★☆★精选【逆势上涨】◎下跌行情下的操盘利器◎不含未来函数◎源码★☆★〗※
※〖★☆★精选【逆势上涨】◎下跌行情下的操盘利器◎不含未来函数◎源码★☆★〗※

D:MA(C,5); J:REF(D,2)<REF(D,1) AND REF(D,1)<D;G:MA(INDEXC,5); S:REF(G,2)>REF(G,1) AND REF(G,1)>G; XG:S AND J;{信号过滤器&#xff1a;N取0&#xff5e;10&#xff0c;数值越大&#xff0c;信号越少&#xff0c;取0为不过滤} N:0; 信号过滤:COUNT(XG,N) AND… · 2026/9/27 9:59:14

Wren 语言 System 类全解析:print、clock、gc 等内置工具方法实战指南
Wren 语言 System 类全解析:print、clock、gc 等内置工具方法实战指南

编程语言语言运行时编译器 【免费下载链接】wren The Wren Programming Language. Wren is a small, fast, class-based concurrent scripting language. 项目地址&#xff1a; https://gitcode.com/gh_mirrors/wr/wren 点击查看 免费下载 导读 System 类是 Wren 标准库中由虚… · 2026/9/27 9:59:14

2026 考研真题复习
2026 考研真题复习

2026 section1 2026 Section I Use of English-CSDN博客 2026 Section I Use of English 单词&#xff0c;短语和 句子-CSDN博客 2026 Section I Use of English阅读理解做题方法-CSDN博客 text1 ​2026-Part A-Text 1-word-part2-CSDN博客 2026-Part A-Text 1-单词和难句… · 2026/9/27 9:59:08

340万下载、64万日活:Muse 是真爆发,还是 Meta 的流量魔术?
340万下载、64万日活:Muse 是真爆发,还是 Meta 的流量魔术?

上线十天登顶双榜&#xff0c;单日日活跳涨 27%&#xff0c;安装量却有 230 万到 430 万三种说法。Meta 的个人 AI Agent 想接管的&#xff0c;不只是聊天框——但这份热度里&#xff0c;有多少来自产品&#xff0c;有多少来自分发&#xff1f;写在前面&#xff1a;三分钟看懂这… · 2026/9/27 9:59:08

网站遭攻击后源码下载指南:3步止损避坑全解析
网站遭攻击后源码下载指南:3步止损避坑全解析

网站遭攻击后源码下载指南:3步止损避坑全解析 找建站公司最怕什么?不是界面丑,也不是功能少,而是怕被坑高价买一堆垃圾代码,最后网站遭攻击时才发现自己手里连个能看的源码都没有。很多老板花了几万块,结果只拿到一堆混淆过的加密文件,想自己维护或者… · 2026/9/27 9:58:50

美工是做什么的新手入门
美工是做什么的新手入门

别被割韭菜,美工工作本质速查手册 找建站公司怕被坑高价?别急,这份速查手册直接拆解真相。 很多老板觉得美工就是“画图的”,其实这是最大的误区。 不懂美工的技术边界,你就只能被动接受“一口价”。 威胁场景:当“美工”变成安全漏洞的入口… · 2026/9/27 9:58:43

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介&#xff1a;这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程&#xff0c;从线性调频&#xff08;LFM&#xff09;信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑&#xff0c;面向电子信息工程、计算机、数学等专业学生&#xff0c;适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介&#xff1a;基于PyTorch的多模态虚假新闻检测项目完整代码包&#xff0c;面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者&#xff0c;解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征&#xff0c;以Res… · 2026/9/27 0:00:01

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介&#xff1a;这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程&#xff0c;从线性调频&#xff08;LFM&#xff09;信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑&#xff0c;面向电子信息工程、计算机、数学等专业学生&#xff0c;适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介&#xff1a;基于PyTorch的多模态虚假新闻检测项目完整代码包&#xff0c;面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者&#xff0c;解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征&#xff0c;以Res… · 2026/9/27 0:00:01

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码