Docs

GCP Integration

Learn how to integrate GCP with Cokpit

GCP Credentials

Step 1: Create Credentials on GCP

Example: Service Account Key

  1. Go to the Google Cloud Console.

  2. Navigate to IAM & Admin → Service Accounts.

  1. Click Create Service Account.
  1. Enter a name and description, then click Create.
  1. Assign a role (e.g., Owner or required roles).
  1. Click Done.
  2. Find your service account, click ⋮ menu → Manage keys.
  1. Click Add Key → Create New Key → JSON.
  1. Download the JSON key file.

💡 Tip: Keep the JSON key file safe; you'll need it for the next step.

Step 2: Add GCP Credentials to Cokpit

  1. Open Cokpit and go to Integrations → Cloud Provider → GCP.

  2. Click Add secret.

  3. Fill in the required fields:

    • Enter a unique Secret Name
    • Enter your Project ID
    • Set the Output Format (defaults to json)
    • Upload the JSON key file you downloaded
  4. Click Submit.

Security Best Practices

  • Use service accounts with minimum required permissions
  • Rotate service account keys regularly
  • Keep JSON key files secure and never share them
  • Monitor GCP audit logs for security events
  • Follow GCP security best practices