Deploy a Custom-Image Agent

This guide shows you how to deploy an Agent resource using your own container image instead of an operator-managed template.

Prerequisites

Agent Runtime Operator installed — see Install the Agent Runtime Operator.
A container image that exposes an HTTP server implementing the A2A protocol.

Container requirements

Your custom agent image must:

Expose an HTTP server on the port you configure (or the framework default).
Implement the A2A protocol specification.

For examples and an SDK for building custom agent images, see:

Create the Agent

Set spec.image to your container image. The operator uses your image instead of a template:

apiVersion: runtime.agentic-layer.ai/v1alpha1
kind: Agent
metadata:
  name: weather-agent
spec:
  framework: google-adk
  image: ghcr.io/agentic-layer/weather-agent:0.3.0
  protocols:
    - type: A2A
  replicas: 1
  env:
    - name: LOGLEVEL
      value: "INFO"

kubectl apply -f weather-agent.yaml

Verify

# Check the Agent resource status
kubectl get agent weather-agent

# Check the underlying Deployment
kubectl get deployment weather-agent

# View agent logs
kubectl logs -l app=weather-agent

The agent is ready when the Deployment reports all replicas available.

Related