Skip to main content
Version: latest

Register and Manage MAAS Cloud Accounts

When you install the Private Cloud Gateway (PCG), a cloud account is auto-created in every project in Palette. You can use this cloud account to create clusters at either the tenant or the project level. If desired, you can create additional cloud accounts that reference specific PCGs.

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 PCG Architecture page.

  • An active MAAS API key which can be generated in the MAAS web console under My Preferences, and selecting API keys.

For details, refer to the MAAS document on how to add an API key.

Register a MAAS Cloud Account​

Follow these steps to create additional MAAS cloud accounts.


  1. Log in to Palette as a tenant admin.

  2. Navigate to the Main Menu and select Tenant Settings > Cloud Accounts.

  3. Locate MAAS on the Cloud Accounts page and click Add MAAS Account.

  4. In the next window that displays, enter values for properties listed in the following table.

    In a self-hosted environment where Palette has direct network access to MAAS, you can register a MAAS cloud account without installing the PCG. Note the Use System Private Gateway setting listed in the table. refer to the System Private Gateway section in the Architecture page to learn more about System Private Gateway.

Refer to the Deploy with PCG and system PCG in the Architecture page to learn more about system PCG.


info

For the self-hosted Palette instance, MAAS is reachable on port 5240.


PropertyDescription
Account NameCustom name for the cloud name.
Use System Private GatewayThis setting is for self-hosted environments that do not require a PCG. Toggle this option to bypass installing the PCG.
Select Private Cloud GatewaySelect your MAAS cloud gateway from the drop-down Menu.
API EndpointAPI endpoint of the gateway.
API KeyThe MAAS API key.
  1. Click Confirm to register your MAAS cloud account.

Validate​

You can validate your MAAS cloud account is registered by reviewing the Cloud Accounts page. Ensure your account is listed under MAAS.

Next Steps​

Deploy a Kubernetes cluster to one of your MAAS accounts. Check out Create and Manage MAAS Cluster for guidance.