本页面为机器翻译。阅读英文原文。

Recipe

litellm-gateway

An AI gateway on Kubernetes via the helm provider's Workload synthesis, running the official upstream proxy image directly. Renders a Deployment, a ClusterIP Service and a ConfigMap carrying the routing table. Every credential reaches the gateway as an env secretKeyRef, so no credential value appears in its own resources. It is proven at LiteLLM v1.103.1 and halts on any other engine_version. On every Release a second ConfigMap carries a request guard, which forwards only the request fields the proxy declares for the route, plus any the Release admits in infra.admitted_request_fields, and refuses the rest naming the field. The same ConfigMap configures a path allowlist, a container running the official nginx image (BSD-2-Clause) on infra.port, which answers 403 to every path but the routes the gateway serves. A core/context-propagation attachment, a core/data-masking one listing what to mask, or values.log_masking listing it, adds the module each relies on. A core/prompt-injection-shield attachment sends every map entry to the guard on the guard socket. PROXY_BASE_URL and the Presidio and cache store addresses appear only when infra.external_base_url and their sockets are set. A store publishing redis-tls is reached over TLS, its password inside the cache's URL: keep that password to letters and digits. With `values.metrics_enabled` true the path allowlist forwards a GET of /metrics alone from port 9090, on the ClusterIP Service, to the gateway's metrics, published as provides.metrics_endpoint; false leaves that key empty. Reach for this realization where the build must fetch nothing; reach for `litellm-gateway-chart`, BerriAI's own chart, where its registry is reachable at build time.

来源

官方由本目录认定为官方发布者的签名身份签名。
内容摘要
sha256:1bd9c826a387e9d5d865a58bd1be2954fde9373af8533b5c24dfae2fa9896e22
发布时间
2026-11-10T10:25:06Z
签名身份
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

签名

  • 官方application/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:c2097aaeb345d727adeb5057c268933b86653cef71a6e4e4240558784ea99db5

此版本的引用

oci://hub.aggrega.ai/recipe/helm/litellm-gateway:1.0.0
目标
—
实现
core/gateway/litellm:1.0.0

提供

此配方为使用方接入的确定性指针模板。

名称模板
host{{ .context.rendered_name }}-default
port{{ .infra.port }}
endpointhttp://{{ .context.rendered_name }}-default:{{ .infra.port }}/v1
model{{ .locals.published_model }}
protocolhttp
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-default:{{ .locals.metrics_port }}/metrics{{ end }}

Workload

Workload · form: stateless · replicas: 1 · containers: main

局部变量

名称模板
config_fileconfig.yaml
provider_key_variableLITELLM_PROVIDER_API_KEY
connection_key_variable_prefixLITELLM_MODEL_
connection_key_variable_suffix_API_KEY
guard_api_keythe-guard-holds-the-upstream-credential
caller_identity_modulecaller_identity
masking_moduledata_masking
field_entity_masking_classFieldEntityMasking
reply_masking_classReplyMasking
buffered_reply_masking_classBufferedReplyMasking
field_pattern_masking_classFieldPatternMasking
held_reply_classHeldStreamedReply
log_masking_modulelog_masking
log_masking_classLogMasking
log_masking_failure_callbackwithhold_failed_calls
request_filter_modulerequest_field_filter
gateway_address127.0.0.1
gateway_port{{ if eq (int .infra.port) 65535 }}65534{{ else }}{{ add1 (int .infra.port) }}{{ end }}
metrics_port9090
gateway_metrics_port9091
path_allowlist_filepath-allowlist.conf
path_allowlist_image_tag1.27.5-alpine
request_guard_config_map_name{{ .context.instance_id }}-request-guard
request_guard_dir/etc/litellm-request-guard
request_guard_deliveryconfig_map
forward_organization_routesfalse
model_aliases{{ $aliases := list }}{{ range (optional .values "models" list) }}{{ $aliases = append $aliases .name }}{{ end }}{{ toJson $aliases }}
model_entries{{ toJson (optional .values "models" list) }}
published_model{{ with optional .values "model" "" }}{{ . }}{{ else }}{{ with optional .values "models" list }}{{ (index . 0).name }}{{ end }}{{ end }}
analyzer_entity_types["CREDIT_CARD", "CRYPTO", "DATE_TIME", "EMAIL_ADDRESS", "IBAN_CODE", "IP_ADDRESS", "LOCATION", "MAC_ADDRESS", "MEDICAL_LICENSE", "NRP", "PERSON", "PHONE_NUMBER", "UK_NHS", "URL", "US_BANK_NUMBER", "US_DRIVER_LICENSE", "US_ITIN", "US_PASSPORT", "US_SSN"]
proven_engine_versions["v1.103.1"]
cache_store_host_variableSEMANTIC_CACHE_STORE_HOST
cache_store_port_variableSEMANTIC_CACHE_STORE_PORT
cache_store_password_variableREDIS_PASSWORD
cache_store_url_variableSEMANTIC_CACHE_STORE_URL

值映射

未声明值映射。

关系

与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。

使用

  • 实现实现契约兼容

    core/gateway/litellm:1.0.0

    所有必需输出均已满足,且提供的每个输出都在契约中列出。

被使用

目录中没有任何内容依赖此实体。

Recipe 概念参考 →

Aggrega 目录 — 收录组件、功能、配方以及渲染它们的插件的开放索引。

基于共享的 Aggrega 设计系统构建。

隐私