feat(gateway-api): Add custom backendRef and filters support for HTTPRoute

[kahirokunn]

Description

This PR adds support for custom backend references in Flagger's primary and canary services. This enhancement allows users to specify different routing configurations and intermediate services for primary and canary traffic, enabling more complex deployment patterns and better integration with existing infrastructure.

Key Changes

• Added backendRef and filters to spec.service.canary and spec.service.primary
• Updated Gateway API router to support custom backend references
• Modified service reconciliation logic to handle custom backend configurations
• Added support for service-specific filters
• Maintained backward compatibility with existing configurations

Use Cases

This feature enables several important scenarios:

1. Routing through security proxies
2. Adding service-specific monitoring
3. Implementing different circuit breaker configurations
4. Supporting complex mesh architectures
5. Applying different filtering rules for primary and canary traffic

Example Configuration

apiVersion: flagger.app/v1beta1
kind: Canary
metadata:
  name: my-app
spec:
  service:
    primary:
      filters:
        - type: RequestHeaderModifier
          requestHeaderModifier:
            set:
              - name: x-route
                value: primary
    canary:
      backendRef:
        name: canary-proxy
        namespace: monitoring
        port: 3456
      filters:
        - type: RequestHeaderModifier
          requestHeaderModifier:
            set:
              - name: x-route
                value: canary

Breaking Changes

None. This is a backward-compatible change that maintains existing behavior when custom backend references are not specified.

Additional Context

This change also allows for cases where different backends are referenced for canary and primary, as shown in the attached image.
For details, please refer to the following PR.
#1714

Issue

#1741

TODO

• add finalize ReferenceGrants

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 45.96100% with 194 lines in your changes missing coverage. Please review.

Project coverage is 39.34%. Comparing base (febc327) to head (4f3511b).
Report is 10 commits behind head on main.

Files with missing lines	Patch %	Lines
...ped/gatewayapi/v1beta1/fake/fake_referencegrant.go	22.05%	52 Missing and 1 partial ⚠️
...g/apis/gatewayapi/v1beta1/zz_generated.deepcopy.go	41.37%	50 Missing and 1 partial ⚠️
pkg/apis/flagger/v1beta1/zz_generated.deepcopy.go	0.00%	24 Missing ⚠️
pkg/router/gateway_api.go	81.74%	18 Missing and 5 partials ⚠️
...ernalversions/gatewayapi/v1beta1/referencegrant.go	0.00%	21 Missing ⚠️
...rsioned/typed/gatewayapi/v1beta1/referencegrant.go	0.00%	9 Missing ⚠️
...lient/listers/gatewayapi/v1beta1/referencegrant.go	0.00%	4 Missing ⚠️
pkg/router/kubernetes_default.go	70.00%	2 Missing and 1 partial ⚠️
...oned/typed/gatewayapi/v1beta1/gatewayapi_client.go	0.00%	2 Missing ⚠️
...s/externalversions/gatewayapi/v1beta1/interface.go	0.00%	2 Missing ⚠️
... and 1 more

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1742      +/-   ##
==========================================
+ Coverage   39.27%   39.34%   +0.07%     
==========================================
  Files         284      288       +4     
  Lines       22379    22664     +285     
==========================================
+ Hits         8789     8918     +129     
- Misses      12643    12793     +150     
- Partials      947      953       +6     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[kahirokunn]

Dear @stefanprodan

I hope this message finds you well.

I am reaching out to request your review on an enhancement I am working on for the Flagger gateway API. My goal is to support the integration of Envoy Gateway with KEDA HTTPScaledObjects through this enhancement.

I would greatly appreciate your feedback and insights on this matter.

Thank you for your time and consideration.

Best regards,
kahirokunn