Chroma 教程 收藏

环境变量

🎉摘要:介绍 Chroma 通过环境变量进行配置的方式,包括命名规则与优先级、运维常用变量(数据目录、端口、监听地址、请求体大小、CORS、SQLite 等)、OpenTelemetry 相关变量,并说明 Chroma 1.0.0 之后已失效的鉴权变量。

除了配置文件,Chroma 还支持通过环境变量来进行设置,如果使用容器 Docker 进行部署,这种方式很友好。

命名规则:

  • 前缀固定 CHROMA_

  • yaml 嵌套层级用 双下划线 __ 分隔

  • 优先级:环境变量 > yaml 配置文件 > 默认值

运维常用的

环境变量作用默认值
CHROMA_PERSIST_PATH数据目录./chroma
CHROMA_PORTHTTP 端口8000
CHROMA_LISTEN_ADDRESS监听地址0.0.0.0
CHROMA_ALLOW_RESET是否允许 resetfalse
CHROMA_MAX_PAYLOAD_SIZE_BYTES最大请求体41943040(40 MiB)
CHROMA_CORS_ALLOW_ORIGINSCORS 允许的来源[]
CHROMA_SQLITE_FILENAMESQLite 文件名chroma.sqlite3
CHROMA_SQLITEDB__MIGRATION_MODE迁移模式 apply / validateapply
CHROMA_SQLITEDB__HASH_TYPE迁移哈希算法 md5 / sha256md5

OpenTelemetry 相关

环境变量作用
CHROMA_OPEN_TELEMETRY__ENDPOINTOTLP 端点
CHROMA_OPEN_TELEMETRY__SERVICE_NAME服务名,默认 chromadb
OTEL_EXPORTER_OTLP_HEADERS导出 traces 时的认证头

已经失效的鉴权变量

这一条必须单独说,因为网上大量教程还在用:

CHROMA_SERVER_AUTHN_PROVIDER
CHROMA_SERVER_AUTHN_CREDENTIALS
CHROMA_SERVER_AUTHN_CREDENTIALS_FILE
CHROMA_SERVER_AUTHZ_PROVIDER
CHROMA_SERVER_AUTHZ_CONFIG
CHROMA_SERVER_AUTHZ_CONFIG_FILE
CHROMA_AUTH_TOKEN_TRANSPORT_HEADER

Chroma 1.0.0 之后不再内置认证实现,这些变量全部失效。 看到就当历史遗迹。要鉴权只能在反向代理层做,见后续章节。

说说我的看法
全部评论()
没有评论
关于
本网站专注于 Java、数据库(MySQL、Oracle)、Linux、软件架构及大数据等多领域技术知识分享。涵盖丰富的原创与精选技术文章,助力技术传播与交流。无论是技术新手渴望入门,还是资深开发者寻求进阶,这里都能为您提供深度见解与实用经验,让复杂编码变得轻松易懂,携手共赴技术提升新高度。如有侵权,请来信告知:hxstrive@outlook.com
其他应用
公众号