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
- 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.
| Name | Template |
|---|---|
| host | {{ .context.instance_id }} |
| port | {{ .infra.http_port }} |
| protocol | http |
| 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
| Name | Template |
|---|---|
| image | cr.agentgateway.dev/agentgateway:v1.6.0@sha256:9d3e6044ddcdc0878b1787f77bd401252b95e22684203fb5e874c4c42d2ed90c |
| config_name | {{ .context.instance_id }}-config |
| config_path | /config/config.yaml |
| connection_variable_prefix | AI_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.