diff --git a/docs/enterprise/embedded-manage-nodes.mdx b/docs/enterprise/embedded-manage-nodes.mdx index fe83c7bad3..c13e212d4a 100644 --- a/docs/enterprise/embedded-manage-nodes.mdx +++ b/docs/enterprise/embedded-manage-nodes.mdx @@ -10,6 +10,8 @@ Multi-node clusters with Embedded Cluster have the following limitations: * Setting node roles with the Embedded Cluster Config [roles](/reference/embedded-config#roles-beta) key is Beta. +* The first node added to the cluster is always a controller and cannot be assigned any custom roles. For more information about configuring node roles, see [roles](/reference/embedded-config#roles-beta) in _Embedded Cluster Config_. + * The same Embedded Cluster data directory used at installation is used for all nodes joined to the cluster. This is either the default `/var/lib/embedded-cluster` directory or the directory set with the [`--data-dir`](/reference/embedded-cluster-install#flags) flag. You cannot choose a different data directory for Embedded Cluster when joining nodes. * More than one controller node should not be joined at the same time. When joining a controller node, a warning is printed that explains that the user should not attempt to join another node until the controller node joins successfully. diff --git a/docs/reference/embedded-config.mdx b/docs/reference/embedded-config.mdx index 2f4b7d7a83..bda25796fe 100644 --- a/docs/reference/embedded-config.mdx +++ b/docs/reference/embedded-config.mdx @@ -10,11 +10,11 @@ To install your application with Embedded Cluster, an Embedded Cluster Config mu The Embedded Cluster Config lets you define several aspects of the Kubernetes cluster that will be created. -### Limitation +### Limitations * The Embedded Cluster Config does not support the use of Go template functions, including [KOTS template functions](/reference/template-functions-about). -For additional property-specific limitations, see the sections below. +* There are additional, property-specific limitations. For more information, see the sections below. ### Example @@ -79,10 +79,6 @@ For a full list of versions, see the [Embedded Cluster Release Notes](/release-n ## roles (Beta) -:::note -Support for setting node roles is Beta. -::: - You can optionally customize node roles in the Embedded Cluster Config using the `roles` key. A common use case for customizing node roles is to assign workloads to specific nodes. For example, if your application has graphics processing unit (GPU) workloads, you could create a `custom` role that will add a `gpu=true` label to any node that is assigned the role. This allows you to then schedule GPU workloads on nodes labled `gpu=true`. @@ -113,6 +109,12 @@ spec: gpu: "true" # Label applied to "gpu" nodes ``` +### Limitations + +* Defining node roles with the `roles` key is Beta. + +* The first node added to the cluster is always a controller and cannot be assigned any custom roles. You can add custom labels to the first node by setting the `labels` field in the `roles.controller` key. + ### roles.controller In the `roles.controller` key, you can set the following fields to customize the default controller role: