Learn how to connect your Google Cloud Platform project to CloudK for cost monitoring and optimization.
What you'll need:
Go to Google Cloud Console
Navigate to console.cloud.google.com
Open IAM & Admin
From the navigation menu, go to IAM & Admin → Service Accounts.
Create service account
Click "+ CREATE SERVICE ACCOUNT"
Name: cloudk-reader
Description: CloudK cost monitoring service
Assign roles
In the "Grant this service account access to project" step, add these roles:
roles/billing.viewer
roles/compute.viewer
roles/monitoring.viewerSkip user access
You can skip the "Grant users access" step. Click "Done".
Open service account details
Click on the service account you just created (cloudk-reader).
Go to Keys tab
Click the "KEYS" tab at the top.
Create new key
Click "ADD KEY" → "Create new key"
Select JSON format and click "Create".
Save the JSON file securely!
A JSON key file will be downloaded. Keep this file secure - it provides access to your GCP project.
If you prefer using the command line, run these commands:
# Create service account
gcloud iam service-accounts create cloudk-reader \
--display-name="CloudK Cost Reader"
# Grant billing viewer role
gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
--member="serviceAccount:cloudk-reader@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
--role="roles/billing.viewer"
# Create and download key
gcloud iam service-accounts keys create cloudk-key.json \
--iam-account=cloudk-reader@YOUR_PROJECT_ID.iam.gserviceaccount.comReplace YOUR_PROJECT_ID with your actual GCP project ID.
Go to CloudK Dashboard
Navigate to your CloudK dashboard
Click "Connect GCP Account"
Select Google Cloud from the cloud providers.
Upload your JSON key
Upload the service account JSON key file you downloaded earlier, or paste its contents.
Click "Connect"
CloudK will verify your credentials and start analyzing your GCP costs.
CloudK only requests viewer-level access to your GCP project. We cannot create, modify, or delete any resources. Your service account credentials are encrypted using AES-256 encryption before storage.
Having trouble connecting your GCP account? Our support team is here to help.
Contact Support