Skip to main content
Version: latest

Add Backup Location using Static Credentials

This guide provides instructions to add a backup location in Palette using static credentials. Below is an overview of the steps involved:

  1. Create a storage bucket to store the backup files. For example, if you configure the backup location in AWS, you will need an S3 bucket.

  2. Define the access permissions for the storage bucket and associate the permissions with an IAM entity. The IAM entity may be a user, service principal, or role depending on your infrastructure provider.

  3. Generate the static credentials for the IAM entity with sufficient permissions to perform bucket-related operations.

  4. Share the static credentials with Palette so that it can assume the IAM entity's role to perform bucket-related operations.

The following sections provide detailed instructions. Select the environment where you want to create a backup.

AWS​

Prerequisites​

  • An AWS account.

  • An S3 bucket in the AWS account. The bucket will store the backup of your clusters or workspaces.

  • Add the following IAM policy to your AWS account. Replace the BUCKET-NAME placeholder in the policy below with your bucket name. Refer to the Creating IAM policies for additional guidance. 

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "ec2:DescribeVolumes",
            "ec2:DescribeSnapshots",
            "ec2:CreateTags",
            "ec2:CreateVolume",
            "ec2:CreateSnapshot",
            "ec2:DeleteSnapshot"
          ],
          "Resource": "*"
        },
        {
          "Effect": "Allow",
          "Action": [
            "s3:GetObject",
            "s3:DeleteObject",
            "s3:PutObject",
            "s3:AbortMultipartUpload",
            "s3:ListMultipartUploadParts"
          ],
          "Resource": ["arn:aws:s3:::BUCKET-NAME/*"]
        },
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": ["arn:aws:s3:::BUCKET-NAME"]
        }
      ]
    }

  • Create an IAM user in your AWS account. While creating the IAM user, attach the IAM policy you defined in the previous prerequisite item. Refer to the Creating an IAM user in your AWS account guide to learn how to create an IAM user.

  • AWS will generate and display an access key for the newly created IAM user. An access key is made of up two parts - an access key ID and a secret access key. Copy both parts of the access key to a clipboard to use later in this guide. AWS will not display the secret access key again.

    If you skip copying the secret access key, refer to the Managing access keys for IAM users guide to learn how to create a new access key.

  • If the S3 bucket is using a customer managed AWS Key Management Service (KMS) key for server-side encryption, ensure the Palette IAM user has the necessary permissions to access the KMS key. Otherwise, Palette will be unable to put objects in the S3 bucket and result in backup or restore failure. Check out the Troubleshooting key access guide to learn more about common KMS issues.

  • If you are using a custom Certificate Authority (CA) for SSL/TLS connections, provide the x509 certificate in Privacy-Enhanced Mail (PEM) format to Palette.

    tip

    Use the IAM Policy Simulator to verify the IAM role has the necessary permissions to access a customer managed KMS key. Refer to the Testing IAM policies with the IAM policy simulator guide to learn more.

Add an AWS S3 Bucket​

  1. Log in to Palette.

  2. Navigate to Project Settings and click on Backup Locations.

  3. Click on the Add New Backup Location button.

  4. Fill out the input fields listed in the table below.

    Configuration FieldValue
    Location NameProvide a name of your choice.
    Location ProviderSelect AWS from the drop-down Menu.
    CertificateProvide the CA bundle in PEM format if you are using a custom certificate bundle to establish SSL/TLS sessions.
    S3 BucketName of the S3 bucket you created in the object store. The bucket name must be DNS-compliant. For more information, refer to the Bucket naming rules defined by AWS.
    RegionRegion where the S3 bucket is hosted. You can check the region code from the Service endpoints section in the AWS documentation.
    S3 URLOptional bucket URL. If you choose to provide a value, refer to the Methods for accessing a bucket guide to determine the bucket URL. If you provided an S3 URL, enable the Force S3 path style checkbox.

  5. Next, choose the Credentials validation method. If you want to use dynamic credentials through the AWS STS service, refer to the Add a Backup Location using Dynamic Credentials for guided instructions.

  6. Provide the IAM user's access key if you chose the Credentials method. The IAM user must have the necessary IAM policy attached, which you defined in the prerequisites section above. The specified policy allows Palette to create a backup in the S3 bucket.

  7. Click on the Validate button. Palette will display a validation status message. If the validation status message indicates a success, proceed to the next step. If the validation status message indicates an error, review the error message and verify the configurations you provided.

  8. Click on the Create button.

You have completed configuring and adding a backup location to Palette with static credentials.

Validate​

Use the following steps to validate adding the new backup location.

  1. Log in to Palette.

  2. Navigate to Project Settings and click on Backup Locations.

  3. The Backup Locations page will display a list of all backup locations configured for the current project.

  4. Search for the newly added backup location in the list. The presence of the backup location validates that you successfully added a new backup location.

GCP​

Prerequisites​

  • A GCP account.

  • A storage bucket in the GCP account.

  • A service account with sufficient permissions to perform the required read and write operations on the bucket. For simplicity, you can assign the storage administrator role to the service account to grant complete control of the storage bucket. Refer to the IAM roles for Cloud Storage document to learn about the available roles.

  • JSON credentials for the service account. Refer to the Create access credentials to learn how to create the credentials for the service account.

Add a GCP Bucket​

  1. Log in to Palette.

  2. Navigate to Project Settings and click on Backup Locations.

  3. Click on the Add New Backup Location button.

  4. Fill out the input fields listed in the table below.

    FieldValue
    Location NameProvide a name of your choice.
    Location ProviderSelect GCP from the drop-down Menu.
    BucketThe name of the bucket you created in the GCP object store.
    JSON CredentialsProvide the JSON credentials for the external authentication of the GCP storage. Ensure the associated service account has sufficient permissions to perform the required bucket operations.

  5. Click on the Validate button. Palette will display a validation status message. If the validation status message indicates a success, proceed to the next step. If the validation status message indicates an error, review the error message and verify the configurations you provided.

  6. Click on the Create button.

You have completed configuring and adding a backup location to Palette with static credentials.

Validate​

Use the following steps to validate adding the new backup location.

  1. Log in to Palette.

  2. Navigate to Project Settings and click on Backup Locations.

  3. The Backup Locations page will display a list of all backup locations configured for the current project.

  4. Search for the newly added backup location in the list. The presence of the backup location validates that you successfully added a new backup location.

MinIO​

Prerequisites​

  • A MinIO account.

  • An S3-compliant bucket in the MinIO account.

  • IAM policy in your MinIO account to authorize a MinIO user to perform the required read and write operations on the MinIO bucket. MinIO uses Policy-Based Access Control (PBAC) to control which IAM identities can access the resources and what actions the IAM identities are authorized to perform on the specific resources. Refer to the MinIO Access Management guide to learn more about the IAM policy requirements.

  • A MinIO user assigned to the IAM policy defined above. You can learn more about MinIO access management in the MinIO object storage for Kubernetes documentation.

  • An access key for the MinIO user. You can create an access key from the MinIO console. Refer to the MinIO official documentation to learn about creating access keys.

  • If you are using a custom Certificate Authority (CA) for SSL/TLS connections, provide the x509 certificate in Privacy-Enhanced Mail (PEM) format to Palette. This is required if the MinIO endpoint is using a self-signed certificate.

Add a MinIO Bucket​

  1. Log in to Palette.

  2. Navigate to the Project Settings and click on Backup Locations.

  3. Click on the Add New Backup Location button.

  4. Fill out the following input fields. Refer to the table below to learn more.

    FieldValue
    Location NameProvide a name of your choice.
    Location ProviderSelect MinIO from the drop-down field.
    CertificateProvide the CA bundle in PEM format if you are using a custom certificate bundle to establish SSL/TLS sessions. This is required for endpoints using a self-signed certificate.
    S3 BucketThe name of the S3 bucket you created in the MinIO object store.
    RegionThe region where the MinIO server is configured. Example: us-east-1
    S3 URLThe MinIO object storage console URL. Example: http://12.123.234.567:0000
    Force S3 path styleThis value is required for MinIO.

    warning

    Ensure you check the Force S3 path style checkbox. S3 path style is required by Velero to access the MinIO object storage. Palette uses Velero to create backups.

  5. Next, provide the access key for the MiniIO user. The access key has two parts - the access key ID and the secret key.

  6. Click on the Create button.

You have completed configuring and adding a backup location to Palette with static credentials.

Validate​

Use the following steps to validate adding the new backup location.

  1. Log in to Palette.

  2. Navigate to Project Settings and click on Backup Locations.

  3. The Backup Locations page will display a list of all backup locations configured for the current project.

  4. Search for the newly added backup location in the list. The presence of the backup location validates that you successfully added a new backup location.

Azure​

Prerequisites​

  • An active Azure cloud account. You will need the following Azure items to complete the backup setup:

    • Tenant ID
    • Subscription ID

  • An Azure storage account in the Azure account. You will need to be aware of the values for the following Azure storage items:

    • Resource group name
    • Storage account name
    • Stock-Keeping Unit (SKU)

Refer to the Create a storage account guide to learn how to create an Azure storage account

  • A container in the Azure Storage account. Refer to the Manage blob containers using the Azure portal guide to learn how to create an Azure storage container.

  • An Azure service principal with sufficient permissions to perform the required read and write operations on the container. You will need the values of the following items:

    • Client ID
    • Client Secret

Check out the Work with Azure service principal using the Azure CLI guide to learn more about Azure service principals.

Add an Azure Blob Container​

  1. Log in to Palette.

  2. Navigate to Project Settings and click on Backup Locations.

  3. Click on the Add New Backup Location button.

  4. Fill out the input fields listed in the table below.

    FieldValue
    Location NameProvide a name of your choice.
    Location ProviderSelect Azure from the drop-down Menu.
    Container NameName of the container created in the Azure storage.
    Storage NameName of the Azure storage resource.
    Stock-Keeping UnitAzure storage resource SKU.
    Tenant IDAzure tenant ID.
    Subscription IDAzure subscription ID where you created the Azure storage resource.
    Resource Group:Azure resource group name.
    Client IDAzure client ID of the service principal.
    Client SecretAzure client secret for the service principal you created for Palette to assume.

  5. Click on the Validate button. Palette will display a validation status message. If the validation status message indicates a success, proceed to the next step. If the validation status message indicates an error, review the error message and verify the configurations you provided.

  6. Click on the Create button.

You have completed configuring and adding a backup location to Palette with static credentials.

Validate​

Use the following steps to validate adding the new backup location.

  1. Log in to Palette.

  2. Navigate to Project Settings and click on Backup Locations.

  3. The Backup Locations page will display a list of all backup locations configured for the current project.

  4. Search for the newly added backup location in the list. The presence of the backup location validates that you successfully added a new backup location.

Next Steps​

You can now use the newly added backup location to create a backup of your clusters or workspaces. Refer to the Create a Backup guide to learn how to create a backup of your clusters or workspaces.