Strip OpenAPI description fields from vendored ASO CRDs

[mboersma]

What type of PR is this?

/kind bug

What this PR does / why we need it:

The vendored managedclusters.containerservice.azure.com ASO CRD is ~2.35 MB serialized, which exceeds the request-size / streaming-timeout budgets enforced by some Kubernetes API servers — notably EKS. As a result, clusterctl init -i azure against an EKS management cluster times out repeatedly trying to apply that single CRD and ultimately fails after the 10 retry attempts.

This PR adds a yq step to make generate-aso-crds that strips OpenAPI description fields from the schemas before writing config/aso/crds.yaml:

$(YQ) e 'del(.. | select(has("description")).description)' -

Verified impact:

	Before	After
managedclusters CRD	2.35 MB	990 KB
Whole config/aso/crds.yaml	3.9 MB	1.7 MB

description is pure metadata in OpenAPI v3 schemas, so this does not affect validation. The only loss is the inline doc text shown by kubectl explain; ASO publishes the same docs externally.

All 10 served spec.versions of every CRD are preserved, so ASO's conversion webhook compatibility is unaffected.

Which issue(s) this PR fixes:
Fixes #6080

Special notes for your reviewer:

The bulk of the diff is the regenerated config/aso/crds.yaml (-23 850 lines). Only the Makefile change is human-authored.

This is the smallest, lowest-risk fix. Two follow-up tracks worth pursuing separately:

1. Push ASO upstream to publish a slim CRD bundle by default, so all consumers (not just CAPZ) benefit.
2. Push CAPI/clusterctl to chunk huge CRD installs (apply empty CRD shell first, then stream the schema as JSONPatches).

TODOs:

• squashed commits
• includes documentation
• adds unit tests
• cherry-pick candidate

Release note:

Strip OpenAPI description fields from vendored ASO CRDs

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 43.95%. Comparing base (bd0f01b) to head (724ac1b).
⚠️ Report is 8 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #6281   +/-   ##
=======================================
  Coverage   43.95%   43.95%           
=======================================
  Files         289      289           
  Lines       25351    25351           
=======================================
  Hits        11143    11143           
  Misses      13435    13435           
  Partials      773      773           

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[mboersma]

/test pull-cluster-api-provider-azure-aks-mgmt-e2e

[willie-yao]

Thanks for this! I've been running into issues in Tilt because of the files being too large
/lgtm
/approve

[k8s-ci-robot]

LGTM label has been added.

Details

Git tree hash: 5cfcf281542bc16bf2904bdd2cba6fca5c624142

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: willie-yao

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [willie-yao]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment