feat(chart)!: manage CRDs as part of release

[hiddeco]

This introduces a new change to the chart which allows the Custom Resource Definitions to be managed as part of the release, effectively allowing upgrades. Which is not possible with Helm's built-in Custom Resource Definition management.

The behavior can be opted-out of by setting crds.create to false, causing them to be excluded from the Helm release manifests which effectively causes a fallback to Helm's default behavior.

With this change, existing installations will have to adopt the Custom Resource Definitions by configuring the following annotations and label on the resources:

RELEASE=<Helm release name>
NAMESPACE=<Helm release namespace>

for name in $(kubectl get crds -o name | grep kargo.akuity.io); do
   echo "Adopting $name"
   kubectl annotate $name meta.helm.sh/release-name=$RELEASE
   kubectl annotate $name meta.helm.sh/release-namespace=$NAMESPACE
   kubectl label $name app.kubernetes.io/managed-by=Helm
done

[netlify]

✅ Deploy Preview for docs-kargo-akuity-io ready!

Name	Link
🔨 Latest commit	329611d
🔍 Latest deploy log	https://app.netlify.com/sites/docs-kargo-akuity-io/deploys/65fd666f895f7e000800b243
😎 Deploy Preview	https://deploy-preview-1671.kargo.akuity.io
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 43.81%. Comparing base (93cb70a) to head (56e3025).

❗ Current head 56e3025 differs from pull request most recent head 329611d. Consider uploading reports for the commit 329611d to get more accurate results

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1671   +/-   ##
=======================================
  Coverage   43.81%   43.81%           
=======================================
  Files         202      202           
  Lines       12935    12935           
=======================================
  Hits         5667     5667           
  Misses       7026     7026           
  Partials      242      242           

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

[krancour]

This is super slick.

[krancour]

This LGTM and my only thought for a possible improvement is probably better left for a follow-up... we could make your little adoption script available in the project's hack/ dir.