1.4. 使用 CLI 创建 Lightspeed 自定义资源文件


自定义资源(CR)文件包含 Operator 用来部署 OpenShift Lightspeed 的信息。CR 文件的特定内容对于每个大型语言模型(LLM)供应商是唯一的。要创建 CR 文件,请选择您要使用的 LLM 供应商的配置文件。

先决条件

  • 您可以访问 OpenShift CLI (oc),并以具有 cluster-admin 角色的用户身份登录。或者,您登录到有权创建集群范围的 CR 文件的用户帐户。
  • 您有一个可用于 OpenShift Lightspeed Service 的 LLM 供应商。
  • 已安装 OpenShift Lightspeed Operator。

流程

  1. 创建一个 OLSConfig 文件,其中包含您使用的 LLM 供应商的 YAML 内容。

    OpenAI CR 文件

    apiVersion: ols.openshift.io/v1alpha1
    kind: OLSConfig
    metadata:
      name: cluster
    spec:
      llm:
        providers:
          - name: myOpenai
            type: openai
            credentialsSecretRef:
              name: credentials
            url: https://api.openai.com/v1
            models:
              - name: <model_name>
      ols:
        defaultModel: <model_name>
        defaultProvider: myOpenai
    Copy to Clipboard Toggle word wrap

    Red Hat Enterprise Linux AI CR file

    apiVersion: ols.openshift.io/v1alpha1
    kind: OLSConfig
    metadata:
      name: cluster
    spec:
      llm:
        providers:
        - credentialsSecretRef:
            name: <rhelai_api_keys> 
    1
    
          models:
          - name: models/<model_name>
          name: rhelai
          type: rhelai_vllm
          url: <url> 
    2
    
      ols:
        defaultProvider: rhelai
        defaultModel: models/<model_name>
        additionalCAConfigMapRef:
          name: openshift-service-ca.crt
    Copy to Clipboard Toggle word wrap

    1
    默认情况下,Red Hat Enterprise Linux AI API 密钥需要一个令牌作为请求的一部分。如果您的 Red Hat Enterprise Linux AI 配置不需要令牌,您必须将令牌值设置为任何有效的字符串,以便请求进行身份验证。
    2
    URL 端点必须以 v1 结尾才能有效。例如: https://http://3.23.103.8:8000/v1

    Red Hat OpenShift AI CR file

    apiVersion: ols.openshift.io/v1alpha1
    kind: OLSConfig
    metadata:
      name: cluster
    spec:
      llm:
        providers:
        - credentialsSecretRef:
            name: <rhoai_api_keys> 
    1
    
          models:
          - name: <model_name>
          name: red_hat_openshift_ai
          type: rhoai_vllm
          url: <url> 
    2
    
      ols:
        defaultProvider: red_hat_openshift_ai
        defaultModel: <model_name>
    Copy to Clipboard Toggle word wrap

    1
    默认情况下,Red Hat OpenShift AI API 密钥需要一个令牌作为请求的一部分。如果您的 Red Hat OpenShift AI 配置不需要令牌,您必须将令牌值设置为任何有效的字符串,以便请求进行身份验证。
    2
    URL 端点必须以 v1 结尾才能有效。例如: https://<model_name>.<domain_name>.com:443/v1

    Microsoft Azure OpenAI CR 文件

    apiVersion: ols.openshift.io/v1alpha1
    kind: OLSConfig
    metadata:
      name: cluster
    spec:
      llm:
        providers:
          - credentialsSecretRef:
              name: credentials
            apiVersion: <api_version_for_azure_model>
            deploymentName: <azure_ai_deployment_name>
            models:
              - name: <model_name>
            name: myAzure
            type: azure_openai
            url: <azure_ai_deployment_url>
      ols:
        defaultModel: <model_name>
        defaultProvider: myAzure
    Copy to Clipboard Toggle word wrap

    IBM watsonx CR 文件

    apiVersion: ols.openshift.io/v1alpha1
    kind: OLSConfig
    metadata:
      name: cluster
    spec:
      llm:
        providers:
          - name: myWatsonx
            type: watsonx
            credentialsSecretRef:
              name: credentials
            url: <ibm_watsonx_deployment_name>
            projectID: <ibm_watsonx_project_id>
            models:
              - name: ibm/<model_name>
      ols:
        defaultModel: ibm/<model_name>
        defaultProvider: myWatsonx
    Copy to Clipboard Toggle word wrap

  2. 运行以下命令:

    $ oc create -f /path/to/config-cr.yaml
    Copy to Clipboard Toggle word wrap

    Operator 使用 YAML 配置文件中的信息部署 OpenShift Lightspeed。

1.4.1. 支持 trusted-ca 证书和 LLM 供应商

您可以使用 TLS 证书与大型语言模型(LLM)和 OpenShift Lightspeed 服务建立通信。通常,如果您使用自定义代理与 LLM 通信,则需要此项。

OpenShift Lightspeed 服务支持为以下 LLM 供应商添加 trusted-ca 证书:

  • Red Hat Enterprise Linux AI vLLM
  • Red Hat OpenShift AI vLLM
  • OpenAI
  • Microsoft Azure OpenAI

要添加 trusted-ca 证书,您必须创建一个包含证书的 ConfigMap 对象。然后,将对象名称添加到 OLSConfig 自定义资源(CR)文件中,如下例所示:

ols:
  additionalCAConfigMapRef:
    name: <config_map_name>
Copy to Clipboard Toggle word wrap

使用 trusted-ca 证书配置 OpenShift Lightspeed,以连接到大型语言模型(LLM)供应商。

注意

如果您正在使用的 LLM 供应商需要 trusted-ca 证书来验证 OpenShift Lightspeed 服务,则必须执行此步骤。如果 LLM 供应商不需要 trusted-ca 证书来验证服务,您应该跳过这个过程。

流程

  1. 复制证书文件的内容并将其粘贴到名为 caCertFileName 的文件中。
  2. 运行以下命令,创建名为 trusted-certsConfigMap 对象:

    $ oc create configmap trusted-certs --from-file=caCertFileName --namespace openshift-lightspeed
    Copy to Clipboard Toggle word wrap

    输出示例

    kind: ConfigMap
    apiVersion: v1
    metadata:
      name: trusted-certs
      namespace: openshift-lightspeed
    data:
      caCertFileName: | 
    1
    
        -----BEGIN CERTIFICATE-----
        .
        .
        .
        -----END CERTIFICATE-----
    Copy to Clipboard Toggle word wrap

    1
    指定连接到您的 LLM 供应商所需的 CA 证书。您可以包含一个或多个证书。
  3. 更新 OLSConfig 自定义资源文件,使其包含您刚才创建的 ConfigMap 对象的名称。

    Example Red Hat Enterprise Linux AI CR file

    apiVersion: ols.openshift.io/v1alpha1
    kind: OLSConfig
    metadata:
      name: cluster
    spec:
      ols:
        defaultProvider: rhelai
        defaultModel: models/<model_name>
        additionalCAConfigMapRef:
          name: trusted-certs 
    1
    Copy to Clipboard Toggle word wrap

    1
    指定 ConfigMap 对象的名称。
  4. 创建自定义 CR。

    $ oc apply -f <olfconfig_cr_filename>
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat