Get Started on Cloud
BasicsAI AgentsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesAgents & TunnelsYAMLBuddy GitCLIAPIFAQ

YAML for Kubernetes Cluster

View as Markdown

Self-managed Kubernetes cluster target.

YAML parameters for Kubernetes Cluster

PARAMETERS
clusterrequiredstring
The ID of the cluster or fully qualified identifier for the cluster
targetrequiredstring
The human-readable ID of the target
authK8sAuthYaml
Kubernetes cluster authentication configuration
permissionsPermissionsYaml
Access permissions for the target
namestring
The name of the target
integrationstring
The integration. Required when adding GKE/EKS/AKS/DOKS
regionstring
Cloud region, e.g. eu-central-1
application_idstring
The ID of the application/project
projectstring
The ID of the Google Cloud project
subscriptionstring
Type of AKS subscription
resource_groupstring
Azure resource group containing the AKS cluster
zonestring
GKE zone. E.g., europe-west3-a
proxystring
Proxy configuration to route K8s API traffic through (for private clusters)
disabledboolean
Indicates if this target is disabled (default: false)
tagsstring[]
The list of tags associated with the target
use_asUseAsYaml
Defines how the target can be used (as deployment target, proxy, or both)
notestring
Note for this resource
agent_notestring
YAML note for AI agents operating on this resource
typestring

Value: K8S_CLUSTER

Last modified on Sep 17, 2026

Previous pageGoogle Kubernetes EngineNext pageMicrosoft SQL Server

YAML examples for Kubernetes Cluster

Kubernetes cluster with password authentication

yaml
- target: myTarget
  type: K8S_CLUSTER
  cluster: https://my-cluster-url:6443
  auth:
    method: PASS
    username: my_user
    password: my_password

Password Auth

yaml
- target: myTarget
  type: K8S_CLUSTER
  cluster: https://my-cluster-url:6443
  auth:
    method: PASS
    username: my_user
    password: my_password

Cert Auth

yaml
- target: myTarget2
  type: K8S_CLUSTER
  cluster: https://my-cluster-url:6443
  auth:
    method: CERT
    certificate_authority: ccc
    client_certificate: vvv
    client_key: xxx

Token Auth

yaml
- target: myTarget3
  type: K8S_CLUSTER
  cluster: https://my-cluster-url:6443
  auth:
    method: TOKEN
    token: my_token