|
| 1 | +--- |
| 2 | +title: 发布后沟通 |
| 3 | +content_type: concept |
| 4 | +weight: 60 |
| 5 | +--- |
| 6 | +<!-- |
| 7 | +title: Post-release communications |
| 8 | +content_type: concept |
| 9 | +weight: 60 |
| 10 | +--> |
| 11 | + |
| 12 | +<!-- overview --> |
| 13 | + |
| 14 | +<!-- |
| 15 | +The Kubernetes _Release Comms_ team (part of |
| 16 | +[SIG Release](http://github.com/kubernetes/community/tree/master/sig-release)) |
| 17 | +looks after release announcements, which go onto the |
| 18 | +[main project blog](/docs/contribute/blog/#main-blog). |
| 19 | +
|
| 20 | +After each release, the Release Comms team take over the main blog for a period |
| 21 | +and publish a series of additional articles to explain or announce changes related to |
| 22 | +that release. These additional articles are termed _post-release comms_. |
| 23 | +--> |
| 24 | +Kubernetes 的**发布沟通(Release Comms)** 团队(隶属于 |
| 25 | +[SIG Release](http://github.com/kubernetes/community/tree/master/sig-release)) |
| 26 | +负责管理发布相关的公告,这些公告会发布在[主项目博客](/docs/contribute/blog/#main-blog)上。 |
| 27 | + |
| 28 | +每次发布之后,发布沟通团队会在一段时间内接管主博客,并发布一系列额外的文章, |
| 29 | +用于解释或宣布与该版本相关的变更。这些额外的文章被称为**发布后沟通(Post-release comms)**。 |
| 30 | + |
| 31 | +<!-- body --> |
| 32 | + |
| 33 | +<!-- |
| 34 | +## Opting in to post-release comms {#opt-in} |
| 35 | +
|
| 36 | +During a release cycle, as a contributor, you can opt in to post-release comms about an |
| 37 | +upcoming change to Kubernetes. |
| 38 | +
|
| 39 | +To opt in you open a draft, _placeholder_ [pull request](http://www.k8s.dev/docs/guide/pull-requests/) (PR) |
| 40 | +against [k/website](http://github.com/kubernetes/website). Initially, this can be an |
| 41 | +empty commit. Mention the KEP issue or other Kubernetes improvement issue in the description |
| 42 | +of your placeholder PR. |
| 43 | +--> |
| 44 | +## 参与发布后沟通 {#opt-in} |
| 45 | + |
| 46 | +在一个发布周期中,作为贡献者,你可以选择参与关于 Kubernetes |
| 47 | +即将发生的变更的发布后沟通。 |
| 48 | + |
| 49 | +要选择参与,你需要针对 [k/website](http://github.com/kubernetes/website) |
| 50 | +提交一个草稿形式的**占位**[拉取请求(PR)](http://www.k8s.dev/docs/guide/pull-requests/)。 |
| 51 | +最初,这可以是一个空提交。在占位 PR 的描述中,请提及相关的 KEP(Kubernetes Enhancement Proposal) |
| 52 | +问题或其他 Kubernetes 改进相关的问题。 |
| 53 | + |
| 54 | +<!-- |
| 55 | +When you open the **draft** pull request, you open it against _main_ as the base branch |
| 56 | +and not against the `dev-{{< skew nextMinorVersion >}}` branch. This is different from |
| 57 | +the [process](/docs/contribute/new-content/new-features/#open-a-placeholder-pr) for upcoming release changes and new features. |
| 58 | +
|
| 59 | +You should also leave a comment on the related [kubernetes/enhancements](http://github.com/kubernetes/enhancements) |
| 60 | +issue with a link to the PR to notify the Release Comms team managing this release. Your comment |
| 61 | +helps the team see that the change needs announcing and that your SIG has opted in. |
| 62 | +
|
| 63 | +As well as the above, you should ideally contact the Release Comms team via Slack |
| 64 | +(channel [`#release-comms`](http://kubernetes.slack.com/archives/CNT9Y603D)) to let them |
| 65 | +know that you have done this and would like to opt in. |
| 66 | +--> |
| 67 | +当你提交**草稿**拉取请求时,需要以 **main** 作为基础分支, |
| 68 | +而不是针对 `dev-{{< skew nextMinorVersion >}}` 分支。 |
| 69 | +这与即将发布的变更和新功能的[流程](/zh-cn/docs/contribute/new-content/new-features/#open-a-placeholder-pr)不同。 |
| 70 | + |
| 71 | +你还应在相关的 [kubernetes/enhancements](http://github.com/kubernetes/enhancements) |
| 72 | +问题下留下评论,并附上拉取请求的链接,以通知负责本次发布的发布沟通团队。 |
| 73 | +你的评论有助于团队了解该变更需要发布公告,并确认你的 SIG 已选择参与。 |
| 74 | + |
| 75 | +除此之外,理想情况下,你还应通过 Slack(频道 |
| 76 | +[`#release-comms`](http://kubernetes.slack.com/archives/CNT9Y603D)) |
| 77 | +联系发布沟通团队,告知他们你已完成上述操作并希望选择参与。 |
| 78 | + |
| 79 | +<!-- |
| 80 | +## Preparing the article content {#preparation} |
| 81 | +
|
| 82 | +You should follow the usual [article submission](/docs/contribute/blog/article-submission/) |
| 83 | +process to turn your placeholder PR into something ready for review. However, for |
| 84 | +post-release comms, you may not have a _writing buddy_; instead, the Release Comms team |
| 85 | +may assign a member of the team to help guide what you're doing. |
| 86 | +--> |
| 87 | +## 准备文章内容 {#preparation} |
| 88 | + |
| 89 | +你应该遵循常规的[文章提交](/zh-cn/docs/contribute/blog/article-submission/)流程, |
| 90 | +将你的占位 PR 转变为可供评审的内容。然而,对于发布后沟通, |
| 91 | +你可能不会有一个**写作伙伴**;取而代之的是,发布沟通团队可能会指派一名成员来帮助指导你的工作。 |
| 92 | + |
| 93 | +<!-- |
| 94 | +You should [squash](http://www.k8s.dev/docs/guide/pull-requests/#squashing) the commits |
| 95 | +in your pull request; if you're not sure how to, it's absolutely OK to ask Release Comms or |
| 96 | +the blog team for help. |
| 97 | +
|
| 98 | +Provided that your article is flagged as a draft (`draft: true`) in the |
| 99 | +[front matter](http://gohugo.io/content-management/front-matter/), the PR can merge at any |
| 100 | +time during the release cycle. |
| 101 | +--> |
| 102 | +你应该[压缩](http://www.k8s.dev/docs/guide/pull-requests/#squashing)拉取请求中的提交; |
| 103 | +如果你不确定如何操作,完全可以向发布沟通团队或博客团队寻求帮助。 |
| 104 | + |
| 105 | +只要你的文章在[前言](http://gohugo.io/content-management/front-matter/)中被标记为草稿(`draft: true`), |
| 106 | +该 PR 就可以在发布周期的任何时间合并。 |
| 107 | + |
| 108 | +<!-- |
| 109 | +## Publication |
| 110 | +
|
| 111 | +Ahead of the actual release, the Release Comms team check what content is ready (if it's |
| 112 | +not ready by the deadline, and you didn't get an exception, then the announcement won't |
| 113 | +be included). They build a schedule for the articles that will go out and open new |
| 114 | +pull requests to turn those articles from draft to published. |
| 115 | +--> |
| 116 | +## 发布 |
| 117 | + |
| 118 | +在实际发布之前,发布沟通团队会检查哪些内容已经准备就绪 |
| 119 | +(如果到了截止日期仍未准备好,且你没有获得豁免,那么公告将不会被收录)。 |
| 120 | +他们为即将发布的文章制定时间表,并开启新的拉取请求,将这些文章从草稿转为已发布。 |
| 121 | +以将这些文章从草稿状态变为已发布状态。 |
| 122 | + |
| 123 | +{{< caution >}} |
| 124 | +<!-- |
| 125 | +All these pull requests to actually publish post-release articles **must** be held |
| 126 | +(Prow command `/hold`) until the release has actually happened. |
| 127 | +--> |
| 128 | +所有用于实际发布发布后文章的拉取请求**必须**被暂停(Prow 命令 `/hold`), |
| 129 | +直到发布实际完成为止。 |
| 130 | +{{< /caution >}} |
| 131 | + |
| 132 | +<!-- |
| 133 | +The blog team approvers still provide final sign off on promoting the content from draft |
| 134 | +to accepted for publication. Ahead of release day, the PR (or PRs) for publishing these |
| 135 | +announcements should have LGTM (“looks good to me”) and approved labels, along with the |
| 136 | +**do-not-merge/hold** label to ensure the PR doesn't merge too early. |
| 137 | +--> |
| 138 | +博客团队的批准者仍然需要对从草稿到可发布的内容提供最终的签字批准。 |
| 139 | +在发布日前,用于发布这些公告的拉取请求(PR)应已获得 LGTM(“我觉得不错”) |
| 140 | +和批准标签,同时还需要添加 **do-not-merge/hold** 标签,以确保 PR 不会过早合并。 |
| 141 | + |
| 142 | +<!-- |
| 143 | +Release Comms / the Release Team can then _unhold_ that PR (or set of PRs) as soon as the |
| 144 | +website Git repository is unfrozen after the actual release. |
| 145 | +
|
| 146 | +On the day each article is scheduled to publish, automation triggers a website build and that |
| 147 | +article becomes visible. |
| 148 | +--> |
| 149 | +一旦实际发布完成并且网站 Git 仓库解冻,发布沟通团队或发布团队可以立即**取消保留** PR(或一组 PR) |
| 150 | +PR(或一组 PR)的 **hold** 状态。 |
| 151 | + |
| 152 | +在每篇文章预定发布的当天,自动化流程将触发网站构建,该文章将会变成可见。 |
0 commit comments