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），仅供参考