Document how to use multiple providers in the same management cluster

KlavsKlavsen commented 2 years ago

We would like to be able to manage clusters in both AWS, Hetzner hcloud and Azure AKS - the docs does not seem to show anything about how that can be done.. only how to handle a single provider, which seems to exclude adding multiple provider support - to a single cluster-api instance ?

sbueringer commented 2 years ago

Please note that the second rule allows to execute clusterctl init more times: the first call actually initializes the management cluster, while the subsequent calls can be used to add more providers. https://cluster-api.sigs.k8s.io/clusterctl/commands/init.html

In general it should work, we just don't have CI coverage for it.

fabriziopandini commented 2 years ago

/triage accepted /kind documentation

CAPI supports working with many infrastructure providers/bootstrap providers/control plane providers out of the box, but probably we are not doing a great job in highlighting this in the doc; that's something I agree we should fix (my only recommendation is to suggest users to rely on clusterctl in this case, because it helps in ensuring all the providers are compliant with the same contract supported by CAPI) /help-wanted

Also, as pointed out we also don't have CI coverage, but only unit test coverage as of today; given how our CI works in prow, this is not easy to fix, unless we will manage to use CAPK (kubemark) to do some scale tests or autoscaler test in the main repo, but I will treat this as a separated item.

fabriziopandini commented 2 years ago

/help

k8s-ci-robot commented 2 years ago

@fabriziopandini: This request has been marked as needing help from a contributor.

Guidelines

Please ensure that the issue body includes answers to the following questions:

Why are we solving this issue?
To address this issue, are there any code changes? If there are code changes, what needs to be done in the code and what places can the assignee treat as reference points?
Does this issue have zero to low barrier of entry?
How can the assignee reach out to you for help?

For more details on the requirements of such an issue, please see here and ensure that they are met.

If this request no longer meets these requirements, the label can be removed by commenting with the /remove-help command.

In response to [this](https://github.com/kubernetes-sigs/cluster-api/issues/7234): >/help Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md). If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes/test-infra](https://github.com/kubernetes/test-infra/issues/new?title=Prow%20issue:) repository.

kubernetes-sigs / cluster-api

Document how to use multiple providers in the same management cluster #7234

Guidelines