ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs Scylla Manager Backup Setup Google Cloud Storage

Caution

You're viewing documentation for a previous version of Scylla Manager. Switch to the latest stable version.

Setup Google Cloud Storage¶

  • Create a bucket

  • Grant access

    • Automatic service account authorization

    • Service account file

  • Troubleshoot connectivity

Create a bucket¶

Go to Google Cloud Storage and create a new bucket in a region where Scylla nodes are. If your cluster is deployed in multiple regions create a bucket per region. You may decide to backup only a single datacenter to save on costs, in that case create only one bucket in a region you want to backup.

Grant access¶

This procedure is required so that Scylla Manager can access your bucket.

Choose how you want to configure access to the bucket. If your application runs inside a Google Cloud environment we recommend using automatic Service account authentication. Otherwise you can add your credentials to the agent configuration file. The later method is less secure as you will be propagating each node with this security information and in cases where you need to change the key, you will have to replace it on each node.

Automatic service account authorization¶

Procedure

  1. Collect list of service accounts used by each of the Scylla nodes.

  2. Make sure that each of service account has read/write access scope to Cloud Storage.

  3. For each service account from the list, add Storage Object Admin role in bucket permissions settings.

Service account file¶

Note that this procedure needs to be repeated for each Scylla node.

Prerequisites

Use this instruction to get the service account file.

Procedure

  1. Upload service account file to /etc/scylla-manager-agent/gcs-service-account.json. If you want to use different path change service_account_file parameter in gcs section in Scylla Manager Agent Config file.

  2. Validate that the manager has access to the backup location. If there is no response, the bucket is accessible. If not, you will see an error.

    scylla-manager-agent check-location --location gcs:<your GCS bucket name>
    

Troubleshoot connectivity¶

To troubleshoot Node to bucket connectivity issues you can run:

scylla-manager-agent check-location --debug --location gcs:<your GCS bucket name>

Was this page helpful?

PREVIOUS
Setup S3 compatible storage
NEXT
Setup Azure Blob Storage
  • Create an issue
  • Edit this page

On this page

  • Setup Google Cloud Storage
    • Create a bucket
    • Grant access
      • Automatic service account authorization
      • Service account file
    • Troubleshoot connectivity
Scylla Manager
  • 3.3
    • master
    • 3.5
    • 3.4
    • 3.3
  • Docker
  • Install ScyllaDB Manager
  • Install ScyllaDB Manager Agent
  • ScyllaDB Manager Upgrade
  • Add a Cluster
  • Backup
    • Setup Amazon S3
    • Setup S3 compatible storage
    • Setup Google Cloud Storage
    • Setup Azure Blob Storage
    • Examples
    • Specification
  • Restore
    • Restore tables
    • Restore schema for ScyllaDB 6.0/2024.2 or newer
    • Restore schema for ScyllaDB 5.4/2024.1 or older
    • Examples
    • Compatibility Matrix
  • Repair
    • Repair faster
    • Repair slower
    • Examples
  • Health Check
  • CLI sctool
    • Environment variables
    • Completion
    • Download files
    • Backup
    • Restore
    • Cluster
    • Info
    • Progress
    • Repair
    • Start
    • Status
    • Stop
    • Suspend & Resume
    • Tasks
    • Version
  • Configuration Files
    • Scylla Manager Config
    • Scylla Manager Agent Config
  • Swagger File
  • ScyllaDB Monitoring
  • Troubleshooting
  • Slack
Docs Tutorials University Contact Us About Us
© 2025, ScyllaDB. All rights reserved. | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 07 May 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6