Set up Palette with GCP

In this guide, you will learn how to set up Palette for use with your Google Cloud Platform (GCP) cloud account. These steps are required in order to authenticate Palette and allow it to deploy host clusters.

Prerequisites

• A Palette account with tenant admin access.

• Sign up to a service account from GCP. The GCP account must have the required IAM permissions.

Enablement

Palette needs access to your GCP cloud account in order to create and manage GCP clusters and resources.

Add Cloud Account

1. Log in to Palette as Tenant admin.

2. Navigate to the left Main Menu and select Tenant Settings.

3. Select Cloud Accounts and click on Add GCP Account.

4. In the cloud account creation wizard, provide the following information:

   • Account Name: Custom name for the cloud account.

   • JSON Credentials: The JSON credentials object.

   
   
   info

   You can use the Upload button to upload the JSON file you downloaded from the GCP console.

5. Click the Validate button to validate the credentials.

6. When the credentials are validated, click on Confirm to save your changes.

Create a Palette API Key

Follow the steps below to create a Palette API key. This is required for the Cluster Management with Terraform tutorial.

1. Log in to Palette as a tenant admin.

2. Switch to the Tenant Admin scope

3. Navigate to the left Main Menu and select Tenant Settings.

4. From the Tenant Settings Menu, select API Keys.

5. Click on Add New API key.

6. Fill out the following input fields:

Input Field	Description
API Key Name	Assign a name to the API key.
Description	Provide a description for the API key.
User Name	Select the user to assign the API key.
Expiration Date	Select an expiration date from the available options. You can also specify a custom date by selecting Custom.

5. Click the Generate button.

6. Copy the API key and save it in a secure location, such as a password manager. Share the API key with the user you created the API key for.

warning

Ensure you save the API key in a secure location. You will not be able to view the API key again.

Validate

You can verify your account is added.

1. Log in to Palette.

2. From the left Main Menu, select Tenant Settings.

3. Next, on the Tenant Settings Menu, select Cloud Accounts.

4. The added cloud account is listed under GCP with all other available GCP cloud accounts.

Next Steps

Now that you set up Palette for use with Google Cloud, you can start deploying Kubernetes clusters to your GCP account. To learn how to get started with deploying Kubernetes clusters to GCP, we recommend that you continue to the Create a Cluster Profile tutorial to create a full cluster profile for your host cluster.