GCP Provider

The GCP provider lets you manage Google Cloud Platform resources declaratively. All resources use your own GCP service account credentials, supporting multi-tenant deployments where each user operates in their own GCP project.

Setup

Prerequisites

A GCP project with billing enabled
A service account with appropriate permissions
Service account credentials JSON

Required Permissions

Resource	Required Roles
`gcp/secret`	`roles/secretmanager.admin`
`gcp/cloudsql/*`	`roles/cloudsql.admin`
`gcp/gke`	`roles/container.admin`

Credential Setup

All GCP resources require a credentials field containing your service account JSON, as an object or a JSON string. Inject it with a FieldReference to a pragma/secret output rather than writing it inline; gcp/secret does not output its payload (see Referencing Secrets).

Resources

Resource	Type	Description
Secret	`gcp/secret`	Secret Manager secrets for storing API keys and credentials
Cloud SQL	`gcp/cloudsql/database_instance`, `gcp/cloudsql/database`, `gcp/cloudsql/user`	Managed PostgreSQL/MySQL databases
GKE	`gcp/gke`	Google Kubernetes Engine clusters (Autopilot and Standard)

Architecture

GCP resources often form dependency chains:

Secret (credentials)
  └─▶ GKE Cluster
        └─▶ Kubernetes Config
              └─▶ Kubernetes workloads
  └─▶ Cloud SQL Instance
        ├─▶ Database
        └─▶ User

Getting Started

Concepts

Resource Catalog

Agno (AI Agents)

GCP

Kubernetes

Building Providers

Setup

Prerequisites

Required Permissions

Credential Setup

Resources

Architecture

​Setup

​Prerequisites

​Required Permissions

​Credential Setup

​Resources

​Architecture

Setup

Prerequisites

Required Permissions

Credential Setup

Resources

Architecture