48 lines
No EOL
4.1 KiB
Markdown
48 lines
No EOL
4.1 KiB
Markdown
# [{release_main_version}] 发布 `{release_version}`
|
||
|
||
以下是发布 `{release_version}` 的说明，计划发布日期为 `{release_date}`。
|
||
|
||
----
|
||
|
||
请按顺序执行以下所有步骤。在运行_任何_ GitHub 工作流时，请确保从 `trunk` 分支（默认分支）运行，并按要求输入发布版本或分支。
|
||
|
||
请备好 _[发布故障排除与恢复](https://developer.woocommerce.com/docs/contribution/releases/troubleshooting/)_ 指南，以防遇到任何问题。
|
||
|
||
----
|
||
|
||
### 1. 预构建检查
|
||
|
||
- [ ] 确认 [GitHub 服务](https://www.githubstatus.com/)运行正常。
|
||
- [ ] 验证针对 [{release_milestone} 里程碑](.linear/zh-cn/{repository_url}/issues?q=is:open+milestone:{release_milestone})没有未解决的问题或拉取请求。根据需要联系作者进行合并或关闭。
|
||
- [ ] 确保没有适用于此版本但尚未处理的[带有"cherry pick failed"标签的](.linear/zh-cn/{repository_url}/pulls?q=is:pr+label:%22cherry+pick+failed%22)拉取请求。
|
||
- [ ] 确认[发布分支上的 readme.txt 文件中的](.linear/zh-cn/{repository_url}/blob/{release_branch}/plugins/woocommerce/readme.txt#L7) `Stable tag` 值与[WordPress.org `trunk` 上的](https://plugins.trac.wordpress.org/browser/woocommerce/trunk/readme.txt#L7)一致。
|
||
|
||
### 2. 构建发布包
|
||
|
||
- [ ] 运行工作流 **[发布：提升版本号](.linear/zh-cn/{repository_url}/actions/workflows/release-bump-version.yml)**：输入 `{release_main_version}` 作为 _发布分支_，输入 `{release_type}` 作为 _要执行的版本提升类型_。
|
||
- [ ] 审查并合并针对发布分支生成的 PR。检查 [{release_milestone} 里程碑](.linear/zh-cn/{repository_url}/issues?q=is:open+milestone:{release_milestone})。
|
||
- [ ] 运行工作流 **[发布：编译更新日志](.linear/zh-cn/{repository_url}/actions/workflows/release-compile-changelog.yml)**：输入 `{release_main_version}` 作为 _版本_，并将 _发布日期_ 留空，除非是提前构建包。
|
||
- [ ] 审查并合并生成的 PR：一个针对 `trunk` 分支，另一个针对发布分支。两者都应归属于 [{release_milestone} 里程碑](.linear/zh-cn/{repository_url}/issues?q=is:open+milestone:{release_milestone})。
|
||
- [ ] 运行工作流 **[发布：构建 ZIP 文件](.linear/zh-cn/{repository_url}/actions/workflows/release-build-zip-file.yml)** 以构建资源并创建 GitHub 发布：输入 `{release_main_version}` 作为 _发布分支_，并勾选 _创建 GitHub 发布_。
|
||
- [ ] 确认一个草稿 `{release_version}` 发布 [已在仓库中创建](.linear/zh-cn/{repository_url}/releases)，并附带 `woocommerce.zip` 资源。
|
||
|
||
### 3. 将发布版本上传至 WordPress.org
|
||
|
||
- [ ] 运行工作流 **[发布：上传发布版本至 WordPress.org](.linear/zh-cn/{repository_url}/actions/workflows/release-upload-to-wporg.yml)**：输入 `{release_version}` 作为 _要上传的发布标签_，并务必勾选确认框。
|
||
- [ ] 确认 SVN 标签 `{release_version}` [在 WordPress.org SVN 上存在](https://plugins.svn.wordpress.org/woocommerce/tags/{release_version})。
|
||
- [ ] 使用秘密存储中 `WordPress.org "WooCommerce" 用户账户` 凭证[登录 WordPress.org](https://wordpress.org/plugins/developers/releases/) 并批准该发布。
|
||
- [ ] 几分钟后，确认 [`{release_version}` 版本可供下载](https://downloads.wordpress.org/plugin/woocommerce.{release_version}.zip)。
|
||
|
||
### 4. 部署到预发布环境
|
||
|
||
- [ ] 遵循[部署到预发布环境指南](https://wp.me/PCYsg-18BQ)，并在部署后至少监控 {release_monitoring_time} 小时。
|
||
- [ ] 在 Slack 的发布频道中创建一个主题，用于监控和讨论本次发布。
|
||
|
||
**如果在监控期间检测到关键问题...**
|
||
|
||
- [ ] 请求在预发布环境中进行回滚。
|
||
- [ ] 暂停发布流程，**不要继续执行此问题中的任何步骤**。请改为遵循[故障排除指南](https://developer.woocommerce.com/docs/contribution/releases/troubleshooting/#deploy-serious-bug)中的流程。
|
||
|
||
### 5. 发布版本
|
||
|
||
- [ ] 发布之前创建的 `{release_version}` [版本草稿](.linear/zh-cn/{repository_url}/releases)，以及可能存在的来自先前尝试的任何其他 `{release_main_version}` 草稿。**请勿**勾选"设置为最新版本"。 |
