Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cloud hosted mgmt cluster #496

Open
wants to merge 10 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions asciidoc/edge-book/edge.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,8 @@ include::../components/upgrade-controller.adoc[leveloffset=+1]
[partintro]
How-to guides and best practices

include::../guides/public-cloud.adoc[leveloffset=+1]

include::../guides/metallb-k3s.adoc[leveloffset=+1]

include::../guides/metallb-kube-api.adoc[leveloffset=+1]
Expand Down
69 changes: 69 additions & 0 deletions asciidoc/guides/public-cloud.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
[#guides-public-cloud]
= Running the Management Cluster in the Public Cloud
:experimental:

ifdef::env-github[]
:imagesdir: ../images/
:tip-caption: :bulb:
:note-caption: :information_source:
:important-caption: :heavy_exclamation_mark:
:caution-caption: :fire:
:warning-caption: :warning:
endif::[]



TODO: Write intro section


== Networking and Topology

TODO: Add diagram here

Downstream clusters need to have access to the Rancher server that's managing it. This means that we need to provide a FQDN that's resolves to a LoadBalancer that routes the traffic to Rancher.

In the public cloud, this typically is done through the tools provided by your cloud provider.

[NOTE]
====
For example, in Amazon AWS you could set up an EKS cluster then use an Application Load Balancer (ALB) to both terminate TLS and route traffic to the cluster's ingress controller. If AWS is also your DNS registrar, it can also create a CNAME entry to point at the ALB being created.
agracey marked this conversation as resolved.
Show resolved Hide resolved
====

=== SUSE Manager

It can also be advantageous to use <<component-suse-manager,SUSE Manager>> to reduce network traffic for updates along with reducing risk of losing access to individual nodes with a "belt and suspenders" approach.

TODO: some basics about SUMA

=== Cloud Marketplace

SUSE also maintains offerings in the marketplace of the most commonly used cloud providers. For more information here

TODO: find link for above

== Sizing Considerations

The number of downstream clusters a single Rancher server is able to manage is influenced by both the number of objects being created for each cluster as well as the size of the VMs hosting the management cluster's workers.

=== Object Count

Rancher creates several Kubernetes objects for each cluster which affects it's performance. The amount of objects that are created depends on factors such as:

- # of Roles/RoleBindings
- # of Users
- # of workloads
- # of extensions being used

More information can be found at https://ranchermanager.docs.rancher.com/v2.10/reference-guides/best-practices/rancher-server/tuning-and-best-practices-for-rancher-at-scale#managing-your-object-counts

=== Instance Size:

Some basic sizing considerations can be found at https://ranchermanager.docs.rancher.com/v2.10/getting-started/installation-and-upgrade/installation-requirements#rke2-kubernetes

== Federation
agracey marked this conversation as resolved.
Show resolved Hide resolved

If you need to scale further (or limit impact of outages) it make be advantageous to split your clusters across several Rancher server instances.

To make this configuration easier to manage, you can use Fleet to configure the Rancher instances themselves.

TODO: fill out with mention of tech preview rancher exporter