Manage buckets

Contributors amgrissino netapp-dbagwell netapp-mwallis

An object store bucket provider is essential if you want to back up your applications and persistent storage or if you want to clone applications across clusters. Using Astra Control Center, add an object store provider as your off-cluster, backup destination for your apps.

You don’t need a bucket if you are cloning your application configuration and persistent storage to the same cluster.

Use one of the following Amazon Simple Storage Service (S3) bucket providers:

  • NetApp ONTAP S3

  • NetApp StorageGRID S3

  • Microsoft Azure

  • Generic S3

    Note Amazon Web Services (AWS) and Google Cloud Platform (GCP) use the Generic S3 bucket type.
    Note Although Astra Control Center supports Amazon S3 as a Generic S3 bucket provider, Astra Control Center might not support all object store vendors that claim Amazon’s S3 support.

A bucket can be in one of these states:

  • pending: The bucket is scheduled for discovery.

  • available: The bucket is available for use.

  • removed: The bucket is not currently accessible.

For instructions on how to manage buckets using the Astra Control API, see the Astra Automation and API information.

You can do these tasks related to managing buckets:

Note S3 buckets in Astra Control Center do not report available capacity. Before backing up or cloning apps managed by Astra Control Center, check bucket information in the ONTAP or StorageGRID management system.

Edit a bucket

You can change the access credential information for a bucket and change whether a selected bucket is the default bucket.

Note When you add a bucket, select the correct bucket provider and provide the right credentials for that provider. For example, the UI accepts NetApp ONTAP S3 as the type and accepts StorageGRID credentials; however, this will cause all future app backups and restores using this bucket to fail. See the Release Notes.
Steps
  1. From the left navigation, select Buckets.

  2. From the menu in the Actions column, select Edit.

  3. Change any information other than the bucket type.

    Tip You can’t modify the bucket type.
  4. Select Update.

Set the default bucket

When you perform a clone across clusters, Astra Control requires a default bucket. Follow these steps to set a default bucket for all clusters.

Steps
  1. Go to Cloud instances.

  2. Select the menu in the Actions column for the cloud instance in the list.

  3. Select Edit.

  4. In the Bucket list, select the bucket you want to be the default.

  5. Select Save.

Rotate or remove bucket credentials

Astra Control uses bucket credentials to gain access and provide secret keys for an S3 bucket so that Astra Control Center can communicate with the bucket.

Rotate bucket credentials

If you rotate credentials, rotate them during a maintenance window when no backups are in progress (scheduled or on-demand).

Steps to edit and rotate credentials
  1. From the left navigation, select Buckets.

  2. From the Options menu in the Actions column, select Edit.

  3. Create the new credential.

  4. Select Update.

Remove bucket credentials

You should remove bucket credentials only if new credentials have been applied to a bucket, or if the bucket is no longer actively used.

Tip The first set of credentials that you add to Astra Control is always in use because Astra Control uses the credentials to authenticate the backup bucket. Do not remove these credentials if the bucket is in active use as this will lead to backup failures and backup unavailability.
Note If you do remove active bucket credentials, see troubleshooting bucket credential removal.

For instructions on how to remove S3 credentials using the Astra Control API, see the Astra Automation and API information.

Remove a bucket

You can remove a bucket that is no longer in use or is not healthy. You might want to do this to keep your object store configuration simple and up-to-date.

Note You cannot remove a default bucket. If you want to remove that bucket, first select another bucket as the default.
What you’ll need
  • You should check to ensure that there are no running or completed backups for this bucket before you begin.

  • You should check to ensure that the bucket is not being used in any active protection policy.

If there are, you will not be able to continue.

Steps
  1. From left navigation, select Buckets.

  2. From the Actions menu, select Remove.

    Note Astra Control ensures first that there are no schedule policies using the bucket for backups and that there are no active backups in the bucket you are about to remove.
  3. Type "remove" to confirm the action.

  4. Select Yes, remove bucket.

Find more information