Release Notes for CAPIgw v0.4.x

This commit is contained in:
Jeff-Apple 2022-08-12 14:17:29 -07:00
parent 47a36c9137
commit e317b493dd
2 changed files with 76 additions and 0 deletions

View File

@ -0,0 +1,72 @@
---
layout: docs
page_title: 0.4.x
description: >-
Consul API Gateway release notes for version 0.4.x
---
# Consul API Gateway 0.4.0
## Release Highlights
- **Support for Kubernetes Gateway API Version 0.5.0 and v1beta1 APIs:**
The `v0.5.0` release of the Kubernetes Gateway API is significant because it
marks the growth in maturity to a beta API version (v1beta1) release for some
of the key APIs:
- GatewayClass
- Gateway
- HTTPRoute
The other APIs (e.g. TCPRoute) are still at the `v1alpha2` stage.
Reaching `v1beta1` status has several benefits for users, including greater
stability and backward compatibility requirements. Existing fields and allowed
options can not be removed or renamed except in a new, major version of the
API. Once an API reaches `v1beta1` status, future versions must comply with
several backward compatibility requirements.
- **URL Path Prefix Rewrite**
This release introduces support for rewriting a URL's path prefix when routing
HTTP traffic. This is configured by adding a `URLRewrite` filter to a
`HTTPRoute`. With this feature, the gateway can rewrite the URL path, in a
client's HTTP Request, before sending the request to a service. A simple
example of this is changing the path from `//store/checkout` to
`//cart/checkout`. Please see the product documentation for details on how to
configure this feature.
## What's Changed
- **Reference Policy Renamed to Reference Grant** In v0.5.0 of the Kubernetes
Gateway API, `ReferencePolicy` has been renamed to `ReferenceGrant`. This
release supports both but `ReferencePolicy` is deprecated and will be removed
in a future version of the standard.
After upgrading to this version of Consul API Gateway, you should rename all
existing `ReferencePolicy`y to `ReferenceGrant`s. Please see the upgrading
instructions for additional details.
## Supported Software
- Consul 1.11.2+
- HashiCorp Consul Helm chart 0.47.0+
- Kubernetes 1.21+
- Kubernetes 1.24 is not supported at this time.
- Kubectl 1.21+
- Envoy proxy support is determined by the Consul version deployed. Refer to
[Envoy Integration](/docs/connect/proxies/envoy) for details.
## Kubernetes Gateway API Specification
Supported version of the [Gateway API](https://gateway-api.sigs.k8s.io/) spec: v0.5.0
## Upgrading
For detailed information on upgrading, please refer to the [Upgrades page](/docs/api-gateway/upgrades)
## Changelogs
The changelogs for this major release version and any maintenance versions are listed below.
~> **Note:** The following link will take you to the changelogs on the GitHub website.
- [0.4.0](https://github.com/hashicorp/consul-api-gateway/releases/tag/v0.4.0)

View File

@ -1261,6 +1261,10 @@
{ {
"title": "Consul API Gateway", "title": "Consul API Gateway",
"routes": [ "routes": [
{
"title": "v0.4.x",
"path": "release-notes/consul-api-gateway/v0_4_x"
},
{ {
"title": "v0.3.x", "title": "v0.3.x",
"path": "release-notes/consul-api-gateway/v0_3_x" "path": "release-notes/consul-api-gateway/v0_3_x"