Skip to content
Open
Show file tree
Hide file tree
Changes from all 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
Original file line number Diff line number Diff line change
Expand Up @@ -14,20 +14,33 @@ apply the same configuration and upgrade rules across multiple clusters.
Palette supports this workflow with cluster templates. Cluster templates let you reuse a cluster configuration, control
when upgrades happen, and apply changes to multiple clusters at once.

Cluster templates are built from two related concepts:
Cluster templates combine three related components:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] reported by reviewdog 🐢
[spectrocloud-docs-internal.colon] Use colons only to introduce lists, unless in code blocks or inline code.


- [Cluster profiles](../../../../../profiles/cluster-profiles/create-cluster-profiles/), which define the software stack
and infrastructure configuration of a cluster.
- [Cluster template policies](../../../cluster-templates/create-cluster-template-policies/create-cluster-template-policies.md),
which define how clusters created from a template are managed and maintained throughout their lifecycle, such as when
upgrades are allowed to run.
1. A [cluster profile](../../../../../profiles/cluster-profiles/create-cluster-profiles/) defines what a cluster runs.
It contains the software stack and infrastructure configuration.
2. A
[cluster template policy](../../../cluster-templates/create-cluster-template-policies/create-cluster-template-policies.md)
defines how clusters created from a template are managed throughout their lifecycle, including when upgrades are
allowed to run.
3. A [cluster template](../../../cluster-templates/cluster-templates.md) links a cluster profile and one or more cluster
template policies.

A [maintenance policy](../../../cluster-templates/create-cluster-template-policies/maintenance-policy.md) is one type of
cluster template policy. Maintenance policies define a maintenance window that controls when upgrades can run.
Currently, maintenance policies are the only cluster template policy type available in Palette.
Cluster profiles can include
[cluster profile variables](../../../../../profiles/cluster-profiles/create-cluster-profiles/define-profile-variables/),
which let you reuse the same profile while changing specific values per cluster.

Cluster templates link cluster profiles and policies. When you create clusters from the same template, those clusters
share the same base configuration and follow the same operational rules.
A [maintenance policy](../../../cluster-templates/create-cluster-template-policies/maintenance-policy.md) is one example
of a cluster template policy. Maintenance policies define a maintenance window that controls when upgrades can run.
Currently, maintenance policies are the only supported cluster template policy type in Palette.

When you create clusters from the same template, they inherit the same base configuration and the same governance rules.
For example, you can create **dev** and **prod** clusters from a single template. Both clusters run the same software
stack and follow the same upgrade policy. You can assign different profile variable values to handle
environment-specific requirements.

The following diagram shows how these components fit together.

![Diagram of cluster template architecture](/profiles-policies-templates.webp)

In this tutorial, you will:

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.