第 2 章 OLSConfig API 参考

featureGates

数组（字符串）

功能 Gates 包含要显式启用的功能列表，否则会默认禁用它们。可能的值： MCPServer

llm

object

LLMSpec 定义大型语言模型(LLM)的所需状态。

mcpServers

数组

MCP 服务器设置

ols

object

OLSSpec 定义 OLS 部署所需状态。

olsDataCollector

object

OLSDataCollectorSpec 定义允许的 OLS 数据收集器配置。

providers

数组

apiVersion

string

Azure OpenAI 供应商的 API 版本

credentialsSecretRef

object

存储 API 供应商凭证的 secret 对象的名称

deploymentName

string

Azure OpenAI 部署名称

models

数组

供应商中的模型列表

name

string

供应商名称

projectID

string

Watsonx 项目 ID

tlsSecurityProfile

object

连接到供应商的 TLS 安全配置集

type

string

供应商类型

url

string

Provider API URL

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

contextWindowSize

整数

在令牌中定义模型的上下文窗口大小。默认值为 128k 令牌。

name

string

型号名称

parameters

object

模型 API 参数

url

string

Model API URL

maxTokensForResponse

整数

最大响应令牌数。默认值为 2048 令牌。

custom

``

Custom 是一个用户定义的 TLS 安全配置集。使用自定义配置集时要非常小心，因为无效的配置可能是灾难性的。自定义配置集示例类似如下：

密码 ：

- ECDHE-ECDSA-CHACHA20-POLY1305

- ECDHE-RSA-CHACHA20-POLY1305

- ECDHE-RSA-AES128-GCM-SHA256

- ECDHE-ECDSA-AES128-GCM-SHA256

minTLSVersion: VersionTLS11

intermediate

``

intermediate 是一个基于以下内容的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28recommended.29

如下所示：

密码 ：

- TLS_AES_128_GCM_SHA256

- TLS_AES_256_GCM_SHA384

- TLS_CHACHA20_POLY1305_SHA256

- ECDHE-ECDSA-AES128-GCM-SHA256

- ECDHE-RSA-AES128-GCM-SHA256

- ECDHE-ECDSA-AES256-GCM-SHA384

- ECDHE-RSA-AES256-GCM-SHA384

- ECDHE-ECDSA-CHACHA20-POLY1305

- ECDHE-RSA-CHACHA20-POLY1305

- DHE-RSA-AES128-GCM-SHA256

- DHE-RSA-AES256-GCM-SHA384

minTLSVersion: VersionTLS12

modern

``

modern 是一个基于以下内容的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility

如下所示：

密码 ：

- TLS_AES_128_GCM_SHA256

- TLS_AES_256_GCM_SHA384

- TLS_CHACHA20_POLY1305_SHA256

minTLSVersion: VersionTLS13

old

``

旧是一个基于以下的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility

如下所示：

密码 ：

- TLS_AES_128_GCM_SHA256

- TLS_AES_256_GCM_SHA384

- TLS_CHACHA20_POLY1305_SHA256

- ECDHE-ECDSA-AES128-GCM-SHA256

- ECDHE-RSA-AES128-GCM-SHA256

- ECDHE-ECDSA-AES256-GCM-SHA384

- ECDHE-RSA-AES256-GCM-SHA384

- ECDHE-ECDSA-CHACHA20-POLY1305

- ECDHE-RSA-CHACHA20-POLY1305

- DHE-RSA-AES128-GCM-SHA256

- DHE-RSA-AES256-GCM-SHA384

- DHE-RSA-CHACHA20-POLY1305

- ECDHE-ECDSA-AES128-SHA256

- ECDHE-RSA-AES128-SHA256

- ECDHE-ECDSA-AES128-SHA

- ECDHE-RSA-AES128-SHA

- ECDHE-ECDSA-AES256-SHA384

- ECDHE-RSA-AES256-SHA384

- ECDHE-ECDSA-AES256-SHA

- ECDHE-RSA-AES256-SHA

- DHE-RSA-AES128-SHA256

- DHE-RSA-AES256-SHA256

- AES128-GCM-SHA256

- AES256-GCM-SHA384

- AES128-SHA256

- AES256-SHA256

- AES128-SHA

- AES256-SHA

- DES-CBC3-SHA

minTLSVersion: VersionTLS10

type

字符串

type 是 Old、Intermediate、Modern 或 Custom 之一。自定义提供指定各个 TLS 安全配置集参数的功能。旧、Intermediate 和 Modern 是基于以下内容的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations

该配置集基于意图，因此当开发新密码时，它们可能会随时间变化，并且发现现有密码不安全。根据具体哪些密码可用于进程，可能会减少列表。

请注意，Modern 配置集目前还不被支持，因为它还没有被常见软件库正确采用。

name

string

MCP 服务器的名称

streamableHTTP

object

可流的 HTTP 传输设置

enableSSE

布尔值

启用服务器 Sent 事件

标头

对象（字符串）

发送到 MCP 服务器的标头

sseReadTimeout

整数

SSE Read Timeout，默认为 10 秒

timeout

整数

MCP 服务器的超时时间，默认为 5 秒

url

字符串

MCP 服务器的 URL

additionalCAConfigMapRef

object

用于 OLS 服务和 LLM 供应商之间的 TLS 通信的额外 CA 证书

byokRAGOnly

布尔值

仅使用 BYOK RAG 源，忽略 Red Hat OpenShift Lightspeed 文档 RAG

conversationCache

object

对话缓存设置

defaultModel

string

使用的默认模型

defaultProvider

string

使用的默认供应商

部署

object

OLS 部署设置

introspectionEnabled

布尔值

启用内省功能

logLevel

string

日志级别。有效选项为 DEBUG、INFO、WARNING、ERROR 和 CRITICAL。默认："INFO"。

proxyConfig

object

用于连接到外部服务器的代理设置，如 LLM 提供程序。

queryFilters

数组

查询过滤器

quotaHandlersConfig

object

LLM Token Quota 配置

rag

数组

RAG 数据库

storage

object

持久性存储配置

tlsConfig

object

Lightspeed 后端 HTTPS 端点的 TLS 配置

tlsSecurityProfile

object

API 端点使用的 TLS 安全配置集

userDataCollection

object

用户数据收集交换机

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

postgres

object

PostgresSpec 定义 Postgres 的所需状态。

type

string

对话缓存类型。默认："postgres"

credentialsSecret

string

包含 postgres 凭证的 secret

dbName

string

postgres 数据库名称

maxConnections

整数

Postgres maxconnections。默认："2000"

sharedBuffers

integer-or-string

postgres sharedbuffers

user

string

Postgres 用户名

api

object

API 容器设置。

控制台

object

控制台容器设置。

dataCollector

object

数据收集器容器设置。

database

object

数据库容器设置。

mcpServer

object

MCP 服务器容器设置。

replicas

整数

定义所需 OLS pod 的数量。默认："1"

nodeSelector

对象（字符串）

resources

对象

ResourceRequirements 描述了计算资源要求。

容限（tolerations）

数组

claims

数组

claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。

这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。

此字段不可变。它只能为容器设置。

limits

integer-or-string

限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

name

string

name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。

Request （请求）

string

在引用的声明中为请求选择请求的名称。如果为空，则提供声明中的所有内容，否则仅提供此请求的结果。

effect

字符串

effect 表示要匹配的污点效果。空意味着匹配所有污点效果。指定后，允许的值为 NoSchedule，PreferNoSchedule 和 NoExecute。

key

字符串

key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空，则必须存在运算符；组合意味着匹配所有值和所有键。

operator

字符串

Operator 代表键与值的关系。有效的运算符是 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符，以便 pod 可以容忍特定类别的所有污点。

tolerationSeconds

整数

tolerationSeconds 代表容限的期间（必须生效 NoExecute，否则此字段将被忽略）可以容忍污点。默认情况下，它不会被设置，这意味着容许任何污点（不要驱除）。零值和负值将被视为 0 （立即删除）。

value

字符串

value 是容限匹配的污点值。如果运算符是 Exists，则该值应该为空，否则仅是一个常规字符串。

caCertificate

string

控制台代理端点使用的证书颁发机构(CA)证书。

nodeSelector

对象（字符串）

replicas

整数

定义所需控制台 pod 的数量。默认："1"

resources

对象

ResourceRequirements 描述了计算资源要求。

容限（tolerations）

数组

claims

数组

claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。

这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。

此字段不可变。它只能为容器设置。

limits

integer-or-string

限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

name

string

name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。

Request （请求）

string

在引用的声明中为请求选择请求的名称。如果为空，则提供声明中的所有内容，否则仅提供此请求的结果。

effect

字符串

effect 表示要匹配的污点效果。空意味着匹配所有污点效果。指定后，允许的值为 NoSchedule，PreferNoSchedule 和 NoExecute。

key

字符串

key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空，则必须存在运算符；组合意味着匹配所有值和所有键。

operator

字符串

Operator 代表键与值的关系。有效的运算符是 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符，以便 pod 可以容忍特定类别的所有污点。

tolerationSeconds

整数

tolerationSeconds 代表容限的期间（必须生效 NoExecute，否则此字段将被忽略）可以容忍污点。默认情况下，它不会被设置，这意味着容许任何污点（不要驱除）。零值和负值将被视为 0 （立即删除）。

value

字符串

value 是容限匹配的污点值。如果运算符是 Exists，则该值应该为空，否则仅是一个常规字符串。

resources

对象

ResourceRequirements 描述了计算资源要求。

claims

数组

claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。

这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。

此字段不可变。它只能为容器设置。

limits

integer-or-string

限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

name

string

name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。

Request （请求）

string

在引用的声明中为请求选择请求的名称。如果为空，则提供声明中的所有内容，否则仅提供此请求的结果。

nodeSelector

对象（字符串）

resources

object

ResourceRequirements 描述了计算资源要求。

容限（tolerations）

数组

claims

数组

claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。

这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。

此字段不可变。它只能为容器设置。

limits

integer-or-string

限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

name

字符串

name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。

Request （请求）

字符串

在引用的声明中为请求选择请求的名称。如果为空，则提供声明中的所有内容，否则仅提供此请求的结果。

effect

string

effect 表示要匹配的污点效果。空意味着匹配所有污点效果。指定后，允许的值为 NoSchedule，PreferNoSchedule 和 NoExecute。

key

string

key 是容限应用到的污点键。empty 表示与所有污点键匹配。如果键为空，则必须存在运算符；组合意味着匹配所有值和所有键。

operator

string

Operator 代表键与值的关系。有效的运算符是 Exists 和 Equal。默认值为 Equal。exists 等同于值的通配符，以便 pod 可以容忍特定类别的所有污点。

tolerationSeconds

整数

tolerationSeconds 代表容限的期间（必须生效 NoExecute，否则此字段将被忽略）可以容忍污点。默认情况下，它不会被设置，这意味着容许任何污点（不要驱除）。零值和负值将被视为 0 （立即删除）。

value

string

value 是容限匹配的污点值。如果运算符是 Exists，则该值应该为空，否则仅是一个常规字符串。

resources

object

ResourceRequirements 描述了计算资源要求。

claims

数组

claim 列出此容器使用的 spec.resourceClaims 中定义的资源名称。

这是一个 alpha 字段，需要启用 DynamicResourceAllocation 功能门。

此字段不可变。它只能为容器设置。

limits

integer-or-string

限制描述了允许的最大计算资源量。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

Requests 描述了所需的最少计算资源。如果容器省略了 Requests，则默认为 Limits （如果明确指定），否则默认为实现定义的值。请求不能超过限值。更多信息： https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

name

string

name 必须与使用此字段的 Pod 的 pod.spec.resourceClaims 中的一个条目的名称匹配。它允许容器内部使用该资源。

Request （请求）

string

在引用的声明中为请求选择请求的名称。如果为空，则提供声明中的所有内容，否则仅提供此请求的结果。

proxyCACertificate

object

保存代理 CA 证书的 configmap

proxyURL

string

代理 URL，例如 https://proxy.example.com:8080，将使用集群范围的代理，尽管 env var "https_proxy"。

name

string

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

name

string

过滤名称。

pattern

string

过滤器模式.

replaceWith

string

替换匹配模式。

enableTokenHistory

布尔值

启用令牌历史记录

limitersConfig

数组

令牌配额限制器

initialQuota

整数

令牌配额的初始值

name

string

限制器的名称

周期

string

令牌配额的期间

quotaIncrease

整数

令牌配额增加步骤

type

string

限制器的类型

image

string

用作 RAG 源的容器镜像 URL

indexID

string

RAG 数据库的索引 ID

indexPath

string

容器镜像中的 RAG 数据库的路径

class

string

请求卷的存储类

size

integer-or-string

请求卷的大小

keyCertSecretRef

object

KeySecretRef 是包含 TLS 密钥的 secret。

name

字符串

引用的名称。有效地需要此字段，但因为允许向后兼容为空。这里具有空值的此类实例几乎是错误的。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

custom

``

Custom 是一个用户定义的 TLS 安全配置集。使用自定义配置集时要非常小心，因为无效的配置可能是灾难性的。自定义配置集示例类似如下：

密码 ：

- ECDHE-ECDSA-CHACHA20-POLY1305

- ECDHE-RSA-CHACHA20-POLY1305

- ECDHE-RSA-AES128-GCM-SHA256

- ECDHE-ECDSA-AES128-GCM-SHA256

minTLSVersion: VersionTLS11

intermediate

``

intermediate 是一个基于以下内容的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28recommended.29

如下所示：

密码 ：

- TLS_AES_128_GCM_SHA256

- TLS_AES_256_GCM_SHA384

- TLS_CHACHA20_POLY1305_SHA256

- ECDHE-ECDSA-AES128-GCM-SHA256

- ECDHE-RSA-AES128-GCM-SHA256

- ECDHE-ECDSA-AES256-GCM-SHA384

- ECDHE-RSA-AES256-GCM-SHA384

- ECDHE-ECDSA-CHACHA20-POLY1305

- ECDHE-RSA-CHACHA20-POLY1305

- DHE-RSA-AES128-GCM-SHA256

- DHE-RSA-AES256-GCM-SHA384

minTLSVersion: VersionTLS12

modern

``

modern 是一个基于以下内容的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility

如下所示：

密码 ：

- TLS_AES_128_GCM_SHA256

- TLS_AES_256_GCM_SHA384

- TLS_CHACHA20_POLY1305_SHA256

minTLSVersion: VersionTLS13

old

``

旧是一个基于以下的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility

如下所示：

密码 ：

- TLS_AES_128_GCM_SHA256

- TLS_AES_256_GCM_SHA384

- TLS_CHACHA20_POLY1305_SHA256

- ECDHE-ECDSA-AES128-GCM-SHA256

- ECDHE-RSA-AES128-GCM-SHA256

- ECDHE-ECDSA-AES256-GCM-SHA384

- ECDHE-RSA-AES256-GCM-SHA384

- ECDHE-ECDSA-CHACHA20-POLY1305

- ECDHE-RSA-CHACHA20-POLY1305

- DHE-RSA-AES128-GCM-SHA256

- DHE-RSA-AES256-GCM-SHA384

- DHE-RSA-CHACHA20-POLY1305

- ECDHE-ECDSA-AES128-SHA256

- ECDHE-RSA-AES128-SHA256

- ECDHE-ECDSA-AES128-SHA

- ECDHE-RSA-AES128-SHA

- ECDHE-ECDSA-AES256-SHA384

- ECDHE-RSA-AES256-SHA384

- ECDHE-ECDSA-AES256-SHA

- ECDHE-RSA-AES256-SHA

- DHE-RSA-AES128-SHA256

- DHE-RSA-AES256-SHA256

- AES128-GCM-SHA256

- AES256-GCM-SHA384

- AES128-SHA256

- AES256-SHA256

- AES128-SHA

- AES256-SHA

- DES-CBC3-SHA

minTLSVersion: VersionTLS10

type

字符串

type 是 Old、Intermediate、Modern 或 Custom 之一。自定义提供指定各个 TLS 安全配置集参数的功能。旧、Intermediate 和 Modern 是基于以下内容的 TLS 安全配置集：

https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations

该配置集基于意图，因此当开发新密码时，它们可能会随时间变化，并且发现现有密码不安全。根据具体哪些密码可用于进程，可能会减少列表。

请注意，Modern 配置集目前还不被支持，因为它还没有被常见软件库正确采用。

feedbackDisabled

布尔值

transcriptsDisabled

布尔值

logLevel

string

日志级别。有效选项为 DEBUG、INFO、WARNING、ERROR 和 CRITICAL。默认："INFO"。