Skip to main content
Version: latest

Create a Full Profile

Create a full profile by first adding infrastructure layers composed of an Operating System (OS), Kubernetes, Network, and Storage. Next, add layers using add-on profiles to expand the functionality of your clusters.


  • Your Palette account role must have the clusterProfile.create permission to create a cluster profile. Refer to the Roles and Permissions documentation for more information.

Create Full Profile

  1. Log in to Palette.

  2. From the left Main Menu click Profiles.

  3. Click on the Add Cluster Profile button. If you have an existing infrastructure profile, you can select it from the profiles list and add layers to it from the profiles details page to create a full profile.

  4. Fill out the following input values and ensure you select Full for the type. Click on Next to continue.

    NameThe name of the profile.
    VersionAssign a version to the profile. You only need to specify a version if you create multiple versions of a profile using the same profile name. Default: 1.0.0.
    DescriptionUse the description to provide context about the profile.
    TagsAssign any desired profile tags. Tags propagate to the Virtual Machines (VMs) deployed in the cloud or data center environment when clusters are created from this cluster profile. Example: owner or region.

    To learn how to create multiple profile versions that use the same name, check out Version a Cluster Profile.

  5. Select the Infrastructure Provider, Managed Kubernetes, or Tech Preview cloud type for your environment and click Next.


    Cluster profiles created from a Tech Preview cloud type are intended for clusters that a cloud provider deploys using Palette's generic framework built upon the open-source Cluster API (CAPI) initiative.

    When creating a profile using a Tech Preview cloud type, you do not have to specify anything for the OS or Kubernetes layers. Out-of-the-box packs are provided for the network and storage profile layers.

  6. Configure the infrastructure layers by selecting the registry, pack name, and pack version for each layer. Click Next Layer to configure each infrastructure layer.

    Operating SystemSelect an OS to use with your Kubernetes clusters. Use the Bring Your Own OS (BYOOS) to use a different or custom OS. Refer to the Bring Your Own OS (BYOOS) section to learn more.
    KubernetesThe Kubernetes pack to use with the cluster. Palette eXtended Kubernetes (PXK) allows you to manage OpenID Connect (OIDC) Identity Provider (IDP). This is particularly useful if your environment does not have an IDP configured - you can use Palette as an IDP without having to configure a third-party IDP. Refer to Configure OIDC Identity Provider for more information.
    NetworkSelect a network pack to use with your clusters.
    StorageSelect a storage pack to use with your clusters.
  7. Select the type of layer to add to the cluster profile: pack, manifest, or Helm chart. For guidance, refer to Add a Pack, Add a Manifest, or Add a Helm Chart.

    For more information about the layers, applying pack versions, configuration parameters, and presets, review Profile Layers.

  8. Fill out the required input fields for each layer and click on Confirm & Create.

  1. If you want to add additional layers, repeat steps 7 and 8. Otherwise, click on Next to review the profile.

  2. Click on Finish Configuration to create the cluster profile.

You now have a full cluster profile. You can reuse the profile and apply it to several clusters. Refer to the Update Cluster Profile guide for more information about update operations.


  1. Log in to Palette.

  2. Navigate to left Main Menu and select Profiles.

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

Next Steps

Now you are ready to deploy a cluster using the full cluster profile you created.