Back to Yugabyte Db

Cloud setup for deploying universe nodes on GCP

docs/content/v2.20/yugabyte-platform/prepare/cloud-permissions/cloud-permissions-nodes-gcp.md

2026.1.0.0-b292.7 KB
Original Source
<ul class="nav nav-tabs-alt nav-tabs-yb"> <li> <a href="../cloud-permissions-nodes/" class="nav-link"> <i class="fa-solid fa-building"></i> On-premises </a> </li> <li> <a href="../cloud-permissions-nodes-aws/" class="nav-link"> <i class="fa-brands fa-aws"></i> AWS </a> </li> <li> <a href="../cloud-permissions-nodes-gcp" class="nav-link active"> <i class="fa-brands fa-google"></i> GCP </a> </li> <li> <a href="../cloud-permissions-nodes-azure" class="nav-link"> <i class="fa-brands fa-microsoft"></i> Azure </a> </li> <li> <a href="../cloud-permissions-nodes-k8s" class="nav-link"> <i class="fa-regular fa-dharmachakra"></i> Kubernetes </a> </li> </ul>

For YugabyteDB Anywhere (YBA) to be able to deploy and manage YugabyteDB universes using a GCP cloud provider configuration, you need to provide YBA with privileges on your cloud infrastructure to create, delete, and modify VMs, mount and unmount disk volumes, and so on. The more permissions that you can provide, the more YBA can automate.

GCP

The Compute Admin role permission is required on the GCP service account where you will deploy:

sh
roles/compute.admin

To grant the required access, you must do the following:

Then use one of the following methods:

  • Obtain a file containing a JSON that describes the service account credentials. You will need to provide this file later to YBA.
  • Attach the service account to the GCP VM that will run YBA.
Save for laterTo configure
Service account JSONGCP provider configuration

Managing SSH keys for VMs

When creating VMs on the public cloud using a cloud provider configuration, YugabyteDB requires SSH keys to access the VM. You can manage the SSH keys for VMs in two ways:

  • YBA managed keys. When YBA creates VMs, it will generate and manage the SSH key pair.
  • Provide a custom key pair. Create your own custom SSH keys and upload the SSH keys when you create the provider.

If you will be using your own custom SSH keys, then ensure that you have them when installing YBA and creating your public cloud provider.

Save for laterTo configure
Custom SSH keysGCP provider configuration