Skip to main content

Create an Infrastructure Profile

Create an infrastructure profile by adding layers composed of an OS, Kubernetes, Network, and Storage packs.

info

You cannot add add-on layers to an infrastructure cluster profile. To include both infrastructure and add-on layers in the same profile, create a full cluster profile instead.

Prerequisites​

  • Your Palette account role must have the clusterProfile.create permission to create a profile. Refer to our Cluster Profile Permissions reference guide for more information about roles and permissions.

Create Infrastructure Profile​

  1. Log in to Palette.

  2. From the left main menu, select Profiles.

  3. In the top-right, select Add Cluster Profile.

  4. Complete the following fields. The Type field defaults to Full, so ensure you set the cluster profile Type to Infrastructure. Select Next to continue.

    FieldDescription
    NameEnter a unique name for the cluster profile.
    VersionAssign a version to the profile using semantic versioning. Version 1.0.0 is assigned automatically when creating a new cluster profile unless otherwise specified. You only need to specify a version if you create multiple versions of a profile using the same profile name. Refer to our Version a Cluster Profile guide for more information.
    Description(Optional) Provide context about the profile.
    TypeChoose the type of cluster profile. Select Infrastructure.
    Tags(Optional) Assign any desired profile tags. Tags propagate to the VMs deployed in the cloud or data center environment when clusters are created from this cluster profile. Example: owner or region.

  1. Choose an option under Infrastructure provider or Managed Kubernetes to deploy your cluster on, then select Next. The available options are:

    • Infrastructure provider: Apache CloudStack, AWS IaaS, Azure IaaS, Edge Native, GCP IaaS, MAAS, VMware vSphere.
    • Managed Kubernetes: AWS EKS, Azure AKS, GCP GKE.

    AWS IaaS is pre-selected by default. Change the selection if you are targeting a different provider.

  1. Configure the four infrastructure layers in order. Each layer step is labeled with a counter such as 1/4 Select your base OS pack. For each layer, select the Registry, Pack Name, and Pack Version. When a pack exposes Presets, choose one; update pack Values and create cluster profile variables as needed. Select Next layer to proceed to the next infrastructure layer. On the final (Storage) layer, the button reads Confirm instead.

    The Registry filter defaults to Public Repo. The set of packs available on each layer depends on the selected registry and on the cloud type chosen in the previous step. Some pack cards display badges: a green checkmark marks a verified pack, TP marks a Tech Preview pack, and dimmed cards mark deprecated packs that you cannot select.

    LayerDescription
    Operating SystemSelect an OS to use with your Kubernetes clusters. Use the Bring Your Own OS (BYOOS) pack to use a different or custom OS. Refer to our Bring Your Own OS (BYOOS) guide to learn more.
    KubernetesSelect the Kubernetes distribution and version to use with the cluster. The available distributions depend on the cloud type; for IaaS clouds these are Palette eXtended Kubernetes (PXK) and RKE2. PXK is Palette's recompiled, CNCF-conformant Kubernetes distribution that also lets you manage an OpenID Connect (OIDC) Identity Provider (IDP), which is useful when your environment does not have an IDP configured.
    NetworkSelect a network pack to use with your cluster.
    StorageSelect a storage pack to use with your cluster.

  1. Upon adding your storage layer, select Confirm. Palette displays the cluster profile stack with your specified pack layers. Use the Variables and Editor actions above the stack to review or refine cluster profile variables and raw pack values before continuing.

  2. If you need to make changes, select the applicable layer, and update your pack's configuration; otherwise, select Next to review your cluster profile. On the review page, the cloud type you chose in step 5 appears under the label Environment.

  3. Select Finish Configuration to create your cluster profile. Palette saves and publishes the profile in a single step; the profile is immediately available for use.

Validate​

  1. Log in to Palette.

  2. From the left main menu, select Profiles.

  3. Select your cluster profile to review its layers or make changes.

Next Steps​

You can now deploy a cluster using the infrastructure cluster profile you created. While you cannot add add-on layers directly to your infrastructure profile, if you want to deploy additional applications to a cluster and still use your infrastructure profile, consider using add-on profiles.

If you need to make changes to your cluster profile, we recommend creating a new cluster profile version or updating your cluster profile.

For general cluster deployment information, check out our Clusters guide. For an end-to-end walkthrough of deploying a cluster on your desired infrastructure, refer to our Getting Started tutorials.

Resources​