Alauda Container Platform

Gateway API CRD versions

TOC

OverviewACP release mappingACP 3.16.x - 4.1.xACP 4.2.1 - 4.2.xACP 4.3.xACP 4.4.x

Overview

ACP maintains and installs the standard Gateway API custom resource definitions (CRDs) as part of the platform lifecycle. The Envoy Gateway Operator manages Envoy Gateway extension CRDs in the gateway.envoyproxy.io API group; it does not own the standard Gateway API CRDs in the gateway.networking.k8s.io API group.

ACP uses the Gateway API CRDs from the Gateway API Experimental channel. This channel includes the standard Gateway API resources and experimental Gateway API resources such as BackendTLSPolicy and ListenerSet.

Do not install a second Gateway API CRD bundle in an ACP-managed cluster. Use the CRDs provided by the ACP release when creating or upgrading Gateway, Route, Policy, and ListenerSet resources.

ACP 3.16 was the first release with Gateway API CRDs. The version table below records the CRDs maintained by ACP for each release line.

ACP release mapping

Each release-line table lists one CRD per row. Type identifies whether the CRD comes from the Gateway API project or Envoy Gateway. Version contains the served versions, Storage version contains the version used to persist the resource, and Bundle version identifies the Gateway API CRD bundle. N/A means that the CRD is not part of the Gateway API bundle.

ACP 3.16.x - 4.1.x

TypeCRDVersionStorage versionBundle version
Gateway APIGatewayClassv1alpha2, v1, v1beta1v1beta1v1.0.0
Gateway APIGatewayv1alpha2, v1, v1beta1v1beta1v1.0.0
Gateway APIGRPCRoutev1alpha2v1alpha2v1.0.0
Gateway APIHTTPRoutev1alpha2, v1, v1beta1v1beta1v1.0.0
Gateway APIReferenceGrantv1alpha2, v1beta1v1beta1v1.0.0
Gateway APITCPRoutev1alpha2v1alpha2v1.0.0
Gateway APITLSRoutev1alpha2v1alpha2v1.0.0
Gateway APIUDPRoutev1alpha2v1alpha2v1.0.0
Gateway APIBackendTLSPolicyv1alpha2v1alpha2v1.0.0

Changes:

  • Gateway API CRDs are first introduced in ACP 3.16.
  • This release line contains the initial standard Gateway API CRD set and no ACP Gateway API extension CRDs.

ACP 4.2.1 - 4.2.x

TypeCRDVersionStorage versionBundle version
Gateway APIGatewayClassv1alpha2, v1, v1beta1v1v1.3.0
Gateway APIGatewayv1alpha2, v1, v1beta1v1v1.3.0
Gateway APIGRPCRoutev1alpha2, v1v1v1.3.0
Gateway APIHTTPRoutev1alpha2, v1, v1beta1v1v1.3.0
Gateway APIReferenceGrantv1alpha2, v1beta1v1beta1v1.3.0
Gateway APITCPRoutev1alpha2v1alpha2v1.3.0
Gateway APITLSRoutev1alpha2v1alpha2v1.3.0
Gateway APIUDPRoutev1alpha2v1alpha2v1.3.0
Gateway APIBackendTLSPolicyv1alpha2, v1alpha3v1alpha3v1.3.0
Gateway APIXBackendTrafficPolicyv1alpha1v1alpha1v1.3.0
Gateway APIXListenerSetv1alpha1v1alpha1v1.3.0

Changes:

  • The Gateway API CRD bundle is updated to v1.3.0.
  • Storage changes to v1 for GatewayClass, Gateway, GRPCRoute, and HTTPRoute.
  • BackendTLSPolicy adds v1alpha3 and changes storage to v1alpha3.
  • XBackendTrafficPolicy and XListenerSet are added.

ACP 4.3.x

