Feature

core/http-route

Publishes a server component on a gateway programmed through the Gateway API. Its FeatureRecipe (component-scope) emits one HTTP route per attached component, naming the gateway the route attaches to as its parent and the Service the component's own Recipe emits as its backend. The developer attaches it in the Aggregate and writes the request path in values, because which requests an application serves is part of what the application is. The operator sizes the same attachment on the Release's entry for the component, writing in infra the hostname, which is the environment's name for the component, and the cluster knobs, which describe the cluster the Release lands in rather than the application: which gateway and listener to attach to, and which Service and port to forward to. Left without a hostname, the route carries none and serves every hostname the gateway's listener accepts, with the path match separating it from the other routes on that listener. The Service defaults to the primary Service a synthesized workload emits, so a Release whose Recipe sources an upstream chart naming its Service otherwise sets service_name to that name. A route names its backend port by number rather than by name, and an attachment cannot read the port the component it is attached to was given, so service_port carries no default and the build halts until the Release supplies it.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:1e128601239ab64c64e1e28e490923b56b5dd13b76bbb588e7d2edb6b3e705cd
Published
2026-11-10T10:17:11Z
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:6f13680c509a268a624965cb836aa0a9e2956c18b785026e3b60ac44b3a39326

Reference at this version

oci://hub.aggrega.ai/feature/core/http-route:1.0.0
Applies to
component.aggrega.ai/type=server
Conflicts with
—

Developer parameters

Values the developer sets when attaching this feature.

Extends BaseComponents#/schemas/BaseFeatureParameter

NameTypeDefaultRequiredDescription
pathstring—noRequest path prefix routed to the component.

Output contract

Values this feature publishes to consumers.

No output values declared.

Annotations

No annotations 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

Used by

Feature 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