feat(provisioner): ContourDeployment loadBalancerSourceRanges and loadBalancerClass

[VedantMadane]

Summary

Adds loadBalancerSourceRanges and loadBalancerClass to ContourDeployment.spec.envoy.networkPublishing so the Gateway provisioner can set the corresponding Envoy Service fields when publishing as a LoadBalancer.

Fixes #7334

Motivation

When using Contour Gateway Provisioner with a custom ContourDeployment, there was no way to configure:

• Service.spec.loadBalancerSourceRanges (restrict source IPs)
• Service.spec.loadBalancerClass (select LB implementation)

Changes

1. API (ContourDeployment / NetworkPublishing): new optional fields
2. Provisioner model + gateway controller: plumb fields from ContourDeployment params
3. Envoy Service: set fields when publishing type is LoadBalancerService
4. Equality: detect changes to reconcile those fields
5. CRDs / examples: regenerated-style updates for the new schema
6. Unit test: TestDesiredEnvoyServiceLoadBalancerFields

Example

apiVersion: projectcontour.io/v1alpha1
kind: ContourDeployment
metadata:
  name: contour
spec:
  envoy:
    networkPublishing:
      type: LoadBalancerService
      loadBalancerSourceRanges:
        - 10.0.0.0/8
      loadBalancerClass: service.k8s.aws/nlb

[codecov]

Codecov Report

❌ Patch coverage is 33.33333% with 10 lines in your changes missing coverage. Please review.
✅ Project coverage is 82.31%. Comparing base (fdb28b9) to head (96edf5e).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
internal/provisioner/equality/equality.go	0.00%	4 Missing and 2 partials ⚠️
internal/provisioner/controller/gateway.go	0.00%	2 Missing and 2 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #7665      +/-   ##
==========================================
- Coverage   82.35%   82.31%   -0.05%     
==========================================
  Files         131      131              
  Lines       15915    15930      +15     
==========================================
+ Hits        13107    13112       +5     
- Misses       2520     2526       +6     
- Partials      288      292       +4     

Files with missing lines	Coverage Δ
internal/provisioner/model/model.go	100.00% <ø> (ø)
internal/provisioner/objects/service/service.go	75.80% <100.00%> (+0.66%)	⬆️
internal/provisioner/controller/gateway.go	58.72% <0.00%> (-1.02%)	⬇️
internal/provisioner/equality/equality.go	53.80% <0.00%> (-1.70%)	⬇️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.