Connect GCP

Connect your Google Cloud project to a Bluebricks collection using workload identity federation.

Prerequisites

• A valid Google Cloud Project ID

• A collection created in Bluebricks (create one first)

Step 1: Connect in the Bluebricks App

1. Open app.bluebricks.co/collections

2. Click Connect Cloud on the collection you want to link to GCP

3. Select GCP as the cloud provider

4. Choose an existing project or click New Project

5. Enter your Google Cloud Project ID

6. Click Connect & Create

Bluebricks will generate a dedicated service account for your project.

Step 2: Grant the Service Account Permissions in GCP

Bluebricks recommends using a unique service account per project for granular access control. Assign the Editor role to ensure it can manage resources.

1. In the Bluebricks app, open the collection and click Edit — copy the Bluebricks Service Account email

2. Go to console.cloud.google.com

3. Search for IAM and open it

4. Click Grant access

5. Paste the Bluebricks service account email in the New principals field

6. Under Assign roles, select Editor

7. Click Save

Managing Cloud Accounts via CLI

# List all connected cloud accounts
bricks clouds ls

# List including inactive
bricks clouds ls --all

# Remove a cloud account
bricks clouds delete --slug <slug>

See also

• Connect your Cloud — full docs with API connection method

• Collections — how collections use cloud accounts