跳到主要内容

迁移指南

为了增强 Woodpecker 的可用性并满足不断变化的安全标准，偶尔需要进行迁移。虽然我们努力将这些变化降到最低，但有些变化是不可避免的。如果您在迁移到新版本时遇到重大问题，请告知我们，以便维护者重新评估更新。

next​

  • (Kubernetes) 弃用 pod 上的 step 标签，改用新的命名空间标签 woodpecker-ci.org/step。step 标签将在未来的更新中被移除。
  • 弃用 CI_COMMIT_AUTHOR_AVATAR 和 CI_PREV_COMMIT_AUTHOR_AVATAR 环境变量，改用 CI_PIPELINE_AVATAR 和 CI_PREV_PIPELINE_AVATAR

3.0.0​

面向用户的迁移​

工作流语法变更​

  • secrets 已完全移除，改用 environment 结合 from_secret 语法 (#4363)。 由于 secrets 只是被掩码的普通环境变量，目标是允许它们与普通环境变量一起声明，同时减少关键字语法的数量。 此外，from_secret 语法在命名方面提供了更多灵活性。 以前 secrets 总是以其初始密钥名称命名，现在 from_secret 引用可以不同。 最后，可以从同一个密钥引用注入多个不同的环境变量。

  • image 现在对所有步骤都是必需的 (#4409)

  • 移除 platform 过滤器，改用 labels (#4404)

  • 如果您使用 commands，现在默认 shell 为 sh。如果您需要不同的 shell，请显式设置 shell 选项 (#4430)

其他变更​

  • 移除 WOODPECKER_GRPC_VERIFY 环境变量，改用 WOODPECKER_GRPC_SECURE (#4265)

管理员迁移​

服务器配置变更​

  • 移除 WOODPECKER_GRPC_VERIFY 环境变量，改用 WOODPECKER_GRPC_SECURE (#4265)

代理配置变更​

  • 移除 WOODPECKER_GRPC_VERIFY 环境变量，改用 WOODPECKER_GRPC_SECURE (#4265)

2.8.0​

管理员迁移​

Kubernetes 后端​

  • 如果您使用 Kubernetes 后端，请注意默认的服务账户现在是 woodpecker-ci，而不是 default。您可以使用 WOODPECKER_BACKEND_K8S_SERVICEACCOUNT 环境变量进行配置。

2.7.0​

管理员迁移​

环境变量重命名​

一些环境变量已重命名以提高一致性：

  • WOODPECKER_GITEA_SKIP_VERIFY → WOODPECKER_GITEA_SKIP_TLS_VERIFY
  • WOODPECKER_GITHUB_SKIP_VERIFY → WOODPECKER_GITHUB_SKIP_TLS_VERIFY
  • WOODPECKER_GITLAB_SKIP_VERIFY → WOODPECKER_GITLAB_SKIP_TLS_VERIFY

旧名称仍然有效，但已弃用，将在未来版本中移除。

2.6.0​

用户迁移​

条件步骤语法​

条件步骤的语法已更改。以前的 when 语法：

when:
  branch: main
  event: push

现在应该写成：

when:
  - branch: main
    event: push

旧语法仍然有效，但建议迁移到新语法。

2.5.0​

管理员迁移​

数据库迁移​

此版本包含数据库架构更改。升级时，Woodpecker 将自动运行必要的迁移。建议在升级前备份数据库。

2.4.0​

用户迁移​

插件配置​

插件配置语法已标准化。以前可能使用的嵌套配置：

settings:
  plugin:
    config: value

现在应该扁平化：

settings:
  config: value

2.3.0​

管理员迁移​

日志配置​

日志配置已更改。新的环境变量：

  • WOODPECKER_LOG_LEVEL - 设置日志级别（debug、info、warn、error）
  • WOODPECKER_LOG_PRETTY - 启用美化的日志输出

2.2.0​

用户迁移​

工作流依赖​

工作流依赖语法已更改。以前：

depends_on:
  - workflow-name

现在：

depends_on:
  - workflow-name

语法保持相同，但现在支持更复杂的依赖模式。

2.1.0​

管理员迁移​

认证配置​

OAuth 配置已简化。许多提供商的配置变量已重命名以保持一致性。请查看文档了解您使用的认证提供商的最新配置选项。

2.0.0​

重大变更​

从 Drone 迁移​

如果您从 Drone CI 迁移，请注意以下重大变更：

  1. 配置文件名: .drone.yml → .woodpecker.yml
  2. 环境变量前缀: DRONE_ → WOODPECKER_
  3. Docker 镜像名: drone/drone → woodpeckerci/woodpecker-server

数据库迁移​

Woodpecker 2.0.0 包含重大的数据库架构更改。升级过程将自动迁移您的数据，但强烈建议在升级前进行完整的数据库备份。

API 变更​

REST API 端点已更改：

  • /api/user → /api/v1/user
  • /api/repos → /api/v1/repos

配置文件变更​

许多配置选项已重命名或重新组织。请查看最新的配置文档以了解详细信息。

如需更多帮助，请访问我们的 GitHub 讨论区 或 Matrix 聊天室。