Recipe

apisix

Apache APISIX on Kubernetes via the helm provider's Workload synthesis (a stateless Deployment plus a ClusterIP Service on the proxy port), running the official upstream image with no Helm chart. APISIX holds no local state — the etcd store is the system of record — so it renders stateless. The Admin API is reachable only from inside the cluster — no Service publishes its port — and is authenticated by the key the `admin_key` credential slot names, which the Deployment delivers from the Secret the attached credential publishes, so no rendered file carries the key. Its client allowlist, `allow_admin`, admits every address, so narrow it wherever the admin port is routable from outside the cluster. It renders no route: routes live in etcd, written through the Admin API at run time, so it serves no model, publishes an empty endpoint and model, and halts on a connection to the models socket — `apisix-chart` serves those. At its default image, APISIX 3.17.0, the gateway has no semantic cache plugin (`ai-cache`), and its token rate limiting counts per node; it halts on a core/period-budget, core/semantic-caching or core/prompt-deny-patterns attachment, and on infra.callers, which only a routes file declares. With `values.metrics_enabled` true, the gateway's metrics server moves off the loopback address and its port, 9091, which checks no caller, joins the Service, its address published as provides.metrics_endpoint; false, that key is empty. Reach for this realization where the build must complete with nothing fetched; reach for `apisix-chart`, which renders the project's own chart from named settings, where the configuration is expected to follow the product or a model is served.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:187235d759e07524d599fff750f4060a1cda6af66f38a3774bfeecfb1430b39c
Published
2026-11-10T10:22:08Z
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:91e316b9b40812cef7756de6b9c18bed385123977e2e32df63957e9037f6514d

Reference at this version

oci://hub.aggrega.ai/recipe/helm/apisix:1.0.0
Target
—
Implements
core/gateway/apisix:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.rendered_name }}-default
port{{ .infra.http_port }}
protocolhttp
endpoint
model
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-default:9091/apisix/prometheus/metrics{{ end }}

Workload

Workload · replicas: 1 · containers: main

Locals

NameTemplate
admin_key_variableAPISIX_ADMIN_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/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.

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