Skip to content

Commit 1d411af

Browse files
Merge pull request #237 from augustmckendrick/issue220
Standalone VS HCP description
2 parents 7472bda + a07fc84 commit 1d411af

File tree

1 file changed

+21
-2
lines changed

1 file changed

+21
-2
lines changed

docs/admin/hosted-control-plane/index.md

+21-2
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,28 @@
11
# Deploying a Hosted Control Plane
22

3+
Under normal circumstances, {{{ docsVersionInfo.k0rdentName }}} deploys a child cluster as a complete, self-contained unit.
4+
That is, the controllers and workers are all part of the `ClusterDeployment`. There are serious advantages to deploying
5+
a cluster this way, not the least of which is the fact that the cluster is essentially independent of the Management cluster,
6+
in that if the Management cluster becomes inaccessible for any reason the child cluster can continue on as though nothing
7+
has happened. This is known as a "standalone" deployment.
8+
9+
On the other hand, for many Kubernetes clusters, the controllers are either too busy -- that is, they are constantly
10+
being scaled up and down -- or they're not busy enough -- that is, they're taking up server resources that aren't being
11+
fully used.
12+
13+
For either of these cases, a better choice may be a "hosted control plane".
14+
315
A hosted control plane is a Kubernetes setup in which the control plane components (such as the API server,
4-
etcd, and controllers) run inside the management cluster instead of separate controller nodes. This
16+
etcd, and controllers) run as pods inside the management cluster instead of separate controller nodes. This
517
architecture centralizes control plane management and improves scalability by sharing resources in the management cluster.
6-
Hosted control planes are managed by [k0smotron](https://k0smotron.io/).
18+
Need more controllers? Spin up another pod. Need fewer controllers? Remove some pods.
19+
20+
It's important to remember that if a child cluster's control plan goes down, workloads will continue on
21+
indefinitely, but you won't be able to manage the cluster. So be sure to [back up your management cluster](../backup/index.md) after
22+
deploying important child clusters!
23+
24+
Hosted control planes are managed by [k0smotron](https://k0smotron.io/), which makes it possible for Kubernetes
25+
controller nodes and worker nodes to reside not only in different clusters, but even in different clouds.
726

827
Instructions for setting up a hosted control plane vary slighting depending on the provider.
928

0 commit comments

Comments
 (0)