GCP Setup Guide

Connect your Google Cloud Platform account to KorPro and start analyzing your GKE clusters.

Prerequisites

  • Google Cloud Platform account with billing enabled
  • GKE clusters running in your GCP project
  • Service account with appropriate permissions

Step 1: Create a Service Account

Create a service account in your GCP project with read-only permissions:

  1. Go to IAM & Admin → Service Accounts in the GCP Console
  2. Click "Create Service Account"
  3. Name it "korpro-reader" and click "Create"
  4. Grant the following roles:
    • Kubernetes Engine Viewer
    • Compute Viewer
    • Service Account User

Step 2: Generate Service Account Key

Create and download a JSON key for the service account:

  1. Click on the service account you just created
  2. Go to the "Keys" tab
  3. Click "Add Key" → "Create new key"
  4. Select JSON format and click "Create"
  5. Save the downloaded JSON file securely

Step 3: Connect to KorPro

In the KorPro dashboard, navigate to Settings → Cloud Providers → GCP:

  1. Click "Add GCP Account"
  2. Upload the service account JSON key file
  3. Enter your GCP project ID
  4. Click "Connect"

Step 4: Verify Connection

KorPro will automatically discover all GKE clusters in your project. You should see them appear in your dashboard within a few minutes.

Troubleshooting

Clusters not appearing?

  • Verify the service account has the correct IAM roles
  • Check that GKE API is enabled in your project
  • Ensure clusters are in regions that KorPro supports

Permission errors?

  • Verify "Kubernetes Engine Viewer" role is assigned
  • Check that the service account key is valid and not expired
  • Ensure the project ID matches your actual GCP project