Skip to main content
Version: latest

Create and Manage MAAS Clusters

Palette supports creating and managing Kubernetes clusters deployed to a MAAS account. This section guides you on how to create a Kubernetes cluster in MAAS that is managed by Palette.

Prerequisites​

  • An installed PCG if you do not have a direct connection to the MAAS environment. Review Deploy to MAAS for guidance.

    If are self-hosting Palette and have a direct connection to the MAAS environment, you can select Use System Private Gateway. To learn more about when you would use Palette's PCG or the System Private Gateway, refer to the Architecture page to learn more.

  • A MAAS account registered in Palette. Refer to the Register and Manage MAAS Cloud Accounts if you need to register a MAAS account in Palette.

  • A cluster profile for the MAAS environment. Review Cluster Profiles for more information.

  • Verify that the required Operating System (OS) images you use in your cluster profiles are downloaded and available in your MAAS environment. Review the How to use standard images for guidance on downloading OS images for MAAS.

info

By default, Palette registers a DNS record in MAAS for the deployed cluster and links it to the IP addresses of the control plane nodes of the cluster. However, you may choose not to depend on MAAS for your cluster DNS record. The Kubernetes pack allows you to configure a custom API server endpoint for your cluster instead.

This feature is only supported in Palette eXtended Kubernetes (PXK). Refer to the Custom API Server Endpoint for MAAS Clusters section of the pack Additional Guidance for further information.

Deploy a MAAS Cluster​

  1. Log in to Palette.

  2. Ensure you are in the correct project scope.

  3. From the left Main Menu, select Clusters and click Add New Cluster.

  4. In Data Center, select MAAS.

  5. In the bottom-right corner, click Start MAAS Configuration.

  6. Provide basic cluster information: Cluster name, Description, and Tags.

  7. Select your MAAS cloud account from the drop-down Menu and click Next.

  8. Select the cluster profile for your MAAS cluster.

  9. Review and override pack parameters as desired and click Next. By default, parameters for all packs are set with values defined in the cluster profile.

  10. Select a domain from the Domain drop-down Menu and click Next.

  11. Configure the control plane and worker node pools. The following input fields apply to MAAS control plane and worker node pools. For a description of input fields that are common across target platforms refer to the Node Pools management page. Click Next when you are done.

    Control Plane Pool configuration​

    • Cloud configuration:

      • Resource Pool: The MAAS resource pool from which to select available servers for deployment. Filter available servers to only those that have at least the amount of CPU and Memory selected.

    • Tags - You can specify tags to dynamically place nodes in a pool by using MAAS automatic tags. Specify the tag values that you want to apply to all nodes in the node pool. To learn more about MAAS automatic tags, refer to the MAAS Tags documentation.

    Worker Pool configuration​

    • Cloud configuration:

      • Resource Pool: The MAAS resource pool from which to select available servers for deployment. Filter available servers to only those that have at least the amount of CPU and Memory selected.

      • Tags: Specify the MAAS machine tags so that Palette can deploy nodes onto the MAAS machines that match the provided tags. To learn more about MAAS tags, refer to the MAAS Tags documentation.

  12. You can configure the following cluster management features now if needed, or you can do it later:

    • Manage machines
    • Schedule scans
    • Schedule backups
    • Role-based access control (RBAC)
    • Location

  13. Review settings and deploy the cluster.

Validate​

You can validate your cluster is available by reviewing the cluster details page. Navigate to the left Main Menu and click Clusters. The Clusters page lists all available clusters that Palette manages. Select the cluster to review its details page. Ensure the Cluster Status field contains the value Running.

Delete a MAAS Cluster​

When you delete a MAAS cluster, all machines and associated storage disks that were created for the cluster are removed.

Follow these steps to delete a MAAS cluster.

  1. Log in to Palette as a tenant admin.

  2. Navigate to the Main Menu and click Clusters.

  3. Select the cluster you want to delete.

  4. Click the Settings drop-down Menu, and choose Delete.

The cluster status is updated to Deleting while cluster resources are being deleted. When all resources are successfully deleted, the cluster status is updated to Deleted and the cluster is removed from the list. The delete operation returns the edge hosts to the Ready state. All the artifacts related to the Kubernetes distribution are removed.

Upgrade a MAAS Cluster​

Upgrade a MAAS cluster to enhance the performance and functionality of the cluster. To learn more about managing a MAAS cluster, refer to Manage Clusters.

To protect your data, we recommend you create a backup of your MAAS cluster before proceeding with any upgrades or infrastructure changes. Review instructions provided in the Backup and Restore.

warning

Ensure that the Operating System (OS) image selected for your cluster are downloaded and available for your MAAS configuration to eliminate errors in Palette. You can refer to the How to use standard images guide for instructions on downloading OS images compatible with their respective MAAS environment.

Next Steps​

Now that you’ve deployed a MAAS cluster, you can start developing and deploying applications to your cluster. We recommend you review the Day-2 operations and become familiar with the cluster management tasks. Check out the Manage Clusters documentation to learn more about Day-2 responsibilities.