TypeCRDVersionStorage versionBundle version
Gateway APIGatewayClassv1alpha2, v1, v1beta1v1v1.4.1
Gateway APIGatewayv1alpha2, v1, v1beta1v1v1.4.1
Gateway APIGRPCRoutev1alpha2, v1v1v1.4.1
Gateway APIHTTPRoutev1alpha2, v1, v1beta1v1v1.4.1
Gateway APIReferenceGrantv1alpha2, v1beta1v1beta1v1.4.1
Gateway APITCPRoutev1alpha2v1alpha2v1.4.1
Gateway APITLSRoutev1alpha2, v1alpha3v1alpha3v1.4.1
Gateway APIUDPRoutev1alpha2v1alpha2v1.4.1
Gateway APIBackendTLSPolicyv1alpha2, v1alpha3, v1v1v1.4.1
Gateway APIXBackendTrafficPolicyv1alpha1v1alpha1v1.4.1
Gateway APIXListenerSetv1alpha1v1alpha1v1.4.1
Gateway APIXMeshv1alpha1v1alpha1v1.4.1
Envoy GatewayBackendv1alpha1v1alpha1N/A
Envoy GatewayBackendTrafficPolicyv1alpha1v1alpha1N/A
Envoy GatewayClientTrafficPolicyv1alpha1v1alpha1N/A
Envoy GatewayEnvoyExtensionPolicyv1alpha1v1alpha1N/A
Envoy GatewayEnvoyPatchPolicyv1alpha1v1alpha1N/A
Envoy GatewayEnvoyProxyv1alpha1v1alpha1N/A
Envoy GatewayHTTPRouteFilterv1alpha1v1alpha1N/A
Envoy GatewaySecurityPolicyv1alpha1v1alpha1N/A

Changes:

  • The Gateway API CRD bundle is updated to v1.4.1.
  • BackendTLSPolicy adds served v1 and changes storage to v1.
  • TLSRoute adds served v1alpha3 and changes storage to v1alpha3.
  • XMesh is added.
  • Envoy Gateway CRDs are included as v1alpha1 resources.

ACP 4.4.x

TypeCRDVersionStorage versionBundle version
Gateway APIGatewayClassv1alpha2, v1, v1beta1v1v1.5.1
Gateway APIGatewayv1alpha2, v1, v1beta1v1v1.5.1
Gateway APIGRPCRoutev1alpha2, v1v1v1.5.1
Gateway APIHTTPRoutev1alpha2, v1, v1beta1v1v1.5.1
Gateway APIReferenceGrantv1, v1alpha2, v1beta1v1beta1v1.5.1
Gateway APITCPRoutev1alpha2v1alpha2v1.5.1
Gateway APITLSRoutev1, v1alpha2, v1alpha3v1v1.5.1
Gateway APIUDPRoutev1alpha2v1alpha2v1.5.1
Gateway APIBackendTLSPolicyv1, v1alpha2, v1alpha3v1v1.5.1
Gateway APIListenerSetv1v1v1.5.1
Gateway APIXBackendTrafficPolicyv1alpha1v1alpha1v1.5.1
Gateway APIXListenerSetv1alpha1v1alpha1v1.4.1
Gateway APIXMeshv1alpha1v1alpha1v1.5.1
Envoy GatewayBackendv1alpha1v1alpha1N/A
Envoy GatewayBackendTrafficPolicyv1alpha1v1alpha1N/A
Envoy GatewayClientTrafficPolicyv1alpha1v1alpha1N/A
Envoy GatewayEnvoyExtensionPolicyv1alpha1v1alpha1N/A
Envoy GatewayEnvoyPatchPolicyv1alpha1v1alpha1N/A
Envoy GatewayEnvoyProxyv1alpha1v1alpha1N/A
Envoy GatewayHTTPRouteFilterv1alpha1v1alpha1N/A
Envoy GatewaySecurityPolicyv1alpha1v1alpha1N/A

Changes:

  • The standard Gateway API CRD bundle is updated to v1.5.1.
  • ListenerSet is added.
  • ReferenceGrant adds served v1.
  • TLSRoute adds served v1 and changes storage to v1.
  • BackendTLSPolicy serves v1 and uses it for storage.
  • Envoy Gateway CRDs remain at v1alpha1.

For the configuration workflow, see Configure GatewayAPI Gateway, Configure GatewayAPI Route, and Configure GatewayAPI Policy.