Recipe
apisix-chart
Apache APISIX on Kubernetes via the project's own Helm chart, its bundled etcd and ingress controller switched off: a Deployment, a ClusterIP Service for the proxy data plane and the configuration map the gateway reads. With nothing wired to the models socket the configuration store is the etcd component wired on the `etcd` socket, and a ClusterIP Service fronts the Admin API, authenticated by the key the `admin_key` slot names: the chart reads it from the Secret the attached credential publishes, so no rendered file carries a key. Its client allowlist, `apisix.admin.allow.ipList`, admits every address, so narrow it wherever the admin port is routable from outside the cluster. With a model wired the chart runs in its standalone mode: each connection's routes, through APISIX's AI proxy, sit in a ConfigMap named after the gateway, which reads them with no etcd and no Admin API. A connection's credential, and each key of the callers infra.callers declares, arrives as an env secretKeyRef the routes file names through APISIX's $env:// reference, so no key is in the rendered output; each caller is a consumer whose key every route checks. Written onto the routes: core/period-budget as token rate limiting, with one replica; core/semantic-caching as a semantic cache; core/prompt-deny-patterns as a prompt guard — no completion route beside the budget or the guard. With `values.metrics_enabled` true, the chart serves the gateway's metrics on its own Service, port 9091, which checks no caller, published as provides.metrics_endpoint; false, that key is empty. Reach for it where a chart repository is reachable at build time or a model is served, and for `apisix` where the build must fetch nothing.
Provenance
- Content digest
- sha256:a7510e196d3b829bbc20f96e57c55e48b2b1d5cad012ef50528cb6533b2483d8
- Published
- 2026-11-10T10:22:07Z
- 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:24a1815589ae23ae13545049e1066888d1656a1a6159bd66a6e0e2fccd82ac8c
Reference at this version
oci://hub.aggrega.ai/recipe/helm/apisix-chart:1.0.0- Target
- —
- Implements
- core/gateway/apisix:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| host | {{ .context.rendered_name }}-gateway |
| port | {{ .infra.http_port }} |
| protocol | http |
| endpoint | {{ with optional .values "model" "" }}http://{{ $.context.rendered_name }}-gateway:{{ $.infra.http_port }}/{{ . }}/v1{{ end }} |
| model | {{ optional .values "model" "" }} |
| metrics_endpoint | {{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-prometheus-metrics:9091/apisix/prometheus/metrics{{ end }} |
Workload
No workload template declared.
Locals
| Name | Template |
|---|---|
| model_routes_config_map_suffix | -model-routes |
| connection_variable_prefix | AI_PROXY_ |
| credential_variable_suffix | _API_KEY |
| header_variable_suffix | _AUTHORIZATION |
| caller_variable_prefix | CALLER_ |
| caller_key_variable_suffix | _KEY |
| cache_store_password_variable | CACHE_STORE_PASSWORD |
| callers | {{ with optional .infra "callers" "" }}{{ range $i, $caller := . }}{{ if $i }}, {{ end }}{{ $caller }}{{ end }}{{ end }} |
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/apisix: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.