Google Cloud Storage (GCS)¶

You can use Google Cloud Storage (GCS) as a remote backup storage for Percona Backup for MongoDB.

Starting from version 2.10.0, PBM uses the Google Cloud SDK instead of AWS SDK. See how to adjust your PBM configuration to use GCS after the upgrade.

PBM supports communication with GCS via the JSON API and XML API. The preferred approach is to use the JSON API with a service account. HMAC keys are mainly useful for compatibility with S3-style APIs.

HMAC keys support deprecation

Starting with version 2.12.0, HMAC keys support is deprecated. We encourage you to use GCS connection type with native JSON keys.

To use GCS, you need the following:

create a service account
add keys for the service account:
- add JSON keys or
- add HMAC keys . This method is deprecated and not recommended for use
create a bucket
add the GCS configuration to PBM

Create a bucket¶

Install and configure the gcloud CLI

Create a bucket

gcloud storage buckets create my-gcs-bucket --location=US

Verify the bucket creation
```
gcloud storage buckets list
```

After the bucket is created, apply the proper permissions for PBM to use the bucket.

Configuration example¶

You can find the configuration file template and uncomment the required fields.

using JSON keysusing HMAC keys (deprecated)

storage:
 type: gcs
 gcs:
     bucket: pbm-testing
     prefix: pbm/test
     credentials:
       clientEmail: <your-service-account-email-here>
       privateKey: <your-private-key-here>

storage:
 type: gcs
 gcs:
     bucket: pbm-testing
     prefix: pbm/test
     credentials:
       hmacAccessKey: <your-access-key-id-here>
       hmacSecret: <your-secret-key-here>

Adjust PBM configuration to use GCS¶

Starting with version 2.10.0, PBM uses the Google Cloud SDK instead of AWS SDK. If you are upgrading from an earlier version, you need to adjust your PBM configuration as follows:

Change the storage.type from s3 to gcs.
Change the storage.s3 section to storage.gcs and adjust the parameters accordingly. See the Configuration example above. Select the option depending on the authentication method you use.

Last update: November 4, 2025
Created: November 4, 2025