Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Component

core/gateway/higress

Higress, an open-source gateway built on Envoy and configured through Kubernetes resources: its routes are ingresses, the services it reaches are its own registry's entries, and its controls are WebAssembly plugins on the routes they act on. It terminates client HTTP on its proxy port, publishing its host, port and protocol. It serves models: each model wired to its models socket is reached under an alias at /<alias>/v1 through Higress's AI proxy, sent to the endpoint and model name the model publishes, presenting the connection's credential from its Secret; over https it checks that the model's certificate chains to the system's trust anchors and names its host. Connections naming one alias in serves share its requests. It publishes the route of values.model as its endpoint and that alias as its model, so an agent's model socket takes it in place of a model; with nothing wired both are empty. On those routes it masks requests, keeps a token budget in its cache socket's store, records each model request in its access log and sets each route's retry, refusing by name what Higress cannot keep; it declares no callers. Reply validation, the fallback chain, the semantic cache, the prompt-injection shield and latency-based target selection halt the build naming what Higress lacks. It pulls its plugin modules from Higress's plugin registry at run time, which the cluster must reach and the build cannot check. It is realized on Kubernetes by `higress-chart` alone, and publishes the pod label, port name and path a scraper discovers its gateway's metrics by.

Asal-usul

ResmiDitandatangani oleh identitas penandatangan yang diakui katalog ini sebagai penerbit resmi.
Digest konten
sha256:8b92c8a380a01667259d0b041b43a42dc1c93b50b58b21741d1cc4a57a8260f9
Dipublikasikan
2026-11-10T10:11:55Z
Identitas penandatangan
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Tanda tangan

  • Resmiapplication/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:ef9dfa3941c48639070a7b9379a7ff22eb5637b82b98304936be0d1c243fd7b7

Referensi pada versi ini

oci://hub.aggrega.ai/component/core/gateway/higress:1.0.0

Parameter pengembang

Nilai yang ditetapkan pengembang di Aggregate.

NamaTipeBawaanWajibDeskripsi
modelstring—tidakThe alias this gateway publishes as its model, and whose route its published endpoint addresses — a serves value a models connection names, or the name of a connection naming none. It must be an alias the models socket serves, and the build halts naming this value otherwise; it is required while the models socket holds a connection, and omitted while it holds none.

Penentuan ukuran oleh operator

Ukuran infrastruktur yang disesuaikan operator untuk setiap lingkungan.

NamaTipeBawaanWajibDeskripsi
http_portinteger (min 1, max 65535)80tidakProxy data-plane port consumers connect to.
source_versionstring—tidakVersion of the Higress chart the chart-backed realization pulls. The realization holds the chart versions its configuration is proven at, and the build halts naming them on any other.
computeobject—tidak—
overridesobject (open)—tidakProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Kontrak keluaran

Nilai yang dipublikasikan komponen ini kepada konsumen melalui topologi uses.

NamaTipeBawaanWajibDeskripsi
hoststring—yaIn-cluster DNS name of the Service fronting the gateway's proxy, the name alone without a namespace. A consumer sends its client traffic here rather than to the service behind the gateway.
portinteger—yaTCP port that Service accepts proxied traffic on, infra.http_port.
protocolstring—tidakHow the published address is spoken to — `http`, so a consumer composes an address on that scheme.
endpointstring—tidakFull base URL of the OpenAI-compatible API the gateway serves for the alias values.model names, with the host, the port and that alias's route already composed. A caller hands it to a client library as its base URL. Every other alias is served at the same host and port under its own name in the path. Empty while nothing is wired to the models socket.
modelstring—tidakThe alias a consumer wired to the gateway sends as its model name: values.model. The route behind the endpoint asks each model for the name that model publishes, whatever name a request carries. Empty while nothing is wired to the models socket.
metrics_pod_selectorstring—tidakKubernetes label selector matching the gateway's pods, for a scraper that discovers those pods directly rather than scraping one address. Published beside `metrics_pod_port` and `metrics_path`.
metrics_pod_portstring—tidakName of the container port on those pods that carries the metrics, `istio-prom`.
metrics_pathstring—tidakPath the metrics are served at on that port, `/stats/prometheus`.

Soket uses

Soket dependensi yang menjadi jalur koneksi komponen ini. Target setiap koneksi yang dihubungkan melalui sebuah soket harus memenuhi selektor labelnya, dan setiap koneksi dapat membawa lampiran pada slot yang dideklarasikan soket tersebut. Slot wajib harus diisi oleh setiap koneksi yang dihubungkan oleh Aggregate atau Release melalui soket tersebut.

models

Selektor
component.aggrega.ai/category=ai-model
Injeksi
—

Slot yang dapat diisi oleh setiap koneksi melalui soket ini

SlotSelektorWajibInjeksiSensitifDeskripsi
credentialfeature.aggrega.ai/kind=secrettidak—yaOptional credential the gateway presents to the model this connection reaches, as a bearer token. When attached, the AI proxy's configuration names the Secret the credential publishes and the data key holding the key there, and the Higress controller reads the key from that Secret, in the gateway's namespace, so the key appears in no rendered file. The credential must publish both, and a Secret name holding a dot halts the build, because Higress reads the name up to its first dot; a realization naming its own Secret after the connection and this slot writes such a dot, so realize it with one naming an existing Secret whose name holds none. Unattached, the gateway adds no credential.

cache

Selektor
datastore.aggrega.ai/engine=kv
Injeksi
—

Slot yang dapat diisi oleh setiap koneksi melalui soket ini

SlotSelektorWajibInjeksiSensitifDeskripsi
credentialfeature.aggrega.ai/kind=secrettidak—yaOptional password the gateway's token budget presents to the Redis-protocol store this connection reaches. When attached, the budget's configuration names the Secret the credential publishes and the data key holding the password there, and the Higress controller reads the password from that Secret, in the gateway's namespace, so it appears in no rendered file. The credential must publish both, and a Secret name holding a dot halts the build, because Higress reads the name up to its first dot; realize it with one naming an existing Secret whose name holds none. Unattached, the plugin connects with no password, which is what the shipped store components expect by default.

Slot lampiran

Titik pengikatan bernama tempat sebuah Feature dilampirkan ke komponen ini. Selektor sebuah slot membatasi Feature mana yang dapat mengisinya, dan daftar injeksinya menyebutkan cara materi Feature dapat dikirimkan. Slot wajib harus terikat pada setiap instans, melalui lampiran pada instans tersebut atau pada cakupan di atasnya, dan slot sensitif dideklarasikan untuk menangani materi rahasia. Sebuah Feature juga dapat dilampirkan dengan nama yang tidak dideklarasikan oleh slot mana pun.

Tidak ada slot lampiran yang dideklarasikan.

Daftar izin injeksi mandiri

Tidak ada pipa injeksi mandiri yang dideklarasikan.

Relasi

Sisi bertipe ke dan dari entitas lain yang dipublikasikan. Referensi tanpa target yang dipublikasikan ditampilkan sebagai sisi yang terputus, bukan sebagai tautan.

Menggunakan

Digunakan oleh

Referensi konsep Component →

Katalog Aggrega — indeks terbuka berisi komponen, fitur, resep, dan plugin yang merendernya.

Dibangun dengan sistem desain Aggrega yang digunakan bersama.

Privasi