|
| 1 | +--- |
| 2 | +layout: blog |
| 3 | +title: "Gateway API v1.0:正式发布(GA)" |
| 4 | +date: 2023-10-31T10:00:00-08:00 |
| 5 | +slug: gateway-api-ga |
| 6 | +--- |
| 7 | + |
| 8 | +<!-- |
| 9 | +layout: blog |
| 10 | +title: "Gateway API v1.0: GA Release" |
| 11 | +date: 2023-10-31T10:00:00-08:00 |
| 12 | +slug: gateway-api-ga |
| 13 | +--> |
| 14 | + |
| 15 | +<!-- |
| 16 | +**Authors:** Shane Utt (Kong), Nick Young (Isovalent), Rob Scott (Google) |
| 17 | +--> |
| 18 | +**作者:** Shane Utt (Kong), Nick Young (Isovalent), Rob Scott (Google) |
| 19 | + |
| 20 | +**译者:** Xin Li (Daocloud) |
| 21 | + |
| 22 | +<!-- |
| 23 | +On behalf of Kubernetes SIG Network, we are pleased to announce the v1.0 release of [Gateway |
| 24 | +API](https://gateway-api.sigs.k8s.io/)! This release marks a huge milestone for |
| 25 | +this project. Several key APIs are graduating to GA (generally available), while |
| 26 | +other significant features have been added to the Experimental channel. |
| 27 | +--> |
| 28 | +我们代表 Kubernetes SIG Network 很高兴地宣布 [Gateway API](https://gateway-api.sigs.k8s.io/) |
| 29 | +v1.0 版本发布!此版本是该项目的一个重要里程碑。几个关键的 API 正在逐步进入 GA(正式发布)阶段, |
| 30 | +同时其他重要特性已添加到实验(Experimental)通道中。 |
| 31 | + |
| 32 | +<!-- |
| 33 | +## What's new |
| 34 | +
|
| 35 | +### Graduation to v1 |
| 36 | +This release includes the graduation of |
| 37 | +[Gateway](https://gateway-api.sigs.k8s.io/api-types/gateway/), |
| 38 | +[GatewayClass](https://gateway-api.sigs.k8s.io/api-types/gatewayclass/), and |
| 39 | +[HTTPRoute](https://gateway-api.sigs.k8s.io/api-types/httproute/) to v1, which |
| 40 | +means they are now generally available (GA). This API version denotes a high |
| 41 | +level of confidence in the API surface and provides guarantees of backwards |
| 42 | +compatibility. Note that although, the version of these APIs included in the |
| 43 | +Standard channel are now considered stable, that does not mean that they are |
| 44 | +complete. These APIs will continue to receive new features via the Experimental |
| 45 | +channel as they meet graduation criteria. For more information on how all of |
| 46 | +this works, refer to the [Gateway API Versioning |
| 47 | +Policy](https://gateway-api.sigs.k8s.io/concepts/versioning/). |
| 48 | +--> |
| 49 | +## 新增内容 |
| 50 | + |
| 51 | +### 升级到 v1 |
| 52 | + |
| 53 | +此版本将 [Gateway](https://gateway-api.sigs.k8s.io/api-types/gateway/)、 |
| 54 | +[GatewayClass](https://gateway-api.sigs.k8s.io/api-types/gatewayclass/) 和 |
| 55 | +[HTTPRoute](https://gateway-api.sigs.k8s.io/api-types/httproute/) 升级到 v1 版本, |
| 56 | +这意味着它们现在是正式发布(GA)的版本。这个 API 版本表明我们对 API 的可感知方面具有较强的信心,并提供向后兼容的保证。 |
| 57 | +需要注意的是,虽然标准(Standard)通道中所包含的这个版本的 API 集合现在被认为是稳定的,但这并不意味着它们是完整的。 |
| 58 | +即便这些 API 已满足毕业标准,仍将继续通过实验(Experimental)通道接收新特性。要了解相关工作的组织方式的进一步信息,请参阅 |
| 59 | +[Gateway API 版本控制策略](https://gateway-api.sigs.k8s.io/concepts/versioning/)。 |
| 60 | + |
| 61 | +<!-- |
| 62 | +### Logo |
| 63 | +Gateway API now has a logo! This logo was designed through a collaborative |
| 64 | +process, and is intended to represent the idea that this is a set of Kubernetes |
| 65 | +APIs for routing traffic both north-south and east-west: |
| 66 | +--> |
| 67 | +Gateway API 现在有了自己的 Logo!这个 Logo 是通过协作方式设计的, |
| 68 | +旨在表达这是一组用于路由南北向和东西向流量的 Kubernetes API: |
| 69 | + |
| 70 | + |
| 71 | + |
| 72 | +<!-- |
| 73 | +### CEL Validation |
| 74 | +Historically, Gateway API has bundled a validating webhook as part of installing |
| 75 | +the API. Starting in v1.0, webhook installation is optional and only recommended |
| 76 | +for Kubernetes 1.24. Gateway API now includes |
| 77 | +[CEL](/docs/reference/using-api/cel/) validation rules as |
| 78 | +part of the |
| 79 | +[CRDs](/docs/concepts/extend-kubernetes/api-extension/custom-resources/). |
| 80 | +This new form of validation is supported in Kubernetes 1.25+, and thus the |
| 81 | +validating webhook is no longer required in most installations. |
| 82 | +--> |
| 83 | +### CEL 验证 |
| 84 | + |
| 85 | +过去,Gateway API 在安装 API 时绑定了一个验证性质(Validation)的 Webhook。 |
| 86 | +从 v1.0 开始,Webhook 的安装是可选的,仅建议在 Kubernetes 1.24 版本上使用。 |
| 87 | +Gateway API 现在将 [CEL](/zh-cn/docs/reference/using-api/cel/) 验证规则包含在 |
| 88 | +[CRD](/zh-cn/docs/concepts/extend-kubernetes/api-extension/custom-resources/) |
| 89 | +中。Kubernetes 1.25 及以上版本支持这种新形式的验证,因此大多数安装中不再需要验证性质的 Webhook。 |
| 90 | + |
| 91 | +<!-- |
| 92 | +### Standard channel |
| 93 | +This release was primarily focused on ensuring that the existing beta APIs were |
| 94 | +well defined and sufficiently stable to graduate to GA. That led to a variety of |
| 95 | +spec clarifications, as well as some improvements to status to improve the |
| 96 | +overall UX when interacting with Gateway API. |
| 97 | +--> |
| 98 | +### 标准(Standard)通道 |
| 99 | + |
| 100 | +此发行版本主要侧重于确保现有 Beta 级别 API 定义良好且足够稳定,可以升级为 GA。 |
| 101 | +其背后意味着为了提高与 Gateway API 交互时的整体用户体验而作的各种规范的澄清以及一些改进。 |
| 102 | + |
| 103 | +<!-- |
| 104 | +### Experimental channel |
| 105 | +Most of the changes included in this release were limited to the experimental |
| 106 | +channel. These include HTTPRoute timeouts, TLS config from Gateways to backends, |
| 107 | +WebSocket support, Gateway infrastructure labels, and more. Stay tuned for a |
| 108 | +follow up blog post that will cover each of these new features in detail. |
| 109 | +--> |
| 110 | +## 实验(Experimental)通道 |
| 111 | + |
| 112 | +此发行版本中包含的大部分更改都限于实验通道。这些更改包括 HTTPRoute |
| 113 | +超时、用于 Gateway 访问后端的 TLS 配置、WebSocket 支持、Gateway 基础设施的标签等等。 |
| 114 | +请继续关注后续博客,我们将详细介绍这些新特性。 |
| 115 | + |
| 116 | +<!-- |
| 117 | +### Everything else |
| 118 | +For a full list of the changes included in this release, please refer to the |
| 119 | +[v1.0.0 release |
| 120 | +notes](https://github.com/kubernetes-sigs/gateway-api/releases/tag/v1.0.0). |
| 121 | +--> |
| 122 | +## 其他内容 |
| 123 | + |
| 124 | +有关此版本中包含的所有更改的完整列表,请参阅 |
| 125 | +[v1.0.0 版本说明](https://github.com/kubernetes-sigs/gateway-api/releases/tag/v1.0.0)。 |
| 126 | + |
| 127 | +<!-- |
| 128 | +## How we got here |
| 129 | +
|
| 130 | +The idea of Gateway API was initially [proposed](https://youtu.be/Ne9UJL6irXY?si=wgtC9w8PMB5ZHil2) |
| 131 | +4 years ago at KubeCon San Diego as the next generation |
| 132 | +of Ingress API. Since then, an incredible community has formed to develop what |
| 133 | +has likely become the most collaborative API in Kubernetes history. Over 170 |
| 134 | +people have contributed to this API so far, and that number continues to grow. |
| 135 | +--> |
| 136 | +## 发展历程 |
| 137 | + |
| 138 | +Gateway API 的想法最初是在 4 年前的 KubeCon 圣地亚哥[提出](https://youtu.be/Ne9UJL6irXY?si=wgtC9w8PMB5ZHil2)的, |
| 139 | +下一代 Ingress API。那次会议之后,诞生了一个令人难以置信的社区,致力于开发一种可能是 Kubernetes |
| 140 | +历史上协作关系最密切的 API。 |
| 141 | +迄今为止,已有超过 170 人为此 API 做出了贡献,而且这个数字还在不断增长。 |
| 142 | + |
| 143 | +<!-- |
| 144 | +A special thank you to the 20+ [community members who agreed to take on an |
| 145 | +official role in the |
| 146 | +project](https://github.com/kubernetes-sigs/gateway-api/blob/main/OWNERS_ALIASES), |
| 147 | +providing some time for reviews and sharing the load of maintaining the project! |
| 148 | +
|
| 149 | +We especially want to highlight the emeritus maintainers that played a pivotal |
| 150 | +role in the early development of this project: |
| 151 | +--> |
| 152 | +特别感谢 20 多位[愿意在项目中担任正式角色](https://github.com/kubernetes-sigs/gateway-api/blob/main/OWNERS_ALIASES)的社区成员, |
| 153 | +他们付出了时间进行评审并分担项目维护的负担! |
| 154 | + |
| 155 | +我们特别要强调那些在项目早期发展中起到关键作用的荣誉维护者: |
| 156 | + |
| 157 | +* [Bowei Du](https://github.com/bowei) |
| 158 | +* [Daneyon Hansen](https://github.com/danehans) |
| 159 | +* [Harry Bagdi](https://github.com/hbagdi) |
| 160 | + |
| 161 | +<!-- |
| 162 | +## Try it out |
| 163 | +
|
| 164 | +Unlike other Kubernetes APIs, you don't need to upgrade to the latest version of |
| 165 | +Kubernetes to get the latest version of Gateway API. As long as you're running |
| 166 | +one of the 5 most recent minor versions of Kubernetes (1.24+), you'll be able to |
| 167 | +get up and running with the latest version of Gateway API. |
| 168 | +
|
| 169 | +To try out the API, follow our [Getting Started |
| 170 | +guide](https://gateway-api.sigs.k8s.io/guides/). |
| 171 | +--> |
| 172 | +## 尝试一下 |
| 173 | + |
| 174 | +与其他 Kubernetes API 不同,你无需升级到最新版本的 Kubernetes 即可获取最新版本的 |
| 175 | +Gateway API。只要运行的是 Kubernetes 最新的 5 个次要版本之一(1.24+), |
| 176 | +就可以使用最新版本的 Gateway API。 |
| 177 | + |
| 178 | +要尝试此 API,请参照我们的[入门指南](https://gateway-api.sigs.k8s.io/guides/)。 |
| 179 | + |
| 180 | +<!-- |
| 181 | +## What's next |
| 182 | +
|
| 183 | +This release is just the beginning of a much larger journey for Gateway API, and |
| 184 | +there are still plenty of new features and new ideas in flight for future |
| 185 | +releases of the API. |
| 186 | +--> |
| 187 | +## 下一步 |
| 188 | + |
| 189 | +此版本只是 Gateway API 更广泛前景的开始,将来的 API 版本中还有很多新特性和新想法。 |
| 190 | + |
| 191 | +<!-- |
| 192 | +One of our key goals going forward is to work to stabilize and graduate other |
| 193 | +experimental features of the API. These include [support for service |
| 194 | +mesh](https://gateway-api.sigs.k8s.io/concepts/gamma/), additional route types |
| 195 | +([GRPCRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.GRPCRoute), |
| 196 | +[TCPRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.TCPRoute), |
| 197 | +[TLSRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.TLSRoute), |
| 198 | +[UDPRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.UDPRoute)), |
| 199 | +and a variety of experimental features. |
| 200 | +--> |
| 201 | +我们未来的一个关键目标是努力稳定和升级 API 的其他实验级特性。 |
| 202 | +这些特性包括支持[服务网格](https://gateway-api.sigs.k8s.io/concepts/gamma/)、 |
| 203 | +额外的路由类型([GRPCRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.GRPCRoute)、 |
| 204 | +[TCPRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.TCPRoute)、 |
| 205 | +[TLSRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.TLSRoute)、 |
| 206 | +[UDPRoute](https://gateway-api.sigs.k8s.io/references/spec/#gateway.networking.k8s.io/v1alpha2.UDPRoute))以及各种实验级特性。 |
| 207 | + |
| 208 | +<!-- |
| 209 | +We've also been working towards moving |
| 210 | +[ReferenceGrant](https://gateway-api.sigs.k8s.io/api-types/referencegrant/) into |
| 211 | +a built-in Kubernetes API that can be used for more than just Gateway API. |
| 212 | +Within Gateway API, we've used this resource to safely enable cross-namespace |
| 213 | +references, and that concept is now being adopted by other SIGs. The new version |
| 214 | +of this API will be owned by SIG Auth and will likely include at least some |
| 215 | +modifications as it migrates to a built-in Kubernetes API. |
| 216 | +--> |
| 217 | +我们还致力于将 [ReferenceGrant](https://gateway-api.sigs.k8s.io/api-types/referencegrant/) |
| 218 | +移入内置的 Kubernetes API 中,使其不仅仅可用于网关 API。在 Gateway API 中,我们使用这个资源来安全地实现跨命名空间引用, |
| 219 | +而这个概念现在被其他 SIG 采纳。这个 API 的新版本将归 SIG Auth 所有,在移到内置的 |
| 220 | +Kubernetes API 时可能至少包含一些修改。 |
| 221 | + |
| 222 | +<!-- |
| 223 | +### Gateway API at KubeCon + CloudNativeCon |
| 224 | +
|
| 225 | +At [KubeCon North America |
| 226 | +(Chicago)](https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/) |
| 227 | +and the adjacent [Contributor |
| 228 | +Summit](https://www.kubernetes.dev/events/2023/kcsna/) there are several talks |
| 229 | +related to Gateway API that will go into more detail on these topics. If you're |
| 230 | +attending either of these events this year, considering adding these to your |
| 231 | +schedule. |
| 232 | +--> |
| 233 | +### Gateway API 现身于 KubeCon + CloudNativeCon |
| 234 | + |
| 235 | +在 [KubeCon 北美(芝加哥)](https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/) |
| 236 | +和同场的[贡献者峰会](https://www.kubernetes.dev/events/2023/kcsna/)上, |
| 237 | +有几个与 Gateway API 相关的演讲将详细介绍这些主题。如果你今年要参加其中的一场活动, |
| 238 | +请考虑将它们添加到你的日程安排中。 |
| 239 | + |
| 240 | +<!-- |
| 241 | +**Contributor Summit:** |
| 242 | +
|
| 243 | +- [Lessons Learned Building a GA API with CRDs](https://sched.co/1Sp9u) |
| 244 | +- [Conformance Profiles: Building a generic conformance test reporting framework](https://sched.co/1Sp9l) |
| 245 | +- [Gateway API: Beyond GA](https://sched.co/1SpA9) |
| 246 | +--> |
| 247 | +**贡献者峰会:** |
| 248 | + |
| 249 | +- [使用 CRD 构建 GA API 的经验教训](https://sched.co/1Sp9u) |
| 250 | +- [合规性配置文件:构建通用合规性测试报告框架](https://sched.co/1Sp9l) |
| 251 | +- [Gateway API:GA 以后](https://sched.co/1SpA9) |
| 252 | + |
| 253 | +<!-- |
| 254 | +**KubeCon Main Event:** |
| 255 | +
|
| 256 | +- [Gateway API: The Most Collaborative API in Kubernetes History Is GA](https://sched.co/1R2qM) |
| 257 | +--> |
| 258 | +**KubeCon 主要活动:** |
| 259 | + |
| 260 | +- [Gateway API:Kubernetes 历史上协作性最强的 API 已经正式发布](https://sched.co/1R2qM) |
| 261 | + |
| 262 | +<!-- |
| 263 | +**KubeCon Office Hours:** |
| 264 | +
|
| 265 | +Gateway API maintainers will be holding office hours sessions at KubeCon if |
| 266 | +you'd like to discuss or brainstorm any related topics. To get the latest |
| 267 | +updates on these sessions, join the `#sig-network-gateway-api` channel on |
| 268 | +[Kubernetes Slack](https://slack.kubernetes.io/). |
| 269 | +--> |
| 270 | +**KubeCon 办公时间:** |
| 271 | + |
| 272 | +如果你想就相关主题发起讨论或参与头脑风暴,请参加 Gateway API 维护人员在 KubeCon 上举行办公时间会议。 |
| 273 | +要获取有关这些会议的最新更新,请加入 [Kubernetes Slack](https://slack.kubernetes.io/) |
| 274 | +上的 `#sig-network-gateway-api` 频道。 |
| 275 | + |
| 276 | +<!-- |
| 277 | +## Get involved |
| 278 | +
|
| 279 | +We've only barely scratched the surface of what's in flight with Gateway API. |
| 280 | +There are lots of opportunities to get involved and help define the future of |
| 281 | +Kubernetes routing APIs for both Ingress and Mesh. |
| 282 | +--> |
| 283 | +## 参与其中 |
| 284 | + |
| 285 | +我们只是初步介绍了 Gateway API 正在进行的工作。 |
| 286 | +有很多机会参与并帮助定义 Ingress 和 Mesh 的 Kubernetes 路由 API 的未来。 |
| 287 | + |
| 288 | +<!-- |
| 289 | +If this is interesting to you, please [join us in the |
| 290 | +community](https://gateway-api.sigs.k8s.io/contributing/) and help us build the |
| 291 | +future of Gateway API together! |
| 292 | +--> |
| 293 | +如果你对此感兴趣,请[加入我们的社区](https://gateway-api.sigs.k8s.io/contributing/)并帮助我们共同构建 |
| 294 | +Gateway API 的未来! |
0 commit comments