🐛 Fix cert manager repo and add troubleshooting guide

[killianmuldoon]

Signed-off-by: killianmuldoon [email protected]

Update cert manger URL and add a troubleshooting section for older versions of CAPI. This PR fixes an issue where a change in the location of the cert manager repo prevented clusterctl init from working.

Fixes: #6051

[killianmuldoon]

This is a breaking change according to the api diff bot 😵‍💫. I'll deprecate and add a new constant.

[k8s-ci-robot]

@killianmuldoon: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
pull-cluster-api-apidiff-main	98e3f97	link	false	/test pull-cluster-api-apidiff-main

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. I understand the commands that are listed here.

[killianmuldoon]

apidiff is failing due to changing the value of the constant. The book lists a different compatibility guarantee for clusterctl (which this change is entirely inside of).

IMO its better to change this constant, and update anyone who might be consuming it to the correct version, than to keep it to pass the apidiff.

[fabriziopandini]

/lgtm
/approve
/cherry-pick release-1.1

[k8s-infra-cherrypick-robot]

@fabriziopandini: once the present PR merges, I will cherry-pick it on top of release-1.1 in a new PR and assign it to you.

In response to this:

/lgtm
/approve
/cherry-pick release-1.1

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: fabriziopandini

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

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [fabriziopandini]

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

[k8s-infra-cherrypick-robot]

@fabriziopandini: new pull request created: #6052

In response to this:

/lgtm
/approve
/cherry-pick release-1.1

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.