Chroma 教程 收藏

配置文件

🎉摘要:Chroma 支持通过 YAML 配置文件启动服务,代替每次使用 --path 指定路径的繁琐方式。本文介绍 config.yml 基本配置及官方完整示例,包含 persist_path、server、sqlitedb 等字段,并演示 chroma run ./config.yml 启动方法。

前面使用 chroma run 启动服务时,使用 --path 指定存放路径,每次都要输出地址,麻烦还容易输错。

其实,Chroma 支持通过配置文件来配置 Chroma 服务,配置文件采用 YAML 文件,下面是一个简单的配置文件:

# config.yaml
allow_reset: false
persist_path: /data/chroma

# 服务端监听
server:
  host: 0.0.0.0
  port: 8000
  cors_allow_origins: ["*"]

# SQLite
sqlitedb:
  migration_mode: apply
  hash_type: md5

将上面配置文件创建在当前目录,名称为 config.yml,然后使用如下命令启动服务:

chroma run ./config.yml

运行效果如下图:

注意,官方有个完整示例可以参考,字段很全:rust/frontend/sample_configs/single_node_full.yaml(在 GitHub 仓库里 https://github.com/chroma-core/chroma/blob/main/rust/frontend/sample_configs/single_node_full.yaml),内容如下:

########################
# HTTP server settings #
########################
# OpenTelemetry 可观测性链路追踪配置
open_telemetry:
  # 上报服务名称,在追踪平台用于区分 Chroma 服务
  service_name: "chroma"
  # OTel Collector GRPC 上报地址
  endpoint: "http://otel-collector:4317"
  # 日志/追踪过滤规则列表
  filters:
    # 按 Rust crate 名称过滤
    - crate_name: "chroma_frontend"
      # 采集级别:trace 采集全链路追踪数据
      filter_level: "trace"
# HTTP 服务监听端口
port: 8000
# 监听网卡地址,0.0.0.0 允许外部访问
listen_address: "0.0.0.0"
# HTTP 请求最大 body 上限,单位字节,当前 40MB
max_payload_size_bytes: 41943040
# CORS 跨域允许来源,["*"] 允许全部跨域(开发环境使用,生产不要用*)
cors_allow_origins: ["*"]

####################
# General settings #
####################
# Chroma 向量库持久化数据目录
persist_path: "./chroma"
# 是否允许调用 reset 清空全部数据接口,默认 false(生产建议保持关闭)
allow_reset: false # defaults to false
# SQLite 数据库相关配置
sqlitedb:
  # ID 哈希算法,可选 md5 / sha256
  hash_type: "md5" # or "sha256"
  # 数据库迁移策略:apply 自动执行迁移;validate 仅校验不自动执行
  migration_mode: "apply" # or "validate"
# 系统元数据库配置
sysdb:
  sqlite:
    # WAL 日志主题命名空间
    log_topic_namespace: "default"
    # WAL 日志租户标识
    log_tenant: "default"

 

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