spec.deployment

Where and how the agent ships in production. Pick a target with type, then configure the matching sub-block.

spec:
  deployment:
    type: kubernetes
    kubernetes:
      image:
        registry: ghcr.io
        repository: company/customer-support-agent
        tag: v1.0.0

Fields

Field	Type	Required	Description
type	string		enum: kubernetes, cloudrun. Selects the deployment target.
kubernetes	object		See Kubernetes.
cloudrun	object		See Cloud Run.

Kubernetes

spec:
  deployment:
    type: kubernetes
    kubernetes:
      image:
        registry: ghcr.io
        repository: company/customer-support-agent
        tag: v1.0.0

Field	Description
image	See Image.

The Kubernetes block is intentionally minimal in v1 - it carries the image and leaves the rest (Deployment, Service, ConfigMap, …) to the generator's templating. Future minor versions may add typed slots for replica counts and resource limits as common patterns harden.

Cloud Run

spec:
  deployment:
    type: cloudrun
    cloudrun:
      image:
        registry: us-central1-docker.pkg.dev
        repository: my-project/agents/customer-support
        tag: v1.0.0
        useCloudBuild: true
      resources:
        cpu: "1"
        memory: 512Mi
      scaling:
        minInstances: 1
        maxInstances: 10
        concurrency: 80
      service:
        timeout: 300
        allowUnauthenticated: false
        serviceAccount: [email protected]
        executionEnvironment: gen2
      environment:
        LOG_LEVEL: info
        CACHE_TTL: "300"

Field	Reference
image	Image
resources	Resources
scaling	Scaling
service	Service
environment	{ [key: string]: string } - env vars.

environment is injected into the running service and commonly carries both configuration and secrets. Never inline a real secret here - reference it with a ${VAR} placeholder and let your deploy pipeline supply the value. See Secrets & interpolation. (The kubernetes target has no environment map of its own; the generator's templating owns the Deployment's env / envFrom.)

Resources

Field	Type	Description
cpu	string	CPU allocation per instance (e.g. "1").
memory	string	Memory per instance (e.g. 512Mi, 2Gi).

Scaling

Field	Type	Description
minInstances	integer	Minimum number of instances kept warm.
maxInstances	integer	Cap on instances Cloud Run may spin up.
concurrency	integer	Concurrent requests served per instance.

Service

Field	Type	Description
timeout	integer	Per-request timeout in seconds.
allowUnauthenticated	boolean	If true, the service is publicly invokable.
serviceAccount	string	GCP service-account email the service runs as.
executionEnvironment	string	Cloud Run execution environment (e.g. gen1, gen2).

Image

Used by both the kubernetes and cloudrun sub-blocks.

Field	Type	Description
registry	string	Image registry (e.g. ghcr.io).
repository	string	Image repository within the registry.
tag	string	Image tag.
useCloudBuild	boolean	If true, the generator wires in Google Cloud Build for image production. Most useful with type: cloudrun.