Recipe

agentgateway

agentgateway for local development via Docker Compose, synthesized from the Workload kind by the compose provider: one service running the project's image, pinned by digest, from one configuration file mounted from a compose config. Nothing is published to the host; provides.host is the compose service name. Each model wired to the models socket is one entry of that file, named by the connection's alias and sent to the endpoint and model name the model publishes. A connection's credential is the value it publishes as AI_PROXY_<ALIAS>_API_KEY on the inject pipe, written into the service's environment as it was delivered — a Compose variable reference such as ${OPENAI_API_KEY} lands as that reference, a literal as itself — and the entry names the variable, never the value. The file attaches no UI to the data-plane port. It realizes none of the AI Features the Component's labels admit, so attaching one halts the build naming its type, and it halts on infra.callers: this target holds no Secret to read the callers' keys from. Reach for it under Docker Compose; reach for `agentgateway-chart` on Kubernetes. The image carries no shell or client to run a check from, so the service declares no healthcheck. The gateway's metrics are always on, on port 15020, which checks no caller and which any peer on the compose network reaches. With `values.metrics_enabled` true their address is published as provides.metrics_endpoint; false, that key is empty.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:da6875461dfadef345dd1e4e151d51eefad37d40d8b927caf632fc65b2bc943b
Published
2026-11-10T10:18:12Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:41ebff8f46a64c02d1b0973e9156a11c3cc5452769546d04740270112d0f2c50

Reference at this version

oci://hub.aggrega.ai/recipe/compose/agentgateway:1.0.0
Target
—
Implements
core/gateway/agentgateway:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.http_port }}
protocolhttp
endpoint{{ with optional .values "model" "" }}http://{{ $.context.instance_id }}:{{ $.infra.http_port }}/v1{{ end }}
model{{ optional .values "model" "" }}
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.instance_id }}:15020/metrics{{ end }}

Workload

Workload · form: stateless · containers: main

Locals

NameTemplate
imagecr.agentgateway.dev/agentgateway:v1.6.0@sha256:9d3e6044ddcdc0878b1787f77bd401252b95e22684203fb5e874c4c42d2ed90c
config_name{{ .context.instance_id }}-config
config_path/config/config.yaml
connection_variable_prefixAI_PROXY_
credential_variable_suffix_API_KEY

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/gateway/agentgateway:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